Skip to main content

​
Agent Channels

Channel endpoints let you manage external integrations like Discord, Slack, and Telegram for your agents. The API channel is always available by default.

​
Endpoints

MethodEndpointDescription
GET/v1/agent/{id}/channelsList all channel bindings
POST/v1/agent/{id}/discord/linkGenerate a Discord link code
GET/v1/agent/{id}/discord/statusCheck Discord link status
DELETE/v1/agent/{id}/discord/unlinkUnlink Discord account
POST/v1/agent/{id}/slack/linkGenerate a Slack link code
GET/v1/agent/{id}/slack/statusCheck Slack link status
DELETE/v1/agent/{id}/slack/unlinkUnlink Slack account
POST/v1/agent/{id}/telegram/linkGenerate a Telegram link code
GET/v1/agent/{id}/telegram/statusCheck Telegram link status
DELETE/v1/agent/{id}/telegram/unlinkUnlink Telegram account

​
Linking Workflow

All channel integrations follow a similar workflow:
  1. Generate a link code via POST /v1/agent/{id}/{channel}/link (expires in 10 minutes)
  2. Send /link CODE to the appropriate bot:
    • Discord: Send as DM to the Shinzo bot
    • Slack: Send as DM to your agent’s Slack bot
    • Telegram: Send as message to your agent’s Telegram bot
  3. Start chatting — messages are routed to your agent automatically
Supported channels: Discord, Slack, and Telegram. WhatsApp support is coming soon.
For a full guide on channel integrations, see Agent Messaging & Channels.