Skip to content
Integration

Telegram alerts

heyUptime sends alerts through a Telegram bot to a private chat, a group or a channel. Create the bot with @BotFather, paste its token and the chat ID, and alerts arrive as push notifications on your phone within seconds, with the cause, the URL, the time and a link to the monitor. Included on every plan, and every trial.

What arrives in Telegram

In short: A bold heading, one sentence, the facts, and a View monitor link. No link previews, so the message stays short.

LineExample
HeadingDown: Online shop
SummaryOnline shop is down.
FactsCause: HTTP 503 Service Unavailable. URL: https://shop.example.com/. Down since: Oct 8, 14:05 UTC
LinkView monitor

Setting it up

  • In Telegram, open a chat with @BotFather, send /newbot, and follow the two questions (a name and a username ending in bot). BotFather replies with a token that looks like 123456789:AAE…. Copy it.
  • Decide where alerts should go. For a private chat, start a conversation with your new bot and press Start. For a group, add the bot to the group. For a channel, add the bot as an administrator.
  • Find the chat ID. For a public channel it is the @name. For a private chat or group it is a number, often negative for groups (like -1001234567890); a bot such as @userinfobot or @getidsbot will tell you, or send a message to the group and read the id from the bot's getUpdates page.
  • In heyUptime, open Alerts, press Add channel and choose Telegram. Paste the bot token and the chat ID, add an optional name, and press Add Telegram channel.
  • On the Alerts page press Send test. If Telegram refuses, the message next to the channel says whether the token or the chat ID is the problem.

Every message Telegram can receive

MessageWhen it's sent
DownA second check, 5 seconds after the first failure, confirms the site is down
RecoveredA check passes again; includes how long it was down
Certificate expiring14, 7, 3 and 1 days before the certificate's expiry date
Domain expiring30, 14, 7 and 1 days before the domain's registration runs out
DNS changedWithin an hour of the domain's A, AAAA, CNAME, NS or MX records changing
TestWhen you press Send test on the Alerts page

Which plans include Telegram

PlanIncludedPrice
Starter$5/mo (₹349 in India)
Pro$12/mo (₹849 in India)
Business$29/mo (₹1,999 in India)
14-day trialFree, every channel unlocked, no card

If something goes wrong

The most common errors have their own messages: "Telegram rejected the bot token (HTTP 401)" means the token is wrong; "the bot can't post in this chat" means it hasn't been added or isn't an admin of the channel; a 400 usually means the chat ID is wrong. Temporary problems on Telegram's side are retried. The bot token is stored encrypted and never shown again after you paste it.

Questions

How do I find my Telegram chat ID?

For a public channel, use its @name. For a private chat or a group, message a helper bot such as @userinfobot or @getidsbot inside that chat; it replies with the numeric id. Group ids are usually negative.

Does the bot need to be an admin?

For a channel, yes: only administrators can post. For a group, adding the bot as a member is enough. For a private chat, press Start in the conversation with the bot first.

Can several people get the alert?

Yes. Point the channel at a group or a channel everyone is in, or add a second Telegram channel with another chat ID.

Is Telegram on the Starter plan?

No. Telegram is on every plan, including Starter at $5 a month.

Is this the same as SMS?

No. heyUptime doesn't send SMS or make calls. A Telegram push notification arrives on your phone within seconds and costs nothing, which is why many people use it instead.

An outage on your phone in seconds.

Make the bot, paste the token and chat ID, press Send test. Telegram is unlocked for 14 days on every plan, no card.

Start watching free

Updated October 8, 2026.