Scopes & Purposes

ScopeDescriptionPurpose
app_mentions:read
View messages that directly mention @allma in conversations that the app is in
Enable conversational interfaces & chat ops commands when users interact with Allma
channels:history
View messages and other content in public channels that Allma has been added to
Ingest of messages for incident channels
channels:join
Join public channels in a workspace
Joining of incident channels and channels which are configured to receive notifications
channels:manage
Manage public channels that Allma has been added to and create new ones
Creation of incident channels
channels:read
View basic information about public channels in a workspace
Allowing a selection of channels for receiving incident notifications
chat:write
Send messages as @allma
Posting messages to Slack
chat:write.customize
Send messages as @allma with a customized username and avatar
Posting messages to Slack
commands
Add shortcuts and/or slash commands that people can use
Enabling use of slash commands and shortcuts to interact with Allma
emoji:read
View custom emoji in a workspace
Reading custom emoji for processing when displaying incident timelines and transcripts in web app
files:read
View files shared in channels and conversations that Allma has been added to
Storing references to graphs or artifacts related to an incident posted in an incident channel
files:write
Upload, edit, and delete files as Allma
For posting rendered images of graphs for incident and alerting history
groups:history
View messages and other content in private channels that Allma has been added to
Ingest of messages for private incident channels
groups:read
View basic information about private channels that Allma has been added to
Allowing a selection of channels for receiving incident notifications
im:history
View messages and other content in direct messages that Allma has been added to
Allowing users to directly interact with the app via DM
im:read
View basic information about direct messages that Allma has been added to
Allowing users to directly interact with the app via DM
im:write
Start direct messages with people
Allowing users to directly interact with the app via DM, sending notifications to individuals on Slack
links:read
View allma.dev and allma.io URLs in messages
For capturing links to Allma web app pages and providing actions in app
links:write
Show previews of allma.dev and allma.io URLs in messages
For capturing links to Allma web app pages and providing actions in app
pins:read
View pinned content in channels and conversations that Allma has been added to
For storing what messages are pinned in incident channels to expose via the web app and timeline editor
reactions:read
View emoji reactions and their associated content in channels and conversations that Allma has been added to
Ingest of reactions for incident channels and timeline entry building
reactions:write
Add and edit emoji reactions
For using emoji reactions as a way to confirm the app added a message to the incident timeline
team:read
View the name, email domain, and icon for workspaces Allma is connected to
For displaying workspace information when logged in via Allma web app
users.profile:read
View profile details about people in a workspace
For collecting avatars and names to display when referencing users in the Allma app
users:read
View people in a workspace
For collecting avatars and names to display when referencing users in the Allma app
users:read.email
View email addresses of people in a workspace
For communicating to users with transactional communications they opted into related to incidents occurring in the workspace
users:write
Set presence for Allma
For allowing the bot to set their presence when active incidents are occurring in the workspace