Telegram Integration
Connect @PingSledBot to your Telegram account and receive instant uptime alerts, daily digests, and downtime reports directly on your phone — no email required.
Bot Setup
PingSled's official Telegram bot, @PingSledBot, connects to your account in under a minute. Once linked, every status change — from the first packet loss to full recovery — arrives as a push notification on your device.
Open Telegram and search for @PingSledBot, then tap Start. The bot will reply with a unique authorization code. Paste that code into the Integrations → Telegram tab of your PingSled dashboard to complete the handshake. The entire flow takes roughly 45 seconds and requires no API keys or webhook configuration.
1. Launch the Bot
Open @PingSledBot in Telegram and send /start. The bot responds with a 12-digit auth token valid for 10 minutes.
2. Link Your Account
Navigate to Settings → Integrations → Telegram in your PingSled dashboard. Enter the auth token and confirm. Your account ID is automatically bound to your Telegram user ID.
3. Choose Alert Scope
Select which monitors trigger notifications. You can opt into all monitors, pick individual endpoints, or create named alert profiles like Production and Staging.
Groups & Channels
Share monitoring responsibility across your team by adding @PingSledBot to a Telegram group or forwarding alerts to a dedicated channel. Every member sees the same real-time status without duplicating monitors.
Add the bot as an administrator in any group with 2–200 members. Use the /group-join command inside the chat to bind it to your PingSled account. You can then assign a notification tier — Critical only, Critical + Warning, or All events — so your #ops-war-room channel stays focused while your #dev-updates channel gets the full picture.
Incident Channels
Create a private Telegram channel and add @PingSledBot as a member. The bot posts structured incident cards with endpoint name, response time, error code, and a direct link to the PingSled incident timeline.
Role-Based Filters
Assign different alert tiers to different groups. Your on-call team's group receives every 503 and timeout; the broader engineering group receives daily summaries and weekly availability reports only.
Mute Windows
Schedule maintenance windows directly from Telegram. Send /mute 02:00–04:00 UTC to suppress alerts for a rolling 2-hour window, repeated weekly. The bot confirms the schedule and lists affected monitors.
Inline Commands
Check endpoint health on the fly without leaving Telegram. Use inline queries or slash commands to pull live metrics, trigger one-off pings, and manage monitors from any chat.
Type @PingSledBot followed by a URL in any chat — for example, @PingSledBot api.example.com — and the bot replies with the current response time, HTTP status, and last 24-hour uptime percentage. No need to open the dashboard or switch contexts mid-incident.
/status
Returns a compact table of all active monitors with their current state, latest response time in milliseconds, and time since last check. Refreshes live data on every invocation.
/ping <host>
Triggers an immediate ICMP and HTTP check against the specified host. Results are posted within 3 seconds, including TTL, packet loss, and TLS certificate expiry days.
/add <url> <interval>
Registers a new monitor from Telegram. Example: /add https://shop.example.com 60s creates a 60-second interval HTTPS monitor with default alerting enabled.
/remove <id>
Deletes a monitor by its PingSled monitor ID. The bot asks for confirmation and shows the monitor name before deregistering it.
/report <period>
Generates a markdown availability report for the requested period — 1h, 24h, 7d, or 30d. Includes uptime percentage, mean response time, and a list of all incidents with timestamps.
/help
Displays the full command reference with examples, current notification tier settings, and a link to revoke or re-link your Telegram account.