Quick Start Guide
Slack integration
Configuring the Slack integration only takes a few minutes and provides incident management features you can use right from the Slack interface.
Before you get started
You should know which Slack plan you’re subscribed to. If you’re unsure which plan you’re on, click the organization name in the top left corner of Slack. The plan will be under the organization’s name. If you’re on the Slack Free, Business, or Pro plan, you can integrate the workspace with Rootly. Slack Enterprise Grid users can add Rootly at the organizational level, allowing Rootly to be installed in multiple workspaces. Leverage Slack’s Multi Workspace Channels to connect response teams from different workspaces in your Organization.Data Permissions
Data Permissions
app_mentions:read: View messages that directly mention @rootly in conversations that the app is in.
commands: Add /rootly and /incident slash commands.
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 associated 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: Add /rootly and /incident slash commands.
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 associated 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
Integrate with Slack Free, Pro, or Business plan
Rootly Account Requirement: Must be an Admin or OwnerSlack Account Requirement: Must be a workspace Admin or Owner
1
Go to Configuration. Click Connect Slack in the top-right corner.
Alternatively, go to Configuration > Integrations and select Setup under the Slack logo.
Alternatively, go to Configuration > Integrations and select Setup under the Slack logo.2
Select Other Slack Plans.
3
Choose the Slack workspace to integrate with from the top-right corner. Review the requested permissions and click Allow to continue.
Integrate with Slack Enterprise Grid plan
Rootly Account Requirement: Must be an Admin or OwnerSlack Account Requirement: Must be an Organization Admin or Organization OwnerYou must be logged into both accounts to complete the setup.
1
Go to Configuration. Click Connect Slack in the top-right corner. Alternatively, go to Configuration > Integrations and select Setup under the Slack logo.
2
Select Slack Enterprise Grid.
3
Choose the Slack organization to integrate with from the top-right corner. Review the requested permissions and click Allow to continue.
4
In the top-left corner, click the organization name.Hover over Tools & settings, then click Organization settings.From the left sidebar, go to Integrations > Installed apps and find the Rootly app.
5
Select the three-dot icon on the right and select Add to more workspaces.
6
Select which workspaces to add the Rootly app to. Then, check the box “Default for future workspaces” to automatically add the app to any new workspaces in your organization.
Click Next.
Click Next.7
Check the box next to “I’m ready to add this app” then click Add App.
Workspace Setup
After connecting Slack, go to Configuration > Slack to set smart defaults and manage alerts.- Set a channel for incident creation
- Team notifications: Set the default announcement channel and alert specific groups for high-severity incidents
- Smart Reminders: Have the Rootly app remind users to add roles, update the status page, and keep on task.
- Updates: Keep your team updated throughout the incident.
- Incident Slack Channels: Set channel naming conventions, add bookmarks to the webapp, and auto-update incident TPOCs
- Interactions: Use Emojis to pin messages, add follow actions, and add tasks.
- Archive channels: Incident channels can be archived up to a month after resolution.
- Members: Require members to connect to Slack or track incident access.