Back to Docs

Configuring Telegram Alerts

Receive real-time downtime and system notification alerts directly on your Telegram messenger or team channels.

Overview

Monitor Hub supports real-time alert routing to Telegram. Setting up notifications requires configuring a Telegram Bot Token and a destination Chat ID. This guide explains how to get these parameters in under 2 minutes.

Setup Steps

1

Create a Bot via @BotFather

  1. Open Telegram and search for the official, verified @BotFather.
  2. Click Start or send the command /newbot.
  3. Provide a display name for your bot (e.g. MonitorHub Alerts).
  4. Choose a username ending in bot (e.g. my_org_alerts_bot).
  5. BotFather will reply with an API token. Copy this key (e.g. 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).
CRITICAL STEP: Click the link to your new bot (e.g. t.me/your_bot_username) and click Start. Telegram bots are prohibited from sending unsolicited messages to users who have not explicitly started a chat session with them.
2

Retrieve Your Chat ID

Choose where you want the notifications to be sent:

Private Personal Alerts

  1. Search for the verified @userinfobot or @GetIDsBot.
  2. Click Start.
  3. It will instantly reply with your User ID (e.g. 987654321). Copy this value.

Team Group Chat Alerts

  1. Add your custom alert bot to your team group.
  2. Temporarily add @GetIDsBot to the group.
  3. Copy the group ID printed in the chat (group IDs are prefixed with a minus sign, e.g. -1001234567890).
  4. Remove @GetIDsBot from the group.
3

Save Configuration in Monitor Hub

  1. Go to your Monitor Hub dashboard, navigate to Settings and click the Notifications tab.
  2. Find the **Telegram Messenger** card, and click **Configure Telegram**.
  3. Paste the **Bot Token** from Step 1 and the **Chat ID** from Step 2.
  4. Click **Save Configuration**.
  5. Click **Send Test** to verify routing. You should receive a test message immediately.

Troubleshooting

Error: Telegram test failed

Check that your bot has been started (by searching its username on Telegram and clicking Start). Ensure your bot is not blocked. Additionally, make sure the Chat ID includes the minus prefix if it's a group (e.g. `-100...`).

Bot token is reset or invalid

If you revoked your token in BotFather or generated a new one, you must update the settings in Monitor Hub. Click **Reconfigure Telegram** in Settings, paste the new token, and click Save.

Alerts are not sending, but tests work

Ensure that Telegram alerts are linked to your specific monitor. Navigate to **Dashboard > Monitors**, choose your monitor, click Edit, and verify that notifications are toggled on.