​

Channels

​

Supported Channels

​

Telegram (Recommended)

​

Steps

1. Open @BotFather on Telegram
2. Send /newbot and follow the prompts
3. Copy the bot token (looks like 123456:ABC-DEF...)
4. Paste it in Control UI → Channels → Telegram → Bot Token
5. Click Save → Probe to test the connection

​

Key Settings

• DM Policy: pairing (default) — users must pair before chatting
• Group Policy: open or disabled — whether the bot responds in groups
• Streaming: partial (default) — shows typing indicator while generating
• Allow From: Leave empty for open access, or add specific Telegram user IDs

​

Quick Config

channels.telegram.enabled = true
channels.telegram.botToken = "YOUR_TOKEN"
channels.telegram.dmPolicy = "pairing"
channels.telegram.streaming = "partial"

​

WhatsApp

​

Steps

1. Go to Control UI → Channels → WhatsApp
2. Set Enabled = true
3. Click Save
4. Click Show QR — a QR code appears
5. Open WhatsApp on your phone → Settings → Linked Devices → Link a Device
6. Scan the QR code
7. Wait for “Connected” status

​

Key Settings

• Self-Phone Mode: Enable if the bot uses your personal number
• DM Policy: pairing recommended for security
• Group Policy: disabled by default — enable if you want bot in groups
• Debounce: 500ms default — batches rapid messages from same sender

​

⚠️ Important

• WhatsApp sessions expire. Use Relink if connection drops
• Your phone must stay connected to the internet

​

Discord

​

Steps

1. Go to Discord Developer Portal
2. Click New Application → name it → Create
3. Go to Bot tab → click Reset Token → copy the token
4. Go to OAuth2 → URL Generator → select bot scope
5. Select permissions: Send Messages, Read Message History, Use Slash Commands
6. Copy the generated URL → open it → add bot to your server
7. Paste the bot token in Control UI → Channels → Discord → Bot Token
8. Click Save → Probe

​

Key Settings

• Intents: Enable Message Content Intent in Discord Developer Portal
• Guilds: Add your server ID to restrict which servers the bot responds in
• Presence: Set online status and activity text
• Streaming: partial shows live typing updates

​

Slack

​

Steps

1. Go to Slack API → Create New App
2. Choose From scratch → name it → select workspace
3. Go to Socket Mode → enable it → copy App Token
4. Go to OAuth & Permissions → add scopes: chat:write, im:history, im:write, channels:history
5. Install to workspace → copy Bot Token
6. Paste both tokens in Control UI → Channels → Slack
7. Click Save → Probe

​

Key Settings

• Mode: socket (recommended) — no public URL needed
• Native Streaming: true — uses Slack’s native streaming API
• Reaction Level: ack — reacts to messages with 👍 when processed

​

General Channel Settings

​

Troubleshooting

​

Bot not responding

1. Check Control UI → Channels — is it showing “Running: Yes”?
2. Click Probe to test the connection
3. Check Logs for errors

​

”Connected” but no messages

• Check DM Policy — if set to pairing, users must pair first
• Check Allow From — if set, only listed users can chat
• Check Group Policy — might be blocking group messages

​

Connection keeps dropping

• WhatsApp: Phone went offline — use Relink
• Telegram: Bot token expired — regenerate in @BotFather
• Discord: Intents not enabled — check Developer Portal

​

Need Help?

• Discord Community
• Documentation