Checkmate
Notifications

Telegram integration

Send alerts to a Telegram chat via a bot.

Telegram notifications use a bot account to send messages to a chat.

Create a bot and get the chat ID

  1. Open a chat with @BotFather in Telegram.
  2. Send /newbot and follow the prompts. Copy the bot token BotFather returns — it looks like 123456:ABC-DEF....
  3. Start a chat with your bot (or add it to a group), then send it any message.
  4. Fetch https://api.telegram.org/bot<token>/getUpdates in a browser and copy the chat.id from the JSON response. For groups the ID is negative.

Add the notification in Checkmate

  1. Open Notifications in the sidebar.
  2. Click Create notification and pick Telegram.
  3. Enter:
    • Address — the chat ID.
    • Access token — the bot token from BotFather.
  4. Click Test, then Save.

Both fields are required. The bot must already be a member of the chat (and allowed to post, for groups with restrictions).

On this page