Guides/Slack Integration

Slack Integration

Connect agents to Slack workspaces. Supports DMs, @mentions in channels, multi-agent routing, and thread continuity.

Key Concepts

•Channel Adapter — Pluggable abstraction for external messaging platforms. Slack is the first implementation; Telegram and Discord are planned.

•Socket Mode — Default transport using a WebSocket connection. No public URL required. Configured via a Slack App Token (xapp-...).

•Webhook Mode — HTTP webhook transport for production environments (fallback option).

•Multi-Agent Routing — Multiple agents can share one Slack workspace. Each agent is bound to a dedicated channel. DMs are routed to a default agent; @mentions route to the bound agent.

•Thread Tracking — The bot automatically responds to thread replies without requiring an @mention.

Platform Setup (Admin)

Go to Settings > Slack section.

Enter your Slack App Token (xapp-...) for Socket Mode.

Click Connect to start the Socket Mode transport.

Click Install to Workspace to perform platform-level OAuth and obtain a bot token.

The connection status badge shows connected or disconnected.

Per-Agent Channel Binding

Open the agent detail page and select the Sharing tab.

In the Slack Channel section, click Create Channel.

A dedicated Slack channel is created and bound to this agent. All messages in that channel are routed to the bound agent.

To disconnect, click Unbind.

Message Flow

Transport -> Adapter -> Router -> Agent -> Response

Message Type	Routing
DM to bot	Default agent
@mention in channel	Bound agent for that channel
Thread reply (no @mention)	Same agent that was originally mentioned

Rate Limiting

Setting	Default
Messages per window per Slack user	30
Window duration	60 seconds
Execution timeout	120 seconds
Allowed tools	WebSearch, WebFetch

Rate limit and timeout values are configurable via settings (channel_rate_limit_max, channel_rate_limit_window).

Slack API

Endpoint	Method	Description
/api/settings/slack/status	GET	Connection state
/api/settings/slack/connect	POST	Start Socket Mode
/api/settings/slack/disconnect	POST	Stop transport
/api/settings/slack/install	POST	OAuth install
/api/agents/{name}/slack/channel	GET	Channel binding status
/api/agents/{name}/slack/channel	POST	Create and bind channel
/api/agents/{name}/slack/channel	DELETE	Unbind channel

Limitations

•Only one Slack workspace can be connected per Trinity instance.

•Webhook Mode requires a publicly accessible URL.

•Thread tracking applies only to threads started by a bot message or @mention.

•Rate limits are per Slack user, not per agent.

GitHub Sync Agent Sharing