Skip to main content
Telegram is a notification channel: agents deliver approval requests, clarification questions, and escalations into a Telegram chat, and replies resume the run.
Estimated time: 5 minutes. You will need the ability to create a bot with Telegram’s @BotFather.

​
Prerequisites

  • A Telegram account
  • A group or channel you want Clarion to post into

​
Step 1 — Create a bot

  1. In Telegram, open a chat with @BotFather.
  2. Send /newbot and follow the prompts to name your bot.
  3. BotFather replies with a bot token in the form 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.
The bot token is a credential. Anyone holding it can post as your bot. Store it securely and rotate it from BotFather if it leaks.

​
Step 2 — Add the bot to your chat

  1. Add the bot to the group or channel you want notifications in.
  2. Grant it permission to post messages.
  3. Note the chat ID for that conversation — group and channel IDs are negative numbers, e.g. -1001234567890.

​
Step 3 — Connect in Clarion

  1. In Clarion, open Integrations and find Telegram.
  2. Paste the bot token and click Connect.
  3. Under Add Channel, give the destination a name (e.g. Alerts) and paste its chat ID.
You can add several channels — each becomes selectable as a notification destination.

​
What agents can do

​
Rotate the token

Open Integrations → Telegram and enter a New bot token. Existing channels keep working.

​
Disconnect

Click Disconnect on the integration page. Configured channels are removed, and any notification destination pointing at Telegram stops delivering.