Slack Webhooks

Slack webhooks let agents respond to workspace events like messages, app mentions, and reactions via the Slack Events API.

Filter Fields (all optional)

Field	Type	Description
`events`	string[]	Slack event types: `message`, `app_mention`, `reaction_added`, `reaction_removed`, `channel_created`, `member_joined_channel`
`channels`	string[]	Only trigger for these Slack channel IDs
`team_ids`	string[]	Only trigger for these Slack workspace/team IDs

Setup

In the Slack API dashboard (https://api.slack.com/apps), create or select your app
Go to Event Subscriptions and enable events
Set the Request URL to https://your-server:8080/webhooks/slack
The gateway automatically responds to Slack’s URL verification challenge
Subscribe to the bot events you need (e.g., message.channels, app_mention)
Go to Basic Information → App Credentials and copy the Signing Secret
Set the signing secret credential to match slack_signing_secret referenced by the webhook source in config.toml

URL Verification

The Slack provider automatically handles URL verification challenges. When Slack sends a url_verification request, the gateway validates the signature and responds with the challenge token. No manual setup is needed.

Replay Protection

The provider rejects requests with timestamps older than 5 minutes, protecting against replay attacks.

Example Configuration

# In project config.toml
[webhooks.my-slack]
type = "slack"
credential = "MainWorkspace"

# In agents/<name>/config.toml
[[webhooks]]
source = "my-slack"
events = ["message", "app_mention"]
channels = ["C0123456789"]
team_ids = ["T0123456789"]

First Steps

Guides

Concepts

Integrations

Reference

Filter Fields (all optional)

Setup

URL Verification

Replay Protection

Example Configuration

​Filter Fields (all optional)

​Setup

​URL Verification

​Replay Protection

​Example Configuration

Filter Fields (all optional)

Setup

URL Verification

Replay Protection

Example Configuration