Slack Scopes

Atomist acts as a bot in your Slack team, and can take these actions:

  • Listen for messages and commands directed at the bot
  • Send notifications in channels that the bot has been invited to
  • Send notifications via direct message

When you authorize the Atomist Slack app, it requests the following permissions. For the bot to operate properly, all of these scopes must be granted.

Slack Scope How Atomist Uses It
bot Enables the bot to hear and respond to channel activity, such as bot commands and events.
identify Used to confirm your identity and test the authentication.
channels:read Allows the bot to list channels in the team.
channels:write Enables the bot to create channels and write messages to channels. For example, when you create a new project with Atomist, the bot can create a channel that will be associated with the project’s repository.
im:read Allows the bot to list its direct message channels. Sometimes Atomist communicates with users via direct message.
im:write Send direct messages to other users in the Slack team.
team:read Lets Atomist know basic information about the Slack team, like its ID, name, and domain.

For more information, see the Slack bot users documentation.