Cotool + Slack
Connect Slack to Cotool to DM or @mention security agents, trigger them with emoji reactions, get alert notifications, and approve agent actions in Slack.
The short answer
The Slack integration lets your team work with Cotool agents in Slack: DM the bot, @mention it in channels, or react with a configured emoji to run an agent on a message. Alert notifications arrive with evidence summaries and status controls, and state-changing agent actions can be approved in Slack.[1][2][3]
How it connects: Install the Cotool Slack app through OAuth and pick the workspace. You can connect several workspaces, and you can set up a custom Slack app instead of the shared one.[1][2]
What Cotool uses from Slack
Response actions
These change state in Slack, so they are the steps teams usually gate behind approval.
Detections, hunts, and triage
- Ask the SOC agent from a channelTriage
- In any channel with the bot, a message such as "@Cotool investigate the alert for IP 192.168.1.100" starts the response agent behind that channel's Slack trigger.[1]
- Run an agent with an emojiTriage
- React to a message with a configured emoji to run an agent on it. Several people adding the same reaction to the same message start only one run.[1]
Setup and permissions
Click Connect in Cotool's integration settings, authorize the app in Slack, and choose the workspace. Cotool creates a default Slack trigger on your default response agent if you have none.[1]
| Permission | Access | Why |
|---|---|---|
app_mentions:readView messages that directly mention the app in conversations it is in.[4] | Read | View messages that directly mention the app in conversations it is in.[4] |
im:historyView messages in direct messages with the app.[5] | Read | View messages in direct messages with the app.[5] |
reactions:readView emoji reactions in conversations the app has been added to.[6] | Read | View emoji reactions in conversations the app has been added to.[6] |
emoji:readView custom emoji in the workspace.[7] | Read | View custom emoji in the workspace.[7] |
files:readView files shared in conversations the app has been added to.[8] | Read | View files shared in conversations the app has been added to.[8] |
chat:writeSend messages as the app.[9] | Write | Send messages as the app.[9] |
How Cotool works with Slack
- A trigger alert stays in one Slack thread through closure, re-escalations return to the existing thread, and thread replies are mirrored in the alert's Activity.[2]
- Your own Slack triggers take precedence over the default trigger for the channels they cover, and GitOps-managed agents configure Slack triggers in the repository.[1]
FAQ
Sources
- Slack integration (Cotool docs) · accessed November 16, 2026
- Changelog (Cotool docs) · accessed November 16, 2026
- AI SOC (Cotool) · accessed November 16, 2026
- app_mentions:read scope (Slack Developer Docs) · accessed November 16, 2026
- im:history scope (Slack Developer Docs) · accessed November 16, 2026
- reactions:read scope (Slack Developer Docs) · accessed November 16, 2026
- emoji:read scope (Slack Developer Docs) · accessed November 16, 2026
- files:read scope (Slack Developer Docs) · accessed November 16, 2026
- chat:write scope (Slack Developer Docs) · accessed November 16, 2026

