Skip to main content
Back to integrations

Slack channels

Turn alert messages in Slack channels into incidents and reply in the thread

Overview

A Slack channel with listening turned on lets Akmatori read alert messages that other bots and integrations post there. An LLM extracts the alert fields from each top-level message and classifies it. A message classified as an alert opens or joins an incident, and Akmatori posts the investigation result as a reply in the message thread.

Setup steps

1

Add the Slack connector

Open Connectors → Discover → Slack and enter the Bot Token, Signing Secret and App Token of your Slack app. See the Slack setup guide for how to create the app.

2

Find the channel ID

In Slack, right-click the channel name and select "View channel details". The channel ID is at the bottom of the About tab (for example, C01234ABCDE). Akmatori matches listening channels by ID, not by name.

3

Create a channel

On the Slack connector's Channels tab, choose New channel and enter the channel ID. Turn on Can listen for alert intake. Keep Can post on if Akmatori should reply in the thread; with Can post off, the channel is a silent listener and results appear only in the Akmatori UI. "Process bot messages as alerts" is on by default; turn on "Process human messages as alerts" if people post alerts there by hand.

4

Invite the bot

Invite the bot to the channel with /invite @YourBotName. Slack sends Akmatori only the messages of channels that the bot is a member of.

Example payload

An example of the payload that Akmatori accepts from Slack channels:

json
{
  "type": "message",
  "channel": "C01234ABCDE",
  "user": "U98765FGHIJ",
  "text": "Alert: High CPU on production-server-01",
  "ts": "1234567890.123456",
  "bot_id": "B11111AAAAA"
}
In a listening channel, Akmatori treats top-level bot messages as alerts (and human messages too, if you turn that on). In threads it answers only when you @mention the bot; other thread replies that read as feedback are saved to Memory and get a thumbs-up reaction. Edited messages (message_changed) are skipped.