How to Set Up Telegram Notification Channel

This guide explains how to configure Telegram as a notification channel in Pinghome to receive incident alerts, system notifications, and verification codes.
Setup Steps
1

Create a Bot

Open Telegram and message @BotFather. Send /newbot, follow the prompts, and copy the bot token.
2

Set the Webhook

Configure your bot to forward messages to your Pinghome instance:
https://api.telegram.org/bot<TOKEN>/setWebhook?url=<YOUR_WEBHOOK_URL>/v1/telegram/webhook
3

Start the Bot

Search for your bot in Telegram and send /start. The bot will reply with your Chat ID and setup instructions.
4

Add the Channel

In the Pinghome console, create a new notification channel with type telegram and paste your Chat ID as the value.
5

Verify

A verification code will be sent to your Telegram chat. Enter the code in the console to complete setup.
Troubleshooting
🔢Wrong Chat ID?

Verify your Chat ID by running:

curl -s "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates"

Group Chat IDs are negative numbers (e.g., -1001234567890).

🌐Network error?

Ensure outbound HTTPS connections to https://api.telegram.org are allowed.