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 ).
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).
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 firstname.lastname@example.org 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