# How to Set Up Telegram Alerts for Website Downtime

> Step-by-step guide to receiving instant Telegram notifications when your website goes down. Set up a bot, connect it to Monitoristic, and never miss an outage.

*Source: https://monitoristic.com/blog/how-to-set-up-telegram-alerts-for-downtime*

---

Email notifications are easy to miss. SMS costs money. Slack is full of noise. For many developers, Telegram is where messages actually get read — instantly, on every device.

Here's how to set up Telegram alerts for your website downtime using Monitoristic.

## Why Telegram for Monitoring Alerts

Before we get into the setup, here's why Telegram works well for uptime alerts:

- **Instant delivery** — messages arrive in seconds, not minutes
- **Works everywhere** — desktop, mobile, web, even Apple Watch
- **Free** — no per-message charges like SMS
- **Quiet when you want it** — mute non-critical channels, keep alerts unmuted
- **Group support** — share alerts with your team in a group chat

Most developers already have Telegram installed. Adding monitoring alerts takes about 5 minutes.

## What You'll Need

1. A Telegram account
2. A Monitoristic account (any plan — Telegram is included on all plans)
3. About 5 minutes

## Step 1: Create a Telegram Bot

Every alert comes from a Telegram bot. Creating one is simple:

1. Open Telegram and search for **@BotFather**
2. Send `/newbot`
3. Choose a name for your bot (e.g., "My Uptime Alerts")
4. Choose a username (must end in `bot`, e.g., `mysite_uptime_bot`)
5. BotFather will give you a **bot token** — a long string that looks like `123456789:ABCdefGHIjklMNOpqrsTUVwxyz`

Save this token. You'll need it in the next step.

## Step 2: Get Your Chat ID

The bot needs to know where to send messages. That's your chat ID.

**For personal alerts:**
1. Search for **@userinfobot** on Telegram
2. Send it any message
3. It replies with your chat ID (a number like `123456789`)

**For team alerts (group chat):**
1. Create a new Telegram group
2. Add your bot to the group
3. Add **@RawDataBot** to the group temporarily
4. It will post a message containing the group chat ID (a negative number like `-1001234567890`)
5. Remove @RawDataBot from the group — you only needed it once

## Step 3: Connect in Monitoristic

1. Log in to your Monitoristic dashboard
2. Go to **Settings → Notifications**
3. Click **Connect Telegram**
4. Enter your bot token and chat ID
5. Click **Send Test** to verify — you should receive a test message in Telegram
6. Save the channel

That's it. Your Telegram bot is now connected.

## Step 4: Assign to Monitors

By default, new notification channels apply to all your monitors. You can also configure which monitors use which channels:

1. Go to any monitor's settings
2. Under **Notification Channels**, select your Telegram channel
3. Save

## What Alerts Look Like

When your site goes down, you'll receive a message like:

```
🔴 Monitor Down
api.example.com is DOWN
Status: 503
Checked at: 2026-05-05 14:23 UTC
```

When it recovers:

```
🟢 Monitor Recovered
api.example.com is back UP
Downtime: 4 minutes
Checked at: 2026-05-05 14:27 UTC
```

During scheduled maintenance:

```
🟡 Maintenance Started
api.example.com maintenance has begun
Window: 2026-05-05 22:00 - 23:00 UTC
```

## Tips for Managing Alert Noise

- **Pin the bot chat** so you always see it in your chat list
- **Use separate groups** for production vs staging alerts
- **Mute staging alerts** during work hours, keep production unmuted
- **Use Telegram's notification settings** to set custom sounds for the bot — make downtime alerts distinct from regular messages

## Troubleshooting

**Bot doesn't send messages:**
- Make sure you started a conversation with the bot first (send `/start`)
- Verify the bot token hasn't been regenerated in BotFather
- Check that the chat ID matches (personal ID for DMs, group ID for group chats)

**Messages go to the wrong chat:**
- Double-check the chat ID. Personal IDs are positive numbers, group IDs are negative
- If you moved the bot to a different group, the old chat ID won't work

**Want to switch from personal to group alerts:**
- Create a new notification channel with the group chat ID
- You can keep both — personal alerts for critical monitors, group alerts for everything else

## What About Other Notification Channels?

Monitoristic also supports webhooks, which let you send alerts to any HTTP endpoint — including Slack, Discord, Microsoft Teams, or your own custom system. Check our [webhook integration guide](/docs/webhooks) for details.

Email notifications and additional integrations are coming soon.

## Get Started

Setting up Telegram alerts takes 5 minutes and costs nothing extra. Every Monitoristic plan includes Telegram notifications — from Lite at $5/month to Business at $30/month.

Your website is too important to monitor without instant alerts. Set it up today.

For a deeper dive into the setup process and troubleshooting, see our full [Telegram integration documentation](/docs/telegram). New to Monitoristic? Start with our [guide to setting up your first monitor](/docs/setting-up-monitor).