Slack bot token scopes
These scopes govern what the Conclude app can access in Slack.
| OAuth Scope | Description | Use Case |
|---|---|---|
| app_mentions:read | View messages that directly mention @Conclude in conversations | Allows users to interact with our app and ask it for help |
| bookmarks:read | List bookmarks | Conclude needs this permission to check whether a bookmark to the Conclude Dashboard exists before adding it |
| bookmarks:write | Create, edit and remove bookmarks | Conclude needs this permission to create bookmarks in activity channels, so information can be found more easily |
| channels:history | View messages and other content in public channels that Conclude has been added to | To deliver messages and other content to Microsoft Teams |
| channels:manage | Manage public channels that Conclude has been added to and create new ones | To create channels for users |
| channels:read | View basic information about public channels in a workspace | To track Slack membership and keep the membership of the larger channel up to date |
| chat:write | Send messages as @Conclude | Send messages as @Conclude to channels and chats |
| chat:write:customize | Send messages as @Conclude with a customized username and avatar | Allows Conclude to send messages on behalf of users that do not have a Slack account |
| chat:write:public | Send messages to channels that @Conclude is not a member of | Allows notifications to be sent to another channel |
| commands | Add shortcuts and/or slash commands that people can use | Users can create channels, invite new users, ask for help, and see all members of a synced channel |
| dnd:read | View Do Not Disturb (DnD) settings for people in a workspace | Avoids sending alerts to people with DnD set to true |
| files:read | View files shared in channels and conversations that Conclude has been added to | Post files across chat platforms |
| files:write | Upload, edit, and delete files as Conclude | Post files from users on other chat platforms that are members of the linked channel |
| groups:history | View messages and other content in private channels that Conclude has been added to | To deliver messages and other content from private Slack channels to private channels in Microsoft Teams |
| groups:read | View basic information about private channels that Conclude has been added to | To track Slack membership and help keep the membership of the larger linked channel updated |
| groups:write | Manage private channels that Conclude has been added to and create new ones | To post messages from other chat platforms into private Slack channels |
| im:history | View messages and other content in direct messages that Conclude has been added to | To interact with users via direct message |
| im:read | View basic information about direct messages that Conclude has been added to | To better understand the user when interacting with the app in a direct message |
| pins:read | View pinned content in channels and conversations that Conclude has been added to | We pin certain header messages in channels, so users can easily see that this is a linked channel/chat |
| pins:write | Add and remove pinned messages and files | We pin certain header messages in channels so users can easily see that this is a linked channel/chat |
| reactions:read | View emoji reactions and their associated content in channels and conversations that Conclude has been added to | To enable reactions from Slack to be seen by users on Microsoft Teams |
| reactions:write | Add and edit emoji reactions | To add and/or edit emojis that are used by users in other chat platforms that are members of the linked channel |
| team:read | View the name, email domain, and icon, for workspaces that Conclude is connected to | See a list of team members |
| usergroups:read | View user groups in a workspace | Enables groups to be added to a chat/channel |
| users.profile:read | View profile details about people in a workspace | Read names and avatars of people |
| users:read | View people in a workspace | To identify the user that has OAuthed the Conclude app |
| users:read.email | View email addresses of people in a workspace | To make users unique and avoid conflicts if a user has more than one universal email across multiple workspaces |
| users:write | Set presence for Conclude | Set the presence for Conclude, so the team knows Conclude is available |
Slack user token scopes
These scopes access user data on behalf of users that authorize them.
| OAuth Scope | Description | Use Case |
|---|---|---|
| channels:read | View basic information about public channels in a workspace | List of channels |
| channels:write | Manage a user’s public channels and create new ones on their behalf | Post messages to Slack channels that are sent from Microsoft Teams |
| chat:write | Send messages on a user’s behalf | Post direct messages to Slack when sent from Microsoft Teams |
| View a user’s email address | Email addresses are used to match users in linked channels | |
| groups:read | View basic information about a user’s private channels | To track Slack membership and help keep the membership of the larger linked channel up to date |
| groups:write | Manage a user’s private channels and create new ones on a their behalf | To post messages from other chat platforms into private Slack channels |
| openid | View information about a user’s identity | Used for signing into Conclude |
| profile | View a user’s Slack avatar and basic information in a Slack workspace | Receive basic info about a user when they sign into Conclude |
For any additional information, visit our Security page.