Bot Token Scopes & Event Subscriptions

Bot Token Scopes

Scopes that govern what your app can access. This is a list of the CHAOSS Slack bot enabled scopes. A comprehensive list of permission scopes is available at api.slack.com/scopes.

OAuth Scope	Description
app_mentions:read	View messages that directly mention @welcometochaoss in conversations that the app is in
channels:history	View messages and other content in public channels that welcome-to-CHAOSS has been added to
channels:join	Join public channels in a workspace
channels:read	View basic information about public channels in a workspace
chat:write	Send messages as @welcometochaoss
chat:write.customize	Send messages as @welcometochaoss with a customised username and avatar
chat:write.public	Send messages to channels @welcometochaoss isn't a member of
groups:history	View messages and other content in private channels that welcome-to-CHAOSS has been added to
groups:read	View basic information about private channels that welcome-to-CHAOSS has been added to
im:history	View messages and other content in direct messages that welcome-to-CHAOSS has been added to
im:read	View basic information about direct messages that welcome-to-CHAOSS has been added to
im:write	Start direct messages with people
incoming-webhook	Post messages to specific channels in Slack
mpim:history	View messages and other content in group direct messages that welcome-to-CHAOSS has been added to
mpim:write	Start group direct messages with people
users:read	View people in a workspace
users:write	Set presence for welcome-to-CHAOSS

Event Subscriptions

These are the subscribed bot events. The other available events are documented at api.slack.com/events.

Event Name	Description	Required Scope
member_joined_channel	A user joined a public or private channel	channels:read or groups:read
message.channels	A message was posted to a channel	channels:history
message.groups	A message was posted to a private channel	groups:history
message.im	A message was posted in a direct message channel	im:history
message.mpim	A message was posted in a multiparty direct message channel	mpim:history
team_join	A new member has joined	users:read