Telegram

Telegram delivers incident alerts to a chat or group through the Observer bot.

Connect a chat#

1. •

   Start the connection#

   In the console, open Alerts, choose Add alert, pick Telegram, choose the scope, and select Connect via Telegram. This opens the Observer bot in Telegram.

2. •

   Press Start#

   In the chat that opens, press Start. The bot links that chat to your organization and confirms with a welcome message.

3. •

   Confirm#

   Return to the console and refresh. The Telegram integration now appears in the list. Use Test to send a sample alert.

To deliver to a group, add the bot to the group first, then run the connect step from inside the group.

Enter a chat id manually#

If you already know the chat id, you can skip the deep link and type it into the Chat ID field instead. Numeric ids and @channelname handles are both accepted.

Self-hosted deployments#

Observer Cloud runs the bot for you. If you operate your own deployment, you must:

1. Create a bot with @BotFather and note its token and username.
2. Set TELEGRAM_BOT_TOKEN, TELEGRAM_BOT_USERNAME, and a random TELEGRAM_WEBHOOK_SECRET in the environment.
3. Register the bot webhook to point at /api/telegram/webhook, passing the same secret as the Telegram secret token.

Without these, the Telegram option stays inert and the manual chat-id path is the only one available.