Telegram Integration
Connect UptimeGuard to your team's Telegram group in under two minutes. Get instant alerts, check status, and manage monitors — all from the chat you already use.
UptimeGuard — Availability monitoring for Russian IT teams
Step-by-Step Bot Setup
Follow these four steps to add the UptimeGuard bot to your Telegram group. The bot works in both private chats and group channels, so you can notify an entire DevOps squad at once.
1. Launch the Bot
Open t.me/UptimeGuardBot in Telegram and tap Start. The bot replies with a unique 40-character API token — save it somewhere safe, you'll need it in the next step.
2. Add to Your Group
Go to your target group's settings → Administrators → Add Administrator, search for @UptimeGuardBot, and grant it Send Messages and Pin Messages permissions only. The bot does not need full admin rights.
3. Link in UptimeGuard Dashboard
Log in to your UptimeGuard account, navigate to Settings → Notification Channels → Telegram, paste the token from Step 1, and click Verify Connection. A green checkmark confirms the link.
4. Assign Monitors
Open any monitor card (for example, api.paymentcore.ru or db-backup.internal), go to the Alerts tab, and toggle the Telegram channel on. Choose severity threshold — we recommend Critical and Warning for production monitors.
Message Formatting
Every alert the bot sends follows a consistent template so your team can scan it in under three seconds. You can customise the template in the dashboard to match your internal runbook.
Default alert template:
[ALERT] <monitor-name> — Status: <HTTP code / Timeout / DNS Failed> | Duration: <MMm SSs> | Last OK: <timestamp, UTC+3> | Details: <short error summary>
Recovery template:
[RECOVERED] <monitor-name> — Back online after <downtime total> | Downtime today: <count> incidents | Uptime (24h): <percentage>%
To enable monospace code blocks for URLs and stack traces, toggle the Use code formatting switch under Settings → Notification Channels → Telegram → Formatting. Digest reports (sent hourly or daily) use bold headers and bullet lists so they remain readable even in noisy channels.
Example digest (daily, 06:00 MSK):
UptimeGuard Daily Report — 24 monitors
✓ 22 monitors: 100% uptime
⚠ 1 monitor: cdn.static-assets.ru — 99.7% (2 brief DNS flaps)
✕ 1 monitor: staging.deploy.internal — 94.1% (planned maintenance window, 3h 12m)
Chat Commands
Once the bot is added to your group, any member can query monitor status directly from the chat. No dashboard login required — perfect for war rooms and incident bridges.
/status
Lists all monitors linked to this chat with their current state. Example output: [OK] api.paymentcore.ru — 200 OK (42ms), [DOWN] db-backup.internal — Timeout (180s).
/status <name>
Returns detailed status for a single monitor. Includes last check timestamp, response time, certificate expiry (for HTTPS monitors), and the next scheduled check. Try /status api.paymentcore.ru.
/pause <name>
Temporarily suspends checks for the named monitor. Useful during deployments. Paused monitors appear as [PAUSED] in /status output. Unpause with /resume <name>.
/unpause <name>
Resumes monitoring for a previously paused monitor. The bot confirms with [RESUMED] <name> — next check in 60s.
/uptime <name> <period>
Shows uptime percentage for a specific period. Supported periods: 24h, 7d, 30d. Example: /uptime api.paymentcore.ru 7d → 99.94% (1 incident, 4m 12s total downtime).
/mute
Silences all bot messages in this chat for 15 minutes (useful during bulk configuration). Override with /unmute. Only group admins can mute.
All commands respond within 2 seconds. If a monitor is unreachable, the bot returns [UNREACHABLE] — check failed, retrying in 30s. Command history is retained for 90 days and can be exported from the dashboard under Activity Log → Telegram Commands.