Connect Slack
Dexter posts investigations, status updates, and resolved root cause analyses into Slack, and people can open an incident from a Slack thread.
Dexter needs its own Slack app in your workspace. Create it one of two ways:
-
Automatically, from a manifest Dexter fills in. This creates a new app every time you run it.
-
Manually, by entering an existing app’s credentials. Use this to reuse an app you already have, or when you cannot create a configuration token.
Create the app automatically
Dexter creates the app from a manifest with the name, scopes, redirect URL, and Create incident message shortcut already set.
-
Go to api.slack.com/apps. Under Your App Configuration Tokens, click Generate Token, and pick your workspace.
-
Copy the Access Token. It starts with
xoxe.xoxp-and expires after 12 hours; Dexter needs it only for this one call.Slack shows the token only through its Copy button.
-
In Dexter, open Admin > Integrations, expand Slack under Incident channels, and click Set up Slack app.
-
On the Create automatically tab, paste the token as the Configuration token, and click Create app.
Dexter stores the app’s credentials, including its signing secret, server-side. Once the app is installed, revoke the configuration token on the same Slack page.
Enter an app manually
-
At api.slack.com/apps, create the app: Create New App > From scratch, named
Dexter, in your workspace. To reuse an existing app, open it instead. -
Under OAuth & Permissions, add the Redirect URL
https://<HOST>/slack/oauth/callback. -
Under Bot Token Scopes, add:
chat:write,channels:manage,channels:join,channels:read,channels:history,groups:history,users:read,users:read.email,commands,app_mentions:read,files:write -
Optional, to open incidents from a Slack thread: under Interactivity & Shortcuts, turn interactivity on and set the Request URL to
https://<HOST>/slack/interactivity. Then click Create New Shortcut > On messages, with the nameCreate incidentand the callback IDcreate_incident. -
Under Basic Information > App Credentials, copy the Client ID, Client Secret, and Signing Secret.
-
In Dexter, open Admin > Integrations, expand Slack, click Set up Slack app, and open the Enter manually tab. Paste the three values and save.
If you reuse an app and change its scopes, Slack asks you to reinstall it. Installing it from Dexter in the next step does that.
Install the app and choose Slack
-
On the Slack card, click Add to Slack, and approve the install in your workspace. The card reads Connected.
-
Under Incident channels, select Slack. Dexter posts to one destination at a time.
-
Invite the bot to each channel it should post in.
To create an incident from a Slack thread, hover a message, click More actions, and choose Create incident. Dexter opens an incident with the thread as context and replies in the thread with its link.