docs

Channels

Telegram

Connect a Telegram bot to an agent.

Before you start

You'll need a bot token from @BotFather on Telegram. Add it once under Organization settings → Channels as a Telegram credential (a label/alias + the bot token) — see Channel credentials.

Connecting

On the agent's Channels tab, add a Telegram channel and pick the credential you added. The channel shows your bot's @username once connected.

Setting the webhook

Click Set/refresh webhook to point Telegram at this agent. If you're testing locally, this requires your app to be reachable over a public HTTPS URL (a tunnel), since Telegram calls your webhook directly — it won't work against a plain localhost address.

If you recreate the channel

Deleting and re-adding a Telegram channel generates a new webhook — you'll need to click Set/refresh webhook again afterward, or the bot will stop responding even though the channel looks connected in the dashboard.