Integration Guide

How to Configure Telegram Alerts for Website Downtime

Configure real-time service health notifications and dynamic payload parameters.

Alert Payload Builder

Interactively customize and preview real-time JSON alert cards.

slack
JSON
{
  "blocks": [
    {
      "type": "header",
      "text": {
        "type": "plain_text",
        "text": "🔴 Alert: Production API Gateway is DOWN"
      }
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*Status:*\nService Interrupted"
        },
        {
          "type": "mrkdwn",
          "text": "*Trigger Time:*\n2026-07-10T01:25:36.262Z"
        }
      ]
    },
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*Details:*\n`Response timeout after 10000ms`"
      }
    },
    {
      "type": "context",
      "elements": [
        {
          "type": "mrkdwn",
          "text": "Sent via <https://www.pingzoapp.com|Pingzo Uptime Monitoring>"
        }
      ]
    }
  ]
}
Gated on paid tiers (Starter onwards) for Slack, Discord, MS Teams, and Webhook dispatch channels.

How to Configure Telegram Alerts for Website Downtime

When critical servers crash or database connections drop, you need a failsafe alerting channel that reaches your team instantly. Standard email notifications can be delayed or buried under everyday inbox clutter. Telegram channels and group chats provide an excellent, developer-friendly notification system for real-time downtime alerts.

This guide explains how to configure automated website uptime and server alerts to send directly to your Telegram chat channels using Pingzo.


Why Use Telegram for DevOps Alerting

  • Failsafe Group Alerting: Add your entire on-call developer team to a single Telegram channel so that everyone receives alerts simultaneously.
  • Zero Delay Notifications: Telegram uses lightweight, push-based delivery, ensuring alert payloads arrive within milliseconds of check failures.
  • Custom Bot Payloads: Customize how crash logs and response codes are formatted using rich Markdown or HTML text structures.

Step 1: Create a Telegram Bot

To send alerts, you need to create a dedicated Telegram Bot.

  1. Open the Telegram application on your phone or computer.
  2. Search for @BotFather (the official bot creation utility).
  3. Send the message /newbot to start the bot creation wizard.
  4. Choose a display name and a unique username for your bot (e.g. PingzoAlertsBot).
  5. BotFather will reply with an API Token (a string resembling 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ). Copy this token securely.

Step 2: Retrieve Your Telegram Chat ID or Group ID

To route alerts to the correct conversation, you need to find the Chat ID:

  1. For Private Chats: Message your new bot directly. Then open a browser window and navigate to https://api.telegram.org/bot<YourBotToken>/getUpdates. Look for the "chat":{"id":...} parameter in the JSON response.
  2. For Group Chats: Add your new bot to your DevOps group chat. Send a message to the group referencing the bot (e.g. /test). Navigate to the same getUpdates URL above to locate the negative Group ID number (resembling -1001234567890).

Step 3: Add Telegram Channel in Pingzo

  1. Log in to your Pingzo Dashboard.
  2. Navigate to Alert Profiles -> Create Integration.
  3. Select Telegram as the integration type.
  4. Enter your Bot Token and the Chat ID (or Group ID) you retrieved in Step 2.
  5. Click Test Alert to verify the connection. Pingzo will send a test uptime alert payload to your Telegram channel.
  6. Save the integration and link it to your active monitors.

Your team will now receive instant notifications with response codes and latency details directly in Telegram whenever a service goes down.

Integration Benefits

  • Flat-Rate Dispatching

    Send unlimited notification alerts without dynamic usage costs or subscriber fees.

  • Automated Recoveries

    Pingzo resolves notifications automatically to keep your incident chat clean.

  • SSL Warning Handlers

    Get early warnings 30/14/7 days before certificates expire, right in your alert channels.

Hook your channels now

Link Slack, Discord, MS Teams, Telegram, and official WhatsApp numbers to keep your engineering team aligned.

Start Free Uptime Check