Telegram Integration

Monitoristic sends real-time notifications to any Telegram chat — personal, group, or channel — when your monitors go down or recover. This guide walks you through the setup in about two minutes.

What You'll Need

• A Telegram account
• A Monitoristic account with at least one monitor

Step 1: Create a Telegram Bot

1. Open Telegram and search for @BotFather.
2. Send the command /newbot.
3. Follow the prompts to choose a name and username for your bot.
4. BotFather will reply with a bot token — a long string that looks like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.
5. Copy this token. You'll need it in Step 3.

Keep your bot token private. Anyone with this token can send messages as your bot.

Step 2: Get Your Chat ID

The chat ID tells Monitoristic where to send notifications. The process differs slightly depending on whether you want alerts in a personal chat or a group.

Personal Chat

1. Send any message to your new bot (just type "hello").
2. Then open a conversation with @userinfobot and send /start.
3. It will reply with your user info, including your chat ID (a number like 123456789).
4. Copy this number.

Group Chat

1. Add your new bot to the group where you want alerts.
2. Add @RawDataBot to the same group.
3. RawDataBot will immediately post a JSON message. Look for the "chat" section and find the "id" field — it will be a negative number like -1001234567890.
4. Copy this number, then remove @RawDataBot from the group (you only needed it for the ID).

Step 3: Connect in Monitoristic

1. Go to Settings → Notifications in your Monitoristic dashboard.
2. Click "Connect Telegram".
3. Enter a name for this connection (e.g., "Ops Team Alerts").
4. Paste your bot token from Step 1.
5. Paste your chat ID from Step 2.
6. Click "Send Test Message" to verify the connection works.
7. If you see a test message arrive in Telegram, click "Save".

What Alerts Look Like

When a monitor goes down, you'll receive a message like this:

🔴 Down: My Website
URL: https://example.com
HTTP: 500
Response: 1234ms
Time: Thu, 02 May 2026 12:00:00 GMT

When it recovers:

🟢 Recovered: My Website
URL: https://example.com
HTTP: 200
Response: 245ms
Time: Thu, 02 May 2026 12:05:00 GMT

Maintenance Alerts

If you use maintenance windows, Telegram also notifies you about maintenance events:

• 📅 Maintenance Started — when a scheduled window begins
• ✅ Maintenance Completed — when the window ends and services are verified
• ⏳ Maintenance Extended — when a window is auto-extended because a service is still down
• 🚨 Maintenance Escalated — when max extensions are reached and an incident is created

Limits

Telegram channels count toward your plan's notification channel limit. You can have multiple Telegram connections — for example, one for personal alerts and another for a team group.

• Lite: up to 5 notification channels
• Pro: up to 10 notification channels
• Business: up to 25 notification channels

This limit is shared across both Telegram and webhook channels.

Troubleshooting

Test message doesn't arrive

• Make sure you sent a message to your bot first (it can't message you until you initiate).
• Double-check the bot token — it should include the colon (e.g., 123456:ABC...).
• Verify the chat ID is correct and matches the right chat or group.

Getting the wrong chat ID

• For personal chats, use @userinfobot.
• For groups, use @RawDataBot — the group ID is a negative number starting with -100.
• Don't use your personal ID for a group — it won't work.

Bot removed from group

If someone removes the bot from a group, notifications will silently fail. Re-add the bot and verify with a test message.

Frequently Asked Questions