Integrations

Slack Integration

Connect Akmatori to Slack to receive real-time incident notifications and AI-powered investigation results.

Quick Setup

Use our pre-configured app template to set up the Slack integration in under 2 minutes.

Create Slack App

Click the button below to create a pre-configured Akmatori app in your Slack workspace:

Create Akmatori App in Slack

This opens Slack's app creation page with all settings pre-configured.

Install to Workspace

After the app is created, click Install to Workspace and authorize the permissions.

Copy Tokens to Akmatori

In your new Slack app, collect these three values:

Bot TokenOAuth & Permissions → Bot User OAuth Tokenxoxb-...

App TokenBasic Information → App-Level Tokens → Generate Token and Scopesxapp-...

When generating the App Token, enter any name (e.g. akmatori) and add the connections:write scope. This is the only scope needed for Socket Mode.

Signing SecretBasic Information → App Credentialsabc123...

Enter these in the Akmatori dashboard at Settings → Slack.

Invite Bot to Channel

In Slack, invite the bot to your alerts channel:

text

/invite @Akmatori

Add App Icon (Optional)

Make your Akmatori bot recognizable by adding the official logo:

Download the logo using the button below
In your Slack app settings, go to Basic Information
Scroll to Display Information
Click the app icon area and upload the logo

Download Akmatori Logo

Required Permissions

The app template pre-configures all required permissions. Here's what Akmatori needs and why:

Actions Akmatori can take

app_mentions:readView messages that directly mention @Akmatori in conversations

channels:joinJoin public channels in a workspace

chat:writeSend messages as @Akmatori

chat:write.publicSend messages to channels @Akmatori isn't a member of

incoming-webhookPost messages to specific channels in Slack

reactions:writeAdd and edit emoji reactions

commandsAdd shortcuts and/or slash commands that people can use

Information Akmatori can view

channels:historyView messages and content in public channels that Akmatori has been added to

groups:historyView messages and content in private channels that Akmatori has been added to

im:historyView messages in direct messages that Akmatori has been added to

channels:readView basic information about public channels in a workspace

groups:readView basic information about private channels that Akmatori has been added to

files:readView files shared in channels and conversations that Akmatori has been added to

metadata.message:readRead message metadata in channels that Akmatori has been added to

reactions:readView emoji reactions and their associated content

team:readView the name, email domain, and icon for workspaces Akmatori is connected to

users.profile:readView profile details about people in a workspace

users:readView people in a workspace

users:read.emailView email addresses of people in a workspace

Akmatori uses Socket Mode for secure WebSocket connections. No public URL or firewall configuration is required.

Troubleshooting

Bot doesn't respond

Verify Socket Mode is enabled and the App Token is correct. Make sure the bot is invited to the channel.

Messages not appearing

Check that the Bot Token has chat:write scope and the channel name includes the # symbol.

Missing App Token

Go to Basic Information → App-Level Tokens and click "Generate Token". Add the connections:write scope.

Slack Channel Alert Source

In addition to notifications, Akmatori can monitor Slack channels for alerts posted by other bots and integrations. This is useful when you have monitoring tools (PagerDuty, Alertmanager, Datadog, etc.) that post to Slack but don't support webhooks.

Akmatori only processes bot and integration messages in alert channels. Regular messages from human users are ignored. To test the integration, use a monitoring tool or bot to post to the channel. If you need to interact with Akmatori directly, @mention the bot in a thread reply.

Bot Message DetectionAutomatically picks up messages from monitoring bots and integrations (identified by bot_message subtype or bot ID)

Thread ResponsesAI investigation results are posted as thread replies to the original alert

@mention SupportReply to any alert thread with @Akmatori to ask follow-up questions about the incident

Configure Slack Channel alert sources in Alert Sources. Select the channel to monitor and Akmatori will automatically process bot messages as alerts.