OAuth Permission Scopes

Last edited: Sep 18, 2020

Permission (OAuth) scopes are the permissions that AnonymityBot requires to function properly in Slack. You might find it useful to view Slack's guidance about understanding these permissions scopes.

commands

Add the /anon command and the Post Anonymously, Poll Anonymously and Open Menu shortcuts.

chat:write

Post anonymous messages, polls, replies and help messages.

channels:join

Automatically join public channels where you use AnonymityBot, without you needing to manually /invite @AnonymityBot.

app_mentions:read

Respond to direct mentions of the AnonymityBot app, to display help text about how to use the app.

team:read

Keep AnonymityBot up to date when a workspace domain or name changes, which helps prevent some bugs. Also used to display the workspace icon in the AnonymityBot dashboard.

channels:read, groups:read, usergroups:read

Keep an up-to-date state of channels, groups (invited only) and usergroups for our channel whitelisting feature (and soon usergroup whitlisting feature).

im:write

Deliver notifications to individual users. For instance, in the case of a problem with the creation of an anonymous message or poll.

im:history

View messages and mentions of AnonymityBot in user's direct message channel with AnonymityBot.

users:read, users:read.email

Count the number of users in a workspace (for our pricing model) and save a per user state (e.g. indication if an onboarding message has already been sent). We use email addresses to respond to feedback, to contact users and admins regarding the product and billing.