Skip to content

Telegram Channel Plugin

The Telegram channel plugin is an alert_deliver plugin that sends alert messages to Telegram chats through the Telegram Bot API. It receives Core-rendered messages and adapts them to Telegram transport.

Highlights

  • Sends messages with bot token and chat id configuration.
  • Supports plain, HTML, and MarkdownV2 parse modes.
  • Provides disable-notification, protected-content, timeout, retry, and backoff settings.
  • Separates bot-token validation from optional test-chat message delivery in health checks.

Before Registration

  • Prepare a BotFather-issued bot token and target chat id.
  • For groups or supergroups, confirm that the bot can send messages.
  • Review escaping rules before enabling formatted parse modes.

Operations Tips

  • Bot tokens are sensitive and must not appear in health or action responses.
  • Core-rendered plain text is the safest default.
  • Telegram does not provide a universal idempotency key; use Core delivery sessions when investigating duplicates.