> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shinzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Channels Overview

> Manage channel integrations for agent messaging.

# 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

| Method   | Endpoint                                                        | Description                   |
| -------- | --------------------------------------------------------------- | ----------------------------- |
| `GET`    | [`/v1/agent/{id}/channels`](/api/agents/list-channels)          | List all channel bindings     |
| `POST`   | [`/v1/agent/{id}/discord/link`](/api/agents/discord-link)       | Generate a Discord link code  |
| `GET`    | [`/v1/agent/{id}/discord/status`](/api/agents/discord-status)   | Check Discord link status     |
| `DELETE` | [`/v1/agent/{id}/discord/unlink`](/api/agents/discord-unlink)   | Unlink Discord account        |
| `POST`   | [`/v1/agent/{id}/slack/link`](/api/agents/slack-link)           | Generate a Slack link code    |
| `GET`    | [`/v1/agent/{id}/slack/status`](/api/agents/slack-status)       | Check Slack link status       |
| `DELETE` | [`/v1/agent/{id}/slack/unlink`](/api/agents/slack-unlink)       | Unlink Slack account          |
| `POST`   | [`/v1/agent/{id}/telegram/link`](/api/agents/telegram-link)     | Generate a Telegram link code |
| `GET`    | [`/v1/agent/{id}/telegram/status`](/api/agents/telegram-status) | Check Telegram link status    |
| `DELETE` | [`/v1/agent/{id}/telegram/unlink`](/api/agents/telegram-unlink) | Unlink 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

<Info>
  **Supported channels**: Discord, Slack, and Telegram. WhatsApp support is coming soon.
</Info>

For a full guide on channel integrations, see [Agent Messaging & Channels](/agents/messaging).
