·¬ÇÑÉçÇø

Configuring Microsoft Teams


This topic explains how to configure Microsoft Teams on both in Microsoft and then in Brightspot.

Creating bot resources in Azure:

  1. .
    • The redirect URL should be https://<your-brightspot-cms-domain>/cms/microsoft/auth (for example, https://cms.brightspot.example.com/cms/microsoft/auth). Ensure that the URL is not protected by basic authentication.
    • For credentials, create a client secret and save it.
    • Copy and save the application's Client ID, Tenant ID, and Client Secret values, as you will need these values to create a Microsoft app in Brightspot.
  2. or .
    • If you created an app in the previous step, select Use existing app registration and enter your existing Client ID and Client Secret from the previous step.
    • If you did not create an app in the previous step, copy and save the application's Client ID, Tenant ID, and Client Secret, as you will need these values to create a Microsoft app in Brightspot.
  3. Navigate to the Configuration page and provide the following messaging endpoint: https://<your-brightspot-cms-domain>/microsoft/teams/api/messages (for example, https://www.cms.brightspot.example.com/microsoft/teams/api/messages). Ensure that the endpoint is not protected by basic authentication.
  4. . Once connected, copy and save the address of the Open in Teams link under the Action column.

Configuring the app in Brightspot:

  1. Log in to Brightspot.
  2. Click menu > Admin > Sites & Settings > Sites > Global.
  3. Click search, located to the left of more_horiz, and type Microsoft Teams.
  4. Under Account for App Installation, click the button to be redirected to Microsoft to authenticate. You redirect back to Brightspot after authentication, and you are prompted to save your settings to activate the admin account.
    Note
    Only Microsoft admins are able to authenticate this Microsoft account. If a user other than an admin attempts to authenticate, the attempt fails.

    Once a Microsoft admin authenticates with Microsoft, Brightspot associates the admin's account with the Brightspot user account. The Account for App Installation field in Brightspot then converts to a read-only field.
  5. Under App for Team Bot, click search to search for an existing Microsoft app. If you have not yet created a Microsoft app in Brightspot, see Adding a Microsoft App.
  6. Under Teams Bot URL, select a bot by pasting the address of the Open in Teams link that you copied in Step 4 of this topic.
  7. Toggle on Allow App Selection for Notification to allow editors to choose an app for notification in their profile. Enable this toggle in multi-tenant environments.
  8. Click Save.
Note
For additional information about configuring how end-users consent to applications in the Azure dashboard, or about configuring Brightspot Teams App in Microsoft and Azure dashboard, read below.


Configuring how end-users consent to applications in Azure dashboard:

End users may not be able to grant permissions to the Brightspot app depending on the user consent settings in Azure. If users are required to submit an approval request to an admin when they sign in with Microsoft via Brightspot, you can . If you decide to allow users to consent for permission classified as low impact, add the following permissions: Channel.ReadBasic.All, Team.ReadBasic.All, offline_access, openid, profile, User.Read.

Uploading Brightspot Teams app to an organization's app store:

  1. Modify manifest.json by replacing [DOMAIN], [BOT_APP_ID], [PATH_TO_PRIVACY_POLICY_URL], [PATH_TO_TOU_URL] with proper values. For more information, see the manifest.json . For more information, you can check the .
  2. Zip the files in the app directory (manifest.json, bsp-teams-icon-color.png, and bsp-teams-icon-outline.png) and . You can also .
Note
Once the Microsoft Teams integration is configured, you can configure notifications. For details, see Configuring notifications with Microsoft Teams.

Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

•
•
•
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

• Content types
• Modules
• Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

• Dashboards
• Publishing
• Workflows
• Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

• Field types
• Content modeling
• Rich-text elements
• Images
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

• Google Analytics
• Shopify
• Apple News