Connect to Microsoft Teams

Required permissions for setup

  • The user setting up this data source must be the Global Admin.

Register and configure an app to crawl messages

  1. Sign into the Azure portal. Select Azure Active Directory, then App registrations > New registration.
  2. On the Register an application page, register an app with the following: | Field | Value | |---|---| | Name | Glean MSFT Teams App (for messages) | | Supported account types | Accounts in this organizational directory only (Single tenant) | | Redirect URI | (Leave this field blank) |
  3. Click Register.
  4. On the left side navigation on the overview page, click on Manage > API Permissions.
  5. Click Add a permission and select Microsoft Graph. Choose Application permissions and add the following:
  • User.Read.All
  • GroupMember.Read.All
  • Team.ReadBasic.All
  • TeamMember.Read.All
  • TeamSettings.Read.All
  • TeamsTab.Read.All
  • Channel.ReadBasic.All
  • ChannelMember.Read.All
  • ChannelMessage.Read.All
  • ChannelSettings.Read.All
  • Chat.Read.All
  • Chat.ReadBasic.All
  1. After all permissions are added, click Grant admin consent for tenant. Ensure that you are signed into Azure as a Global, Application, or Cloud Application Administrator, otherwise the grant may fail.
  2. Navigate back to Home > App registrations and click on the app you created earlier. Then click on Manage > Certificates & secrets in the left sidebar.
  3. Click on New client secret. Enter a description and select 24 months for expiry time, then click Add.
  4. Under Client secrets, copy the Value (not the Secret ID) you generated and enter it in Glean as the Client secret. The Value will only be shown once. Enter the client secret into Glean.
  5. Scroll to the top of the left sidebar and click Overview.
  6. Copy the following content from the center Essentials panel and enter it in Glean:
  • Application (client) ID
  • Directory (tenant) ID