Slack

Installation



Installation - Slack Enterprise Grid

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.

Permissions

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.

Commands

Supported commands that can be used anywhere in Slack:

  • /rootly - This will bring up the quick start menu in any channel for creating an incident and learning more about Rootly
  • /rootly create | new <title> - This will create a new incident with a dedicated channel.
  • /rootly list - This will display a list of active incidents (10 max.)
  • /rootly 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:

  • /rootly - This will bring up incident-specific commands such as updating summary, escalating, resolving the incident and more.
  • /rootly add event <note> - This will create a new event and add it to the timeline event.
  • /rootly add action item - This will create a new action item and add it to your incident.
  • /rootly add task - This will create a new task and add it to your incident.
  • /rootly add team - This will attach a team to an incident.
  • /rootly add service - This will attach a service to an incident.
  • /rootly add functionality - This will attach functionality to an incident.
  • /rootly escalate - This will escalate the incident to Pagerduty / Opsgenie / VictorOps.
  • /rootly mitigate - This will mark an incident as mitigated.
  • /rootly resolve - This will mark an incident as resolved.
  • /rootly publish - This will publish an incident and make it visible to your public status pages.

Support

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

Uninstall

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