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.