Telegram Integration
Send TigerOps alert notifications and AI summaries to Telegram channels and groups. Get instant, rich-formatted incident alerts on mobile with deep links to investigations.
How It Works
Create a Telegram Bot
Message @BotFather on Telegram and use /newbot to create a new bot. Copy the API token BotFather provides — you will need it to connect TigerOps.
Add Your Bot to a Channel or Group
Add your TigerOps bot as an administrator to the Telegram channel or group where you want to receive alerts. Retrieve the chat ID using the Telegram getUpdates API.
Configure TigerOps with Bot Token and Chat ID
Enter the bot API token and target chat ID in the TigerOps Telegram integration panel. TigerOps sends a test message to confirm the bot can post to the channel.
Incidents Arrive as Formatted Telegram Messages
TigerOps posts rich Markdown-formatted alert messages to your Telegram channel with AI summary, severity, service name, and a deep link to the investigation.
What You Get Out of the Box
Rich Markdown Formatting
Telegram messages use Markdown formatting with bold severity labels, service names, metric values, and clickable deep links to TigerOps investigations — readable on mobile.
AI Summary in Every Message
Every alert message leads with a TigerOps AI-generated plain-language summary: what service is affected, what the anomaly is, and what the probable cause is.
Multiple Channel Routing
Route different TigerOps services or severity levels to different Telegram channels. Critical production alerts go to #ops-critical, warnings go to #ops-monitoring.
Resolution Updates
When TigerOps resolves an incident, a follow-up Telegram message is posted with the resolution summary, incident duration, and a link to the postmortem.
Configurable Message Templates
Customize the Telegram message format using TigerOps template variables. Include or exclude specific fields, adjust message length, and control emoji usage.
Severity Filtering
Set a minimum severity threshold per Telegram channel. A general monitoring channel receives all alerts while a critical-only channel receives only P1 incidents.
Telegram Alert Channel Config
Configure bot credentials, chat targets, and message templates for Telegram notifications.
# TigerOps — Telegram Integration Config
integrations:
telegram:
bot_token: "${TELEGRAM_BOT_TOKEN}"
parse_mode: "Markdown"
send_resolution: true
channels:
- chat_id: "${TELEGRAM_CHAT_CRITICAL}"
label: "ops-critical"
min_severity: critical
services: ["*"]
- chat_id: "${TELEGRAM_CHAT_MONITORING}"
label: "ops-monitoring"
min_severity: warning
services: ["api-gateway", "auth-service"]
message_template: |
*[{{severity_upper}}] {{incident_title}}*
*Service:* {{service_name}}
*Environment:* {{environment}}
*Started:* {{started_at}}
*AI Summary:*
{{ai_summary}}
*Metric:* {{metric_name}} = {{metric_value}}
[View in TigerOps]({{tigerops_url}}) | [Trace]({{trace_url}})
resolution_template: |
*RESOLVED: {{incident_title}}*
Duration: {{incident_duration}}
Root cause: {{ai_root_cause}}
[View Postmortem]({{tigerops_url}})Common Questions
How do I find the Telegram chat ID for my channel or group?
After adding your bot to the channel or group, send a message and then call the Telegram Bot API at https://api.telegram.org/bot{YOUR_TOKEN}/getUpdates. The response will include the chat.id for the channel or group. TigerOps also provides a helper tool in the integration panel that retrieves recent chat IDs automatically.
Can TigerOps post to a private Telegram channel?
Yes. As long as your bot is a member and has administrator privileges in the private channel, TigerOps can post to it. The bot requires Send Messages permission at minimum.
Does TigerOps support Telegram bot commands for acknowledgment?
Currently TigerOps sends outbound messages via Telegram and does not process inbound commands. Acknowledgment and incident management must be done via the TigerOps dashboard or other integrated tools. Bi-directional Telegram command support is on the roadmap.
Will the Telegram integration send one message per alert or one per incident?
TigerOps groups related alerts into a single incident before posting. You receive one Telegram message per incident, not one per underlying metric alert. This prevents notification floods during correlated outages.
Is there a rate limit on Telegram messages?
Telegram's Bot API allows up to 30 messages per second globally and 1 message per second per chat. TigerOps queues messages and respects these limits. During burst conditions (many simultaneous incidents), messages may be delivered with a slight delay of a few seconds.
Get Instant Incident Alerts in Telegram
No credit card required. Set up Telegram alerts in minutes. AI summaries in every message.