Skip to content
Round RobinRound Robin

Install Round Robin

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.

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

Section titled “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.

Scope reference

Section titled “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

Section titled “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 kept.

Uninstall and reinstall

Section titled “Uninstall and reinstall”

Removing Round Robin from your Slack workspace disables every rotation in it. Everybody on duty goes off duty, and their turns end in each rotation’s History.

Round Robin has no access to Slack once it is removed, so nothing is announced. On-duty groups keep their members and channel topics keep their text: edit them in Slack if they should no longer name anybody.

Installing Round Robin again enables only the rotations the uninstall disabled. Each one starts as it does when you switch it back on: an automatic rotation puts the next person in order on duty, a manual one comes back with nobody on duty, and a linked one takes its people from the provider. A rotation you disabled yourself before the uninstall stays disabled. Enable it from its page when you want it back.

Next steps

Section titled “Next steps”