本文仅提供英文版。

告警与通知

Telegram alerts with a bot

Create a Telegram bot with BotFather, find your chat ID and receive FastPing alerts in a private chat, group or channel.

最后更新:阅读约需 2 分钟

Create a bot

  1. In Telegram, open a chat with @BotFather and send /newbot.
  2. Choose a display name and a username ending in bot.
  3. BotFather replies with a token such as 123456789:AAH…. Keep it secret: it controls the bot.

Use a dedicated bot for FastPing rather than one that other software also uses.

Find the chat ID

  1. Start the conversation the alerts should go to: open a private chat with your bot and send /start, or add the bot to a group, or add it to a channel as an administrator allowed to post messages.
  2. Send a message in that chat. In a group, send a command addressed to the bot, such as /start@your_bot, so the bot receives it.
  3. Open https://api.telegram.org/bot<token>/getUpdates in your browser, with your token in place of <token>, and find "chat":{"id":…} in the response.

Private chats have positive IDs. Groups and channels have negative IDs; supergroups and channels start with -100. For a public channel you can enter its username instead, such as @example_status.

Add it to FastPing

In the dashboard, open Alert channels, choose the type Telegram, enter the chat ID (or @channelname) and the bot token, click Add channel and then Send test. Alerts arrive as plain messages: the headline (for example Down: Shop), the check's message and a link to the monitor.

Troubleshooting

MessageWhat it meansWhat to do
That destination does not look valid for this channel type.The chat ID is not a number or an @username.Copy the ID again from getUpdates, including a leading minus sign.
Enter the bot token that @BotFather gave you: digits, a colon, then letters and numbers.The token is not in the form 123456789:ABC….Copy it again from BotFather; do not include the word "bot" before the token.
Test failed: Telegram HTTP 400Telegram rejected the message, usually because the chat ID is wrong or the bot is not a member of the chat.Check the ID with getUpdates and add the bot to the group or channel.
Test failed: Telegram HTTP 401The bot token is wrong or was revoked.Get the current token from BotFather (/token).
Test failed: Telegram HTTP 403The bot cannot write to the chat: it was removed, blocked, or is not an administrator of the channel.Add the bot again, unblock it, or give it permission to post.

还需要帮助?

给我们写信,会有真人回复,通常在一个工作日内。