Telegram Integration

PingSLA supports Telegram notifications via bot messages. Alerts can be sent to personal chats, groups, or channels.

Setup: Personal Chat

1. Open Telegram and search for @PingSLABot
2. Start a chat: /start
3. The bot will display your Chat ID
4. In PingSLA: Settings → Notification Channels → New Channel → Telegram
5. Enter the Chat ID
6. Click Test to confirm

Setup: Group or Channel

For team notifications, add the bot to a group or channel:

Group Setup

1. Add @PingSLABot to your Telegram group
2. Send any message in the group to wake the bot
3. Get the Chat ID by running /id in the group
4. Enter the Chat ID in PingSLA (group IDs are negative, e.g., -1001234567890)

Channel Setup

1. Create or open your Telegram channel
2. Add @PingSLABot as an administrator (requires "Post Messages" permission)
3. Get the channel username or ID
4. Enter in PingSLA (format: @yourchannelname or -100xxxxxxxxxx)

Chat ID Format

Target	ID Format	Example
Personal chat	Positive integer	123456789
Group	Negative integer	-123456789
Supergroup	Negative with 100 prefix	-1001234567890
Channel username	@name	@ops_alerts

Notification Format

🔴 INCIDENT ALERT — PingSLA

Monitor: Production API Health
Status:  DOWN
Reason:  HTTP 503 Service Unavailable
Time:    2026-05-18 14:32 UTC

🔗 https://app.pingsla.com/incidents/inc_xxx

✅ RECOVERED — PingSLA

Monitor: Production API Health
Status:  UP
Downtime: 4m 22s
Time:    2026-05-18 14:36 UTC

🔗 https://app.pingsla.com/incidents/inc_xxx

Troubleshooting

Issue	Cause	Resolution
Bot doesn't respond	Bot not started	Send /start to the bot first
No messages in group	Bot not in group	Add @PingSLABot to the group
Wrong Chat ID	ID copied incorrectly	Use /id command in the group/chat
Channel not receiving	Bot not admin	Make bot an admin with post permission
Test passes, incidents don't	Alert policy not attached	Verify monitor has a policy with this channel