Telegram is one of the best platforms for receiving monitoring alerts. Push notifications arrive instantly on mobile and desktop, the bot API is straightforward, and group chats let your entire team see alerts without anyone configuring a separate integration. If you already use Telegram for team communication or personal messaging, routing your downtime alerts there means one less app to check when something breaks.

CronAlert supports Telegram as an alert channel on the Pro plan and above. You create a Telegram bot, point it at a group or channel, and CronAlert sends formatted HTML messages through the Telegram Bot API whenever a monitor goes down or recovers. The whole setup takes about ten minutes.

How it works

The flow is simple: CronAlert detects that one of your monitors has failed (or recovered), then sends an HTTP request to the Telegram Bot API with your bot token and chat ID. Telegram delivers the message to your group, channel, or direct chat. Messages use Telegram's HTML parse mode, so you get bold text, line breaks, and structured formatting -- not a wall of plain text.

You provide two things: a bot token (from BotFather) and a chat ID (the numeric ID of the group or channel where you want alerts). CronAlert handles the rest.

Step 1: Create a Telegram bot via BotFather

Every Telegram bot starts with BotFather, Telegram's built-in tool for creating and managing bots.

1

Open BotFather

Search for @BotFather in Telegram and start a chat. Send the command /newbot.

2

Name your bot

BotFather will ask for a display name and a username. The display name can be anything descriptive like "CronAlert Notifications". The username must end in bot -- for example, myteam_cronalert_bot.

3

Copy the bot token

After creating the bot, BotFather replies with an API token that looks like this: 

123456789:ABCdefGHIjklMNOpqrsTUVwxyz-1234567890

Security note: Treat your bot token like a password. Anyone with this token can send messages as your bot. If it is ever compromised, use /revoke in BotFather to generate a new one.

Step 2: Get your chat ID

You need the numeric chat ID of the group, channel, or direct chat where you want alerts delivered.

1

Add the bot to your group or channel

Open the Telegram group (or channel) where you want alerts and add your new bot as a member. For channels, add the bot as an administrator with permission to post messages.

2

Send a message in the group

Post any message in the group so there is at least one update for the bot to see.

3

Call the getUpdates API

Open a browser or use curl to hit the following URL, replacing the placeholder with your bot token: 

https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates

The response is JSON. Look for the chat object inside the most recent message. The id field is your chat ID: 

{
  "ok": true,
  "result": [{
    "message": {
      "chat": {
        "id": -1001234567890,
        "title": "Monitoring Alerts",
        "type": "supergroup"
      }
    }
  }]
}

Copy that id value. Group and supergroup IDs are negative numbers -- that is normal.

Step 3: Add Telegram as an alert channel in CronAlert

Now connect your bot to CronAlert.

1

Open Alert Channels

Log in to CronAlert and navigate to Alert Channels in the sidebar. Click Add Alert Channel.

2

Select Telegram and enter your credentials

Choose Telegram as the channel type. Enter a descriptive name like "Ops Telegram Group", then paste your bot token and chat ID into the corresponding fields.

3

Save and test

Click Save. Use the Send Test button to verify the connection. A sample alert should appear in your Telegram group within seconds. If nothing arrives, double-check that the bot is a member of the group and that the chat ID is correct.

Plan requirement: Telegram alerts are available on the Pro plan ($5/mo) and above. If you are on the free plan, you will see the Telegram option but will need to upgrade to activate it.

Step 4: Assign to monitors

With the alert channel created, assign it to the monitors you want to receive Telegram notifications for. Open any monitor's settings, find the Alert Channels section, and check the Telegram channel you just created. You can assign multiple alert channels to a single monitor -- for example, Telegram plus Slack or Discord -- so your team gets notified everywhere that matters.

What the alerts look like

CronAlert sends HTML-formatted messages through the Telegram Bot API. They are structured for quick scanning on both mobile and desktop.

When a monitor goes down: 

<b>DOWN: Production API</b>

<b>URL:</b> https://api.example.com/health
<b>Status:</b> 503
<b>Error:</b> Service Unavailable
<b>Regions:</b> us-east, eu-west

When a monitor recovers: 

<b>RECOVERED: Production API</b>

<b>URL:</b> https://api.example.com/health
<b>Downtime:</b> 8m 12s

DOWN alerts include the monitor name, URL, HTTP status code, error description, and failing regions for multi-region monitors. RECOVERED alerts show the URL and total downtime duration. The bold HTML formatting makes key information stand out in a busy chat.

Tips for getting the most out of Telegram alerts

Use a dedicated group for monitoring

Create a Telegram group specifically for alerts rather than posting them into a general team chat. This keeps your monitoring signals clean and makes it easy to scroll back through alert history without wading through unrelated messages.

Pin important alerts

Telegram lets you pin messages in groups. If a critical service goes down during an incident, pin the DOWN alert so everyone joining the group sees it immediately. Unpin it when the RECOVERED message arrives.

Combine with other alert channels

Telegram does not have to be your only notification method. Assign multiple alert channels to a single monitor -- for example, Telegram for on-call engineers and Slack for the broader team, or Telegram plus email as a fallback. CronAlert sends to all assigned channels simultaneously. See our uptime monitoring setup guide for more on building a robust alerting strategy.

Keep your bot token secure

Never share your bot token in public repositories or chat messages. If you are using CronAlert's API to programmatically manage alert channels, store the token in environment variables or a secrets manager. If a token is compromised, revoke it immediately via BotFather with /revoke.

Frequently asked questions

Is Telegram alerting available on the free plan?

No. Telegram is a Pro plan feature, available at $5/mo (or $4/mo on the annual plan). The free plan includes email, Slack, Discord, and webhook alerts. See all plans for the full feature comparison.

Can I send alerts to multiple Telegram groups or channels?

Yes. Create a separate alert channel in CronAlert for each Telegram group or channel, each with its own bot token and chat ID. You can assign different monitors to different alert channels, so production alerts go to one group and staging alerts go to another.

Do I need to keep the bot running on a server?

No. CronAlert sends messages through the Telegram Bot API directly. Your bot does not need to be polling for updates or running on any server. You only need the bot token and the chat ID -- CronAlert handles the HTTP requests to Telegram on your behalf.

What format do the alerts use?

CronAlert uses Telegram's HTML parse mode. Messages include bold labels for status, URL, error details, regions, and downtime duration. The formatting works on all Telegram clients -- mobile, desktop, and web.

Wrapping up

Telegram's instant push notifications and simple bot API make it an excellent channel for downtime alerts. Create a bot, grab the chat ID, paste both into CronAlert, and your team starts getting structured HTML alerts the next time a monitor fails. The whole setup takes about ten minutes, and you get alerts that are easy to read at a glance on any device.

If you do not have a CronAlert account yet, sign up free and upgrade to Pro to unlock Telegram alerts along with 1-minute check intervals, keyword monitoring, and maintenance windows. Already using Slack or Discord for alerts? Adding Telegram as a secondary channel takes just a few clicks.