Slack

The Blameless platform offers integration with Slack that allows you to manage and orchestrate your incident resolution workflow natively in Slack.

Getting Started

  1. Go to the Blameless web application “Settings” page, scroll down and click on the “Messaging” option. Select the “Manage” button in the Slack container.
Slack Settings
  1. Enable Slack by moving the “Enable Slack” slider to the ON position within the Blameless web application and click on “Authorize Slack”.
Slack Credentials
  1. Select the workspace and channel that you want the Blameless bot to be installed into.
Slack Workspace
  1. Select “Allow” and click “Save”.
  2. Now, you can add the Blameless bot to any channel to enable the Blameless slash commands. The account does not need Slack administrator privileges to install the BlamlessBot; full member will work fine.

Best Practices

When using Blameless in production, the best practice is to authorize the Slack integration using a “Service Account”.

This is a Slack account that is not tied to a specific person and has a name that won't be confused as a person when it shows up in channels.

The Blameless bot will be owned and installed by this user. The Service Account user needs to be able to log in to the Blameless GUI, which means it needs to be able to receive e-mail. The account does not need Slack Admin privileges to install the BlamlessBot; full member will work fine.

note

Doing things this avoids certain problems with Slack integration:

  • A user who authorized the Slack integration leaving the workspace (causing the bot to fail)
  • A user who authorized the Slack integration showing up in incidents without actually being present

Bot Tokens

There are two types of tokens generated when the Blameless bot is granted authorization:

  • web/user token
  • bot token

Most Slack functionality can (and is) performed using the bot token. However, there is a small set of actions that require the user/web token. That token implies the action is performed by the user who authorized the Bot. An example of an action that requires the use of the web/user token is the create channel request: https://api.slack.com/methods/channels.create

Testing the Integration

Users should see a notification in the Slack workspace about the Blameless bot once it has been added:

Slack Test

You can test the integration via the assigned Slack channel using the “/” Blameless commands.

Enter the /blameless command in the Slack text input, and press “Enter”. A list of Incident options should appear, indicating the integration was successful.

Slack Slash Command