Microsoft Teams
7min
Microsoft Teams Integration allows you to:
- Create a Microsoft Teams channel associated to an incident.
- Create a Microsoft Teams tab linked to the incident in the associated Microsoft Teams channel.
You can setup this integration as a logged in admin user in the integrations page.
We recommend you integrating with a service account to make sure the integration doesn't break if a user leaves your company.
Your selected workspace needs the following oauth permissions:
- offline_access
- This permission is needed for to perform OAuth authentication.
- User.Read
- Allows Rootly to have user information about who integrated the account. This permission is needed for our OAuth strategy.
- Team.ReadBasic.All
- Read the names and descriptions of teams, on behalf of the signed-in user.
- ChatMessage.Send
- Allows an app to send channel messages in Microsoft Teams, on behalf of the signed-in user.
- Channel.Create
- Create channels in any team, on behalf of the signed-in user.
- Channel.ReadBasic.All
- Read channel names and channel descriptions, on behalf of the signed-in user.
- ChannelMessage.Send
- Allows an app to send channel messages in Microsoft Teams, on behalf of the signed-in user.
- ChannelMessage.ReadWrite
- Allows the app to read and write channel messages, on behalf of the signed-in user.
- ChannelSettings.ReadWrite.All
- Add and remove members from channels, on behalf of the signed-in user.
- ChannelMember.ReadWrite.All
- Read and write the names, descriptions, and settings of all channels, on behalf of the signed-in user.
- TeamsTab.ReadWriteSelfForChat
- Allows a Teams app to read, install, upgrade, and uninstall its own tabs in chats the signed-in user can access.
- TeamsTab.ReadWriteSelfForTeam
- Allows a Teams app to read, install, upgrade, and uninstall its own tabs to teams the signed-in user can access.
- TeamsAppInstallation.ReadWriteSelfForTeam
- Allows a Teams app to read, install, upgrade, and uninstall itself to teams the signed-in user can access.
- After authorizing the integration on Rootly, switch to Microsoft Teams. On the left-hand side, go to "+ Apps" search for Rootly in the store and click "Add".
- On this screen. click the dropdown next to "Add" and choose a primary channel for the Team you'd like to install the bot
- Click the dropdown next to "Add" and choose "Add to a team." Select a team and a primary channel (we recommend the General channel) to install both the bot and the Rootly tab. Then, click "Set Up." Note: You will need to install the bot for each team that requires access to the Rootly tab for tasks such as creating and managing incidents.
- After clicking "Set Up," a confirmation modal will appear, guiding you to press "Save" to finalize the app installation. Optionally, you can also post a message to the channel announcing the new Rootly tab.
- Login to your Microsoft Teams account.
- Click Manage > Installed Apps or search for the Rootly App.
- Click the Rootly app.
- Click Uninstall.
If you need help or more information about this integration, please contact [email protected] or use the lower right chat widget to get connected with an engineer.
Updated 02 Oct 2024
Did this page help you?