Settings & administration

  1. In your Slack app, select your workspace name in the top left corner. Under Settings & administration, select Workspace settings from the drop-down list.
  2. Go to the Permissions tab at the top.
  3. Scroll down to Channel Management and choose Expand.
  4. For People who can create private channels, change the setting to Everyone, plus Multi-Channel Guests.
  5. For People who can create public channels, change the setting to Everyone, except guests.
  6. Save your settings.

Installing the Mio app

  1. Go to https://app.m.io.
  2. Select “Slack” install the Mio app on your Slack workspace.
  3. Log in with your Slack account.
  4. Once you see the “Success!” page, open your Slack app to find the welcome message from the Mio app.

You can now create a universal channel to start chatting with external companies.


Bot Token Scopes

These scopes govern what our Mio 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 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 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 has been added to

To post files across chat platforms.

files:write

Upload, edit, and delete files as Mio

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 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 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 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 has been added to

To interact with users via Direct Message

im:read

View basic information about direct messages that Mio 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 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 channel membership up to date in the absence of the bot token

If you have any other questions regarding security for Mio, please reach out to our team at support@m.io.

Did this answer your question?