Types
Telegram
Send incident and maintenance alerts to Telegram chats via bot token + chat ID.
Send real‑time incident, maintenance, and recovery notifications to a Telegram group or channel using a bot.
Setup
- Open Telegram and start a chat with
@BotFather. - Use
/newbotto create a bot; copy the HTTP API token. - Add the bot to the target group (or keep a 1:1 chat for personal alerts).
- Obtain the chat ID:
- Easiest: send a message in the chat, then use a tool / simple curl call to
https://api.telegram.org/bot<token>/getUpdatesand locatechat.id.
- Easiest: send a message in the chat, then use a tool / simple curl call to
- In Garmingo: Create Telegram integration → paste Bot Token + Chat ID.
- Save & trigger a test (or simulate a monitor outage).
Message Format
| Field | Content |
|---|---|
| Title | Event / Incident summary |
| Body | Affected monitors / status change |
| Link | Direct link to status page or incident detail |
Messages are kept terse to avoid noise—actionable first line, optional details below.
Hardening Tips
- Rotate the bot token if compromised via BotFather
/revoke. - Use a dedicated private channel for production alerts.
- Restrict who can invite the bot.
Troubleshooting
| Issue | Cause | Fix |
|---|---|---|
| 401 / Unauthorized | Invalid or revoked token | Regenerate via BotFather |
| No messages | Wrong chat ID | Re-run getUpdates after sending a test message |
| Duplicates | Multiple integrations targeting same chat | Consolidate to one |