Skip to main content

​
What are Channels?

Channels are the messaging platforms that your agents connect to. Each channel provides a bridge between your users and the AI agent. When your agent is running, channel status is polled every 12 seconds and shown live in the dashboard (connected, error, error message).

​
Supported Channels

ChannelProtocolSetup
WebChatBuilt-inNo setup — available in the Workspace tab
WhatsAppBaileys (Web)QR code scan
TelegramgrammY Bot APIBot token from @BotFather
Discorddiscord.jsBot token from Discord Developer Portal
SlackSocket Mode / HTTPSlack App with Bot Token
SignalSignal CLIPhone number registration
iMessageimsg CLI (macOS)macOS node required
Google ChatGoogle WorkspaceService account
MattermostPluginPlugin installation
MS TeamsPluginPlugin installation
LINEMessaging APIChannel access token
Feishu/LarkBot APIApp credentials

​
DM Policy

Each channel has a DM (direct message) policy that controls who can message the agent:
PolicyBehavior
pairing (default)Unknown senders receive a pairing code for approval
allowlistOnly senders in the allowFrom list can message
openAnyone can message (requires allowFrom: ["*"])
disabledAll DMs are ignored

​
Group Policy

For group chats, channels have a separate group policy:
PolicyBehavior
openAll senders in the group are allowed
allowlist (default)Only senders in groupAllowFrom
disabledNo group chat support

​
Channel Configuration Example

Here is an example Telegram channel configuration: 
{
  "telegram": {
    "enabled": true,
    "botToken": "123456:ABC-DEF...",
    "dmPolicy": "pairing",
    "allowFrom": ["tg:123456789"]
  }
}

​
Per-Agent Channels

Each agent can have its own channel connections. This means:
  • Agent A can be connected to WhatsApp Account 1
  • Agent B can be connected to WhatsApp Account 2
  • Both agents can share the same Telegram bot, routed via bindings

​
Media Support

Channels support media attachments: Inbound: Images, audio, video, and documents are received and stored as temp files. Audio is automatically transcribed. Outbound: Agents can send media by including MEDIA:<path-or-url> in their response.
ChannelImage LimitAudio/VideoDocuments
WhatsApp~6 MB16 MB100 MB
Telegram10 MB50 MB50 MB
Discord25 MB25 MB25 MB

Guide: Connect a Channel

Step-by-step setup for each channel platform.