How do I install the Microsoft Teams Integration?

Last updated: April 7, 2026

Make sure you have at least one seat of Microsoft Essentials ($4/mo) or higher before continuing.

The user that connects the integration will need the Teams Administrator role assigned to their user in the Microsoft 365 Admin center in order to authorize the connection.

Setup permissions in Teams

  1. Go to the Microsoft Admin Portal and login

    1. If you are unable to view this page, it means you are not an Admin. Ask your Admin to temporarily upgrade your permissions in order for you to complete this flow.

  2. On the sidebar, click "Show All" and scroll to the bottom and click "Teams"

  3. From inside the Teams Admin Portal, click "Teams Apps" in the left sidebar

  4. Click on "Setup Policies"

  5. Select "Global (Org-wide default)", which is typically the first policy in the table.

    CleanShot 2024-07-05 at 11.52.56.png

  6. Toggle on the "Upload custom apps" toggle and hit Save at the bottom of the page

Authenticate from Pylon

  1. Login to Pylon and click on "Apps Directory" and hit Connect on Microsoft Teams.

  2. Log in to a Microsoft Teams account with administrator privileges for your desired Teams tenant.

  3. Authorize the Pylon Teams application to use the necessary scopes.

Important Limitations

Note: The Pylon Teams app can only be added to teams and channels that originate from your own Microsoft Teams tenant. If you were invited to join a team from a customer's tenant, you will not be able to add the Pylon app from your side. You must be an owner of the team and the team must originate from your tenant to successfully install and configure the Pylon integration.

Troubleshooting

Messages from Pylon not appearing in Teams

If messages sent from Pylon are not appearing in your Teams channels or chats, you may encounter a "BotNotInConversationRoster" error. This typically happens when the Pylon bot loses proper permissions in the Teams conversation.

To resolve this issue:

  1. Have the same user who originally set up the Teams integration log into Pylon

  2. Go to "Apps Directory" and click on the Microsoft Teams tile

  3. Click "Reauthorize" or "Connect" to refresh the integration permissions

  4. Test sending a message from Pylon to confirm the issue is resolved

Note: The reauthorization must be done by the original user who set up the integration, as they have the necessary administrator privileges for your Teams tenant.

Now that the app is installed, you can move on to Setting up a Teams Channel (for channels) or How do I setup Pylon with Microsoft Teams chats (for group chats).

Once the app is installed and you've confirmed you have the necessary permissions for your teams/channels, you can move on to Setting up a Teams Channel (for channels) or How do I setup Pylon with Microsoft Teams chats (for group chats).