Slack



If you use Slack Enterprise Grid where you have multiple Slack workspaces, your installation instructions will differ slightly. Note, you will need to be a Slack Workspace Owner to complete the setup.

Our Rootly Slack app will ask you the folllowing permissions in order to work correctly:

app_mentions:read: View messages that directly mention @rootly in conversations that the app is in.

commands: Add /rootly and /incident Slack shortcuts.

channels:manage: So we can create a public dedicated Slack channel.

channels:read: View basic information about public channels in a workspace.

groups:read: View basic information about private channels that Rootly has been added to.

groups:write: So we can create a private Slack channel for sensitive data ( eg: security ).

chat:write + chat:write.public: So we can write a beautiful welcome message in your dedicated incident Slack channel and respond to different actions.

files:read: So when you pin or react to a message in Slack, we can also save the file assocciated in Rootly timeline.

files:write: So our genius workflows can upload some files (console output) directly in Slack. We will never delete files in your Slack workspace.

pins:read: So we can add Slack message to your incident timeline through pinning.

reactions:read: So we can add Slack message to your incident timeline through a reaction of your choice.

reactions:write: So we can react to your message when we successfully added it to your incident timeline.

users.profile:read: So we can turn your Slack internal username to something more human (Firstname + Lastname)

usergroups:read: View user groups in a workspace (Aliases so you can invite @security people directly for example).

users:read + users:read.email: View email addresses of people in a workspace so you can invite them with one click. We will never invite them in your behalf.

Supported commands that can be used anywhere in Slack:

• /incident - This will bring up the quick start menu in any channel for creating an incident and learning more about Rootly
• /incident declare | create | new <title> - This will create a new incident with a dedicated channel.
• /incident list- This will display a list of active incidents (10 max.)
• /incident help - Shows available commands for interacting with the Rootly inside of Slack

Supported commands that can only be used from an incident's Slack channel:

• /incident - This will bring up incident-specific commands such as updating summary, escalating, resolving the incident and more.
• /incident timeline <note> - This will create a new event and add it to the timeline event.
• /incident add action item - This will create a new action item and add it to your incident.
• /incident add task- This will create a new task and add it to your incident.
• /incident add team - This will attach a team to an incident.
• /incident add service - This will attach a service to an incident.
• /incident add functionality - This will attach functionality to an incident.
• /incident escalate - This will escalate the incident to Pagerduty / Opsgenie / VictorOps.
• /incident status - This will update the incident status.
• /incident publish - This will publish an incident and make it visible to your public status pages.
• /incident timestamps - This will allow you to modify incident timestamps as acknowlegded_at etc.
• /incident integrations - This will allow you to modify integrations url as zoom link.

If you need help or more information about this integration, please contact support@rootly.com or use the lower right chat widget to get connected with an engineer.

You can uninstall this integration in the integrations panel by clicking Configure > Delete