Microsoft Teams

Set up

Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher

2. Navigate to App Settings by clicking the gear icon (⚙️) at the top of the Timeline sidebar

3. Click on Integrations in the sidebar

Connect Microsoft Teams

Important! Before connecting a Teams integration, we recommend creating a user in your Microsoft Teams organization called "Runway" that will be used for authentication. This will ensure that messages sent by Runway are correctly attributed to the Runway user instead of the user that completed the installation.

• Find the Microsoft Teams integration module under the Notifications section

• Click the Connect button

• You’ll be taken through a standard Microsoft Teams OAuth flow

Runway will request the following permissions:

channelmessage.send - Send messages to channels

groupmember.read.all - Read who belongs to groups

channel.readbasic.all - List channels and their basic info

channel.create - Create new channels

team.readbasic.all - Read users' profiles

user.read.all - Delete channels

user.read - Read the signed-in user's profile

channel.delete.all - Delete channels

chat.create - Create new chats

chatmessage.send - Send messages in chats

teammember.read.all - Read who belongs to Teams

openid - Sign user in (authentication)

offline_access - Refresh tokens for ongoing access

profile - Read basic profile info during sign-in

teamworktag.read - Read tags

teamworktag.readwrite - Create and manage tags

group.readwrite.all - Full read/write access to all groups

• Teams redirects you back to Runway

• Select the Primary channel you want notifications to go to. You can select or enter multiple channels.

You can override default channel(s) for individual notifications by going to App settings > Notifications and clicking the ⚙️ icon for the notification you want to configure to send to a different channel.

Runway can send notifications to private channels, but only once the Runway user has been given access to the channel.