How to Set Up Telegram Alerts for Webhook Failures
Get instant Telegram notifications when your webhooks, cron jobs, or WebSocket connections fail. Connect in under a minute — no chat IDs to copy.
HookWatch Team
March 24, 2026
When a webhook delivery fails at 3 AM, you need to know immediately — not when you check the dashboard over morning coffee. HookWatch now supports Telegram alerts, so you can get notified the moment something breaks, right in the messaging app you already have open.
Why Telegram?
Telegram has become the go-to notification channel for engineering teams. It's fast, reliable, available on every platform, and — critically — it supports bots that can push messages to private chats and group channels without any setup friction.
Unlike email alerts that get buried in your inbox, or Slack webhooks that require workspace admin permissions, Telegram alerts land instantly on your phone with a push notification. No noise, no delay.
How It Works
HookWatch runs its own Telegram bot. You don't need to create a bot or manage tokens — just connect your Telegram chat to an alert and you're done. Here's the flow:
Dashboard → Create Alert → Select Telegram → Click Connect
→ Opens HookWatch bot in Telegram → Send /start
→ Chat linked → Alerts flow to your chatThis works for both private chats (your personal DMs with the bot) and group chats (add the bot to a team channel).
Step-by-Step Setup
1. Create a Telegram Alert
Go to the Alerts page in your HookWatch dashboard and click Create Alert.
- Alert Type: Select
Telegram - Module: Choose what you want to monitor — Webhooks, WebSocket, or Cron
- Resource: Optionally scope the alert to a specific endpoint or job
Click Create. A connection modal will appear automatically.
2. Connect Your Telegram Chat
The modal shows a link like t.me/HookWatchBot?start=. Click it — Telegram opens and you'll see the HookWatch bot.
For private chats: Just click the link. The bot receives your chat ID automatically.
For group chats:
- Add
@HookWatchBotto your group - Send the
/startcommand shown in the modal - The bot confirms the connection
The dashboard updates automatically once the chat is linked. The link expires in 15 minutes for security.
3. You're Done
That's it. When a delivery fails, your Telegram will light up:
Alert: Webhook Delivery Failed
Endpoint: Stripe Payment Events
Event ID: evt_abc123
Status: failed
Retry Count: 3
Error: Connection refused
Time: 2026-03-24T14:32:00ZCustom Templates
You can customise the alert message template when creating or editing the alert. Templates support variables like {endpoint_name}, {event_id}, {status}, {error}, and {timestamp}. Telegram alerts use HTML formatting — bold text wraps in tags.
Monitoring Multiple Services
Create separate Telegram alerts for different modules:
- Webhook failures → Send to your
#webhook-alertsgroup - Cron job failures → Send to your personal chat
- WebSocket disconnections → Send to your
#infra-alertsgroup
Each alert can target a different Telegram chat, so you can route notifications to the right people.
What About Existing Alerts?
If you already have Telegram alerts with a manually entered Chat ID, they continue to work. The new connect flow just makes setup easier — no more digging through Telegram API docs to find your chat ID.
You can also use the Reconnect button in the edit modal to re-link an alert to a different chat.
Supported Alert Channels
Telegram joins HookWatch's existing alert channels:
| Channel | Best For |
|---|---|
| Formal notifications, audit trails | |
| Slack | Team channels with rich formatting |
| Discord | Community or dev team channels |
| Telegram | Fast mobile push, group chats, personal alerts |
Get Started
Head to your [HookWatch dashboard](https://app.hookwatch.dev/alerts) and create your first Telegram alert. The whole setup takes less than a minute.