Telegram Integration

Step 1

Start a Chat with UptimeGuardBot

Open Telegram and search for @UptimeGuardBot, or visit t.me/UptimeGuardBot. Tap Start to initialize the bot. You'll receive a welcome message with a unique Integration Token (looks like ug-tg-8f3a2c…).

Step 2

Open Your UptimeGuard Dashboard

Log in to your UptimeGuard account and navigate to Settings → Integrations → Telegram. Click Connect New Chat to open the configuration panel.

Step 3

Paste the Integration Token

Copy the token from your Telegram chat and paste it into the field in the dashboard. Click Verify & Link. UptimeGuard will send a confirmation message to your chat within 10 seconds.

Step 4

Assign Monitors to the Chat

Go to any monitor in your dashboard, open Alert Channels, and check the Telegram toggle. You can assign individual monitors, entire groups, or set Telegram as the default channel for all new monitors.

/status

Returns a formatted list of all monitors assigned to this chat with current state (● Operational, ● Down, ● Degraded) and last-check timestamp. Example output:

api.example.com — ● Operational (last check: 14:23:01 UTC)
shop.example.com — ● Down (since 14:18:42 UTC, 3rd incident today)

/logs <monitor-name>

Fetches the last 10 check results for a specific monitor, including response time, HTTP status code, and SSL expiry days. Use /logs api.example.com to drill into a single endpoint.

/pause <monitor-name>

Temporarily disables alerts for the specified monitor. Useful during planned maintenance windows. The monitor continues health-checking but suppresses notifications for 2 hours by default. Extend with /pause api.example.com 6h.

/resume <monitor-name>

Restores alerting for a paused monitor immediately. A confirmation message is sent to the chat.

/chatid

Returns the numeric chat ID of the current conversation. Required when linking a group chat in the UptimeGuard dashboard.

/help

Displays the full command reference with examples and links to the documentation. Updated automatically when new commands are added.

Can I link multiple Telegram chats to one UptimeGuard account?

Yes. Each account can connect up to 10 distinct Telegram chats (private or group). Assign different monitors to each chat to route alerts by team or severity level.

Do I receive notifications on every health check?

No. By default, Telegram alerts fire only on state changes: up → down, down → up, or SSL certificate expiry warnings (30, 7, and 1 day before expiry). You can enable "all checks" mode in Settings → Integrations → Telegram → Verbose Mode for debugging.

What happens if the bot is blocked or the chat is deleted?

UptimeGuard retries delivery for 24 hours. If the chat becomes unreachable, you'll receive an email alert at your account's primary address. Re-link the chat from the dashboard to restore notifications.

Is there a rate limit on Telegram messages?

Telegram allows up to 30 messages per second per bot. UptimeGuard batches and deduplicates events, so even during a large-scale outage you won't exceed this limit. Critical incidents always bypass throttling.

Can I use the bot with Telegram Business or Telegram Desktop?

Yes. The bot works across all Telegram clients — mobile (iOS/Android), desktop, web, and Telegram Business. Notifications are delivered identically on every platform.

Does the free plan include Telegram integration?

Telegram integration is available on all plans, including the free tier (up to 3 monitors, 1 chat). The Pro and Enterprise plans support up to 10 chats, custom alert templates, and incident runbook links in notification buttons.