Channels
Chat Channels
Telegram, Slack, and Discord setup notes.
Telegram, Slack, and Discord are useful reach channels. They share the same Facio runtime but differ in how they identify users, register commands, handle groups, stream output, and download attachments.
Telegram
Telegram uses long polling, so it does not need a public webhook URL.
| Field | Meaning |
|---|---|
enabled | Start the Telegram bot. |
token | Telegram bot token. |
allowFrom | User IDs allowed to use the bot. |
proxy | Optional proxy URL. |
replyToMessage | Reply to the triggering message. |
groupPolicy | mention by default; group messages need a bot mention or reply. |
streaming | Edit messages progressively while the agent works. |
inlineKeyboards | Enable inline buttons for supported interactions. |
Telegram registers command menu entries for core commands such as new, stop, status, history, reflect, and help.
Slack
Slack uses Socket Mode.
| Field | Meaning |
|---|---|
enabled | Start Slack integration. |
mode | Defaults to socket. |
botToken | Slack bot token. |
appToken | Slack app-level token for Socket Mode. |
replyInThread | Keep replies in Slack threads. |
includeThreadContext | Include recent thread history when the bot is pulled into a thread. |
allowFrom | Allowed user IDs. |
groupPolicy | Usually mention; group messages require bot mention. |
groupAllowFrom | Channel/group-level allow list. |
dm.enabled | Allow direct messages. |
dm.allowFrom | Optional DM sender allow list. |
Slack can download files when the bot has the right scopes and can include thread context to make replies more useful.
Discord
Discord uses discord.py and registers app commands.
| Field | Meaning |
|---|---|
enabled | Start Discord bot. |
token | Discord bot token. |
allowFrom | Allowed user IDs. |
allowChannels | Allowed channel IDs; empty means all channels. |
intents | Discord gateway intents bitmask. |
groupPolicy | mention by default. |
streaming | Enable progressive message updates. |
proxy, proxyUsername, proxyPassword | Optional proxy support. |
Setup order
- Create the bot/app in the platform.
- Add the required token fields.
- Add explicit
allowFromor channel allow lists. - Enable the channel.
- Send
/statusfrom an allowed identity. - Check logs if the channel receives messages but the agent does not answer.