Bot Token Scopes

These scopes govern what our Mio Universal Channels app can access.

OAuth Scope

Description

Use Case

app_mentions:read

View messages that directly mention @mio in conversations that the app is in

Allows users to interact with our app and ask it for help

channels:history

View messages and other content in public channels that Mio Universal Channels has been added to

To deliver messages and other content to other chat platforms like Microsoft Team and Webex Teams

channels:manage

Manage public channels that Mio Universal Channels has been added to and create new ones

To create Universal Channels for users

channels:read

View basic information about public channels in a workspace

To track Slack membership to help keep the membership of the larger Universal Channel up to date

commands

Add shortcuts and/or slash commands that people can use

So users can create channels, invite new users, ask for help and see full membership of a Universal Channel.

files:read

View files shared in channels and conversations that Mio Universal Channels has been added to

To post files across chat platforms.

files:write

Upload, edit, and delete files as Mio Universal Channels

To post files from users on other chat platforms that are members of the Universal Channel

groups:history

View messages and other content in private channels that Mio Universal Channels has been added to

To deliver messages and other content from private channels to private channels in chat platforms like Microsoft Team and Webex Teams

groups:read

View basic information about private channels that Mio Universal Channels has been added to

To track Slack membership to help keep the membership of the larger Universal Channel up to date

groups:write

Manage private channels that Mio Universal Channels has been added to and create new ones

To post messages from other chat platforms into Slack private channels

im:history

View messages and other content in direct messages that Mio Universal Channels has been added to

To interact with users via Direct Message

im:read

View basic information about direct messages that Mio Universal Channels has been added to

To better understand the user when interacting with the app in a Direct Message

im:write

Start direct messages with people

To send messages to the user when interacting with the app in a Direct Message

reactions:read

View emoji reactions and their associated content in channels and conversations that Mio Universal Channels has been added to

To pass those reactions from Slack to users on other platforms in the Universal Channel

reactions:write

Add and edit emoji reactions

To add and/or edit emojis that are passed from users in other chat platforms that are members of the Universal Channel

users:read

View people in a workspace

To identify the user that has OAuthed our 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 Channel across multiple workspaces

User Token Scopes

These scopes access user data on behalf of users that authorize them.

OAuth Scope

Description

Use Case

users:read

View people in a workspace

To keep Universal Channels membership up to date in the absence of the bot token

If you have any other questions regarding security for Mio Universal Channels, please reach out to our team.

Did this answer your question?