Telegram Integration
VantaStatus Telegram Bot
Get real-time uptime alerts and status updates delivered straight to your chat. Configure notifications for your monitored endpoints in under two minutes.
Configuration
Setup Guide
Link your VantaStatus account to the official Telegram bot in four steps. Once connected, the bot forwards every state change, recovery, and scheduled maintenance window to your chosen chat.
1
Open Telegram and search for @VantaStatusBot. Tap Start or send /start. The bot replies with a unique 32-character binding token.
2
Log into your VantaStatus dashboard at app.vantastatus.io. Navigate to Settings → Integrations → Telegram and paste the binding token into the Bot Token field.
3
Select which monitored endpoints should trigger notifications. You can choose individual checks (e.g., api.example.ru, cdn.example.ru) or enable "All endpoints" for full coverage.
4
Set your alert thresholds. Default is 3 consecutive failed pings before an alert fires. Adjust the cooldown window (5–30 min) to suppress flapping on unstable links.
Bot Commands
Available Commands
Control your monitoring experience directly from Telegram. All commands respond within one second and require an active binding to your dashboard account.
/start
Initialize the bot session and receive your binding token. Re-run to reset an expired token or switch to a different VantaStatus account.
/status
Request a live summary of all monitored endpoints. The bot returns a formatted table with endpoint name, current state (UP / DOWN / DEGRADED), last check timestamp, and response time in milliseconds.
/alerts <endpoint>
Toggle alerting for a specific endpoint. Example: /alerts api.example.ru enables notifications; /alerts api.example.ru off disables them. Changes sync to the dashboard instantly.
/mute <minutes>
Pause all incoming notifications for the specified duration (1–1440 minutes). Useful during planned maintenance windows. The bot confirms the mute period and auto-resumes afterward.
/bind <token>
Manually link a binding token if the automatic handshake fails. The token must match an active session in your VantaStatus dashboard; otherwise the bot returns a 403 error.
/help
Display the full command reference with usage examples. Also shows your current binding status, the last 5 alert events, and a direct link to your dashboard profile.
Notification Format
Message Formatting
Every alert follows a consistent structure so you can scan critical information at a glance. The bot uses Telegram MarkdownV2 for bold labels, monospaced values, and inline code blocks.
Alert Header
Each message begins with a severity tag — 🔴 CRITICAL, 🟡 WARNING, or 🟢 RECOVERED — followed by the endpoint hostname and the UTC timestamp of the first failed check.
Body Details
The body includes the probe type (HTTP, TCP, DNS, ICMP), expected vs. actual response code or status, measured latency, and the originating probe node (e.g., MOW-01, SPB-03, VLAD-02).
Inline Actions
Critical alerts include an inline keyboard with two buttons: View Dashboard (opens the endpoint detail page in your browser) and Dismiss (marks the alert as acknowledged in your account log).
Digest Mode
Enable daily digests in dashboard settings to receive a single nightly summary instead of real-time pings. The digest aggregates all state changes from the past 24 hours, grouped by endpoint, with uptime percentages and mean response times.