> ## Documentation Index
> Fetch the complete documentation index at: https://docs.endgame.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

> Connect Microsoft Teams to sync account channel data to Endgame

Use the instructions below to enable the Microsoft Teams integration in Endgame. Once enabled, Endgame will ingest your Teams messages from specific channels and associate them with specific Accounts making them available in Endgame chat responses.

## Enable the integration

<Note>
  Connecting to the Microsoft Teams API requires that the connecting user is a
  Teams Global Administrator.
</Note>

<Steps>
  <Step title="Navigate to Configuration">
    Navigate to the [integrations page](https://app.endgame.io/settings/integrations). Only Endgame Admins can configure organization integrations.
  </Step>

  <Step title="Start Setup">
    From the integrations page, click "Connect" to kick off the Teams authentication process.

    <Frame caption="Microsoft Teams connection">
      <img src="https://mintcdn.com/endgame-e965a12c/Iomnrr63U2gvbuYU/images/microsoft-teams-integration-03-09-26.png?fit=max&auto=format&n=Iomnrr63U2gvbuYU&q=85&s=d4037ae20ba2ee5e68c0cb730404771c" alt="Microsoft Teams connection" className="rounded-lg" width="1492" height="200" data-path="images/microsoft-teams-integration-03-09-26.png" />
    </Frame>
  </Step>

  <Step title="Select Account">
    Select the account you wish to connect to Endgame and go through the authentication flow and ensure you check the box for "Consent on behalf of your organization" to give Endgame access to the necessary scopes.

    <Frame caption="Microsoft account selection">
      <img src="https://mintcdn.com/endgame-e965a12c/mFJAq0KPpn-UquDi/images/pick-microsoft-account-03-10-26.png?fit=max&auto=format&n=mFJAq0KPpn-UquDi&q=85&s=af35f049bcb1768f404f14e65f1a6b02" alt="Microsoft account selection" className="rounded-lg" width="1048" height="814" data-path="images/pick-microsoft-account-03-10-26.png" />
    </Frame>

    <Frame caption="Microsoft grant permission">
      <img src="https://mintcdn.com/endgame-e965a12c/mFJAq0KPpn-UquDi/images/grant-endgame-permission-microsoft-03-18-26.png?fit=max&auto=format&n=mFJAq0KPpn-UquDi&q=85&s=503857454057229cf5136f507fc2ffe1" alt="Microsoft grant permission" className="rounded-lg" width="1034" height="1344" data-path="images/grant-endgame-permission-microsoft-03-18-26.png" />
    </Frame>
  </Step>

  <Step title="Configure Channel Mapping">
    Once connected, click to Manage your configuration. You can now designate which public Teams channel content will be associated with specific Endgame Accounts.

    First, you select the channel for which you wish to make an association.

    <Frame caption="Select Channel">
      <img src="https://mintcdn.com/endgame-e965a12c/Iomnrr63U2gvbuYU/images/teams-add-channel-03-09-26.png?fit=max&auto=format&n=Iomnrr63U2gvbuYU&q=85&s=bbdeeb05bc65dc3cb79fbd1d7b8b9c6b" alt="Select Channel" className="rounded-lg" width="980" height="452" data-path="images/teams-add-channel-03-09-26.png" />
    </Frame>

    Second, choose which account to association with that channel and click Add. Channel data is synced to Endgame every 15 minutes.

    <Frame caption="Select Account">
      <img src="https://mintcdn.com/endgame-e965a12c/Iomnrr63U2gvbuYU/images/teams-add-account-03-09-26.png?fit=max&auto=format&n=Iomnrr63U2gvbuYU&q=85&s=d616ec480bdca8d4f3a386b76d162fa9" alt="Select Account" className="rounded-lg" width="1064" height="474" data-path="images/teams-add-account-03-09-26.png" />
    </Frame>

    You will see your association show up in the Account-specific Channels list below. You can remove these associations anytime by clicking the trash icon.

    <Frame caption="Account specific channel list">
      <img src="https://mintcdn.com/endgame-e965a12c/bSFwefk4NWv4psaF/images/account-specific-channels-list-03-09-26.png?fit=max&auto=format&n=bSFwefk4NWv4psaF&q=85&s=29931008c60435077ce91bef1370e9c9" alt="Account specific channel list" className="rounded-lg" width="1768" height="490" data-path="images/account-specific-channels-list-03-09-26.png" />
    </Frame>
  </Step>

  <Step title="Updating your connection">
    Users can update or disconnect their Teams connection at anytime. Disconnecting will remove all your existing channel to account mappings.

    To update your connection with a new user hover over the Connect button in the top right corner and when it shows Reconnect, click it to trigger the authentication process. To disconnect, click the Disconnect button in the lower left hand corner.

    <Frame caption="Microsoft Teams integration view">
      <img src="https://mintcdn.com/endgame-e965a12c/Iomnrr63U2gvbuYU/images/microsoft-teams-integration-view-03-09-26.png?fit=max&auto=format&n=Iomnrr63U2gvbuYU&q=85&s=5b5f8ba06df2bc6eb88c4b2101c7b3c4" alt="Microsoft Teams integration view" className="rounded-lg" width="2778" height="1490" data-path="images/microsoft-teams-integration-view-03-09-26.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Endgame currently cannot distinguish between different account conversations in a single Teams channel. Instead, use Teams channels that are dedicated to singular account conversations to enhance your Endgame data.

  We will *only* ingest channels that you have selected and associated with an Account in the Teams integration configuration. Other than the names of public channels, no other data is ingested without your permission.
</Note>

## What's next?

That's it! Now that you've connected Teams to Endgame, we'll automatically ingest your data into our systems every 15 minutes and present our insights in Endgame.

## Need help or have feedback?

We'd love to hear from you! You can reach us at [support@endgame.io](mailto:support@endgame.io).
