Configuring Webhooks for Incidents: Notifications to Slack, Telegram, Email

Integrations for real-time incident alerts

What is a webhook?

A webhook is an HTTP request that your monitoring system sends to another service (or your own endpoint) when an event occurs — like a downtime or recovery.

Why set up notifications?

Instant alerts help you respond quickly to issues. You can send messages to:

  • Slack — team channel
  • Telegram — bot or group
  • Email — personal or shared address

1. Slack: configuring a webhook

  1. Go to Slack API and create an app
  2. Add the Incoming Webhooks feature
  3. Enable it and choose a channel
  4. Copy the webhook URL and paste it into the OKchecker dashboard

The webhook will receive incident payloads like:

{
  "event": "incident_triggered",
  "check": "api.myapp.com",
  "status": "down",
  "time": "2025-07-25T12:34:00Z"
}

2. Telegram: alerts via bot

  1. Create a bot with @BotFather
  2. Copy the API token
  3. Get the chat_id (use @get_id_bot if needed)
  4. Enter the token and chat_id in the OKchecker settings

The service will use Telegram Bot API to push messages directly to your chat.

3. Email: the simplest option

Add your email addresses in the alert settings. You'll receive an email on each incident or recovery, with full details and a link to the status page.

4. Webhook payload structure

Webhooks are sent as JSON via POST. Example payload:

{
  "event": "incident_resolved",
  "check": "db-backup",
  "status": "up",
  "duration": "7m 13s",
  "details": "Backup resumed successfully."
}

5. Security tips

  • Always use HTTPS for your webhook endpoints
  • Verify authenticity with a secret token or signature

Conclusion

Webhooks are a powerful way to stay informed about incidents. With integrations for Slack, Telegram, and Email, your team stays in the loop — instantly.

Set Up Notifications