Telegram Bot for Uptime Alerts
Get real-time incident notifications and status reports straight into your Telegram chat — with second-level precision.
Connect Telegram to Pulsely in Three Steps
Create a bot, grab your chat ID, and paste both into Pulsely. You will be sending incident alerts within five minutes.
Create a Bot via BotFather
Open Telegram, search for @BotFather, and send /newbot. Follow the prompts to choose a display name (e.g., "Pulsely Monitor") and a username ending in bot (e.g., pulsely_status_bot). BotFather will reply with an HTTP API token like 714820391:AAHxR3kLmNqP7sT0vUyWz. Copy that token — you will need it in the next step.
Find Your Chat ID
Message your new bot with any text (for example, /start). Then open https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates in a browser. Look for the "chat":{"id":123456789} field — that numeric value is your chat ID. If you want alerts in a group channel, add the bot as an administrator and use the group's ID (it will start with -100).
Add the Integration in Pulsely
Go to Settings → Integrations → Telegram in your Pulsely dashboard. Paste the BotFather token and the chat ID, then click Verify Connection. Pulsely will send a test message to confirm everything works. Toggle Active and select which monitors should trigger Telegram alerts.
Bot Commands for Status Checks
Once connected, your bot responds to slash commands so you can query monitor status without opening the dashboard.
/status
Returns a summary of every monitored endpoint: name, current state (Up / Degraded / Down), last check timestamp, and uptime percentage for the past 24 hours. Example: api.pulsely.io — Up — 99.97% — last checked 14s ago.
/ping <name>
Triggers an immediate check on a specific monitor identified by its display name or slug. The bot replies within two seconds with the HTTP status code, response time in milliseconds, and a pass/fail verdict.
/incidents
Lists the five most recent incidents with their start time, severity level, affected monitor, and resolution status. Useful for quick handoff during on-call rotations.
/mute <name> <duration>
Pauses Telegram alerts for a single monitor for a specified window (e.g., /mute api.pulsely.io 30m). Useful during planned maintenance windows so your chat stays quiet.
/uptime <name>
Shows a detailed uptime breakdown for one monitor: 7-day, 30-day, and 90-day percentages, total downtime in minutes, and a list of every incident with timestamps.
/help
Prints a quick reference card with all available commands, their syntax, and an example for each. Always the first command to try when you are unsure.
Alerts That Arrive Where You Already Work
No extra apps, no email clutter. Pulsely pushes to the chat you open hundreds of times a day.
Under 2 Seconds to Delivery
Pulsely checks every monitor at configurable intervals (as fast as every 10 seconds). When a failure is detected, the Telegram webhook fires immediately — your phone buzzes before most email providers finish sending.
Retry Logic Built In
If Telegram's API returns a temporary error, Pulsely retries up to three times with exponential backoff (5 s, 15 s, 45 s). Every retry is logged in the incident timeline so you can audit delivery.
One Bot, Many Channels
Forward alerts to a personal chat for solo developers, a project group for a small team, or a broadcast channel with 200+ subscribers. The same token and configuration work everywhere — just change the chat ID.