Install Round Robin and review its Slack scopes

To use Round Robin, a workspace admin (or a member allowed to install apps) adds it to your Slack workspace. During installation, Slack shows you the list of permission scopes the app requests. This page explains what each scope is used for, so you can review the request with confidence.

Round Robin uses granular bot permissions: every scope below is requested as a bot token scope, and the app requests only the scopes its features need. The installation never asks for user token scopes.

Install the app

1. Open the installation link. It redirects you to Slack’s authorization page.
2. Review the requested permissions and select Allow.
3. Slack completes the installation and you can start using the /rr command and the dashboard.

Note

On Slack Enterprise Grid, installation happens at the organization level. After you approve the scopes, Slack takes you to the organization admin page where you choose which workspaces to add Round Robin to.

Scope reference

Scope	Why Round Robin needs it
app_mentions:read	Detect when the bot is @-mentioned in a channel it belongs to, so it can respond and route mentions to the person on duty.
channels:read	List public channels when you create or manage a rotation, and check the type of channel the bot is interacting with.
channels:manage	Update the topic of a public channel with rotation information, and invite or remove members when a rotation keeps a channel’s membership in sync with who is on call.
chat:write	Post rotation messages in channels the bot was invited to.
chat:write.public	Post in public channels the bot is not a member of.
commands	Enable the /rr slash command and message shortcuts.
groups:read	List the private channels the bot is a member of when you manage a rotation, and check the channel type.
groups:write	Update the topic of a private channel the bot is a member of, and manage its membership when channel sync is enabled.
im:read / im:write	Open direct message conversations to send private notifications to individual users.
reactions:read / reactions:write	Support mention acknowledgment: when someone reacts to a message that mentions the on-duty group, Round Robin marks the mention as handled.
team:read	Read basic workspace information, such as the workspace name, when Round Robin is installed.
usergroups:read	List existing Slack user groups so you can link one to a rotation.
usergroups:write	Create the on-duty user group and update its members so it always reflects who is currently on call.
users:read	List workspace users when you create or edit a rotation.
users:read.email	Match Slack users to accounts in external integrations, such as PagerDuty schedules and Google Calendar out-of-office events, by email address.

When Round Robin asks for new scopes

When a new feature requires a scope your installation does not have yet, the dashboard shows an App Update Required alert. Select Reinstall App to run the Slack authorization flow again with the updated scope list; your rotations and settings are preserved.