| Scope | Description | Purpose |
|---|---|---|
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 |