Skip to main content
The Telegram destination sends alerts to a Telegram chat through the UptimeIO bot, @UptimeIOAlertBot. You connect by messaging the bot; there is nothing to copy or paste, and no verification code.

Connect Telegram

1

Open Destinations

Click Destinations in the sidebar, then Add Destination, then choose Telegram.
2

Open the bot

The dashboard shows a QR code and an Open on desktop link. Scan the code with your phone or click the link to open a conversation with @UptimeIOAlertBot.
3

Send /start

In Telegram, press Start (or send /start). The link you opened carries a one-time code that ties the chat to your organization. The link is valid for 24 hours.
4

Wait for confirmation

The dashboard detects the connection within a few seconds and shows Successfully Connected with your chat ID. If nothing happens within 5 minutes, click Try Again.
5

Choose events and save

Toggle which events go to Telegram (all are enabled by default; at least one must stay enabled), then submit the form. Finally, select the destination in each monitor’s Notifications section.
Telegram destinations can only be set up from the dashboard, because connecting needs the bot link flow. An API key cannot create one: POST /api/integrations with "type": "TELEGRAM" returns 403 with code JWT_REQUIRED and the message Pushover and Telegram integrations can only be set up from the dashboard. Sign in to the dashboard and add the integration there. Once it exists, you can assign it to monitors through the API with notification_target_ids.
An organization has one Telegram destination. Connecting again updates the existing destination rather than creating a second one.

Group chats

The destination stores a Telegram chat ID. Direct chats have positive IDs and groups have negative IDs, so a group chat is supported as a target.

Events

Troubleshooting

Next steps

Setting Up Alerts

Assign destinations to monitors

Pushover

Push notifications to your phone