Enterprise Tool

Slack

Post messages, react, and look up users via the Slack Bot API

CipherSense Agents connects to Slack using your Bot User OAuth Token (xoxb-...), letting workflow nodes post and update messages, add emoji reactions, look up users by email or ID, and list workspace channels. Optionally supply your app's Signing Secret to verify incoming events via the Slack webhook endpoint at /api/integrations/slack/webhook — enabling event-driven workflows that trigger on messages, mentions, reactions, and more.

Official documentation

Setup

Create a Slack app and install it to your workspace

Go to api.slack.com/apps and click Create New App > From scratch. Give it a name and select your workspace. Under OAuth & Permissions add the Bot Token Scopes you need — at minimum: chat:write (post messages), channels:read (list channels), users:read (look up users), reactions:write (add reactions). Add users:read.email if you need to look up users by email. Click Install to Workspace and copy the Bot User OAuth Token that starts with xoxb-.

Slack API Apps

(Optional) Configure the Signing Secret for webhook-triggered workflows

Go to your app's Basic Information page and copy the Signing Secret. Paste it into the integration's Signing Secret field. Then go to Event Subscriptions, enable events, and set the Request URL to https://agents.ciphersense.ai/api/integrations/slack/webhook. Subscribe to the bot events you need (e.g. message.channels, app_mention, reaction_added). Slack will verify the endpoint automatically.

Invite the bot to channels

Your bot can only post to or read channels it has been invited to. In Slack, open the channel and type /invite @YourBotName, or use the channel settings to add the bot as a member.

Add the integration in CipherSense Agents

Go to Project > Integrations > Add Integration > Slack. Paste your Bot User OAuth Token and optionally your Signing Secret and a Default Channel. Click Save & Test — the test calls auth.test to confirm the token is valid.

Connection Fields

Fields required when adding this integration in your Project › Integrations.

Field	Required	Description
Bot User OAuth Token	Required	From api.slack.com/apps > OAuth & Permissions > Bot User OAuth Token. Used as Authorization: Bearer {botToken}.
Signing Secret	Optional	From api.slack.com/apps > Basic Information > App Credentials. Used to verify incoming webhook events from Slack.
Default Channel	Optional	Channel ID or name used as the default when no channel is set per-node.

Common Use Cases

AI agent sends a Slack message summary after completing a long-running workflowCustomer support: HubSpot form submitted → look up user → post enriched lead to #sales channelIncident alerts: monitor data source → detect anomaly → post Block Kit alert to #ops with contextApproval workflow: AI draft created → post to Slack for human review → collect reaction to proceedMention-triggered workflows: app_mention event fires → AI processes the message → replies in thread

Ready to connect Slack?

Add this integration from your project dashboard and wire it into a workflow.

Open Dashboard ← Back to Integrations