返回博客

Telegram 机器人通知 vs 推送通知 API:开发者告警怎么选

Telegram 机器人通知 vs 推送通知 API:开发者告警怎么选

让一群开发者说说他们怎么收到脚本的告警,一半人会回答"用 Telegram 机器人"。它免费,Telegram 本来就装在手机上,第一条消息十分钟就能接通。

但这其实是让聊天应用来做寻呼机的工作。平时没问题,直到真正重要的告警和群聊混在同一个消息流里,或者某个带下划线的文件名把消息格式搞坏。本文会如实走一遍 Telegram 的设置流程,说明它在哪些地方好用、哪些地方不好用,并展示同一条告警通过推送通知 API 发送是什么样子。

Telegram 设置全流程

  1. 创建机器人。 给 @BotFather 发送 /newbot,设置名称和以 bot 结尾的用户名。你会得到一个类似 110201543:AAH... 的令牌。
  2. 先打个招呼。 机器人不能主动发起对话,所以先打开机器人并发送任意消息。如果要用于群组,把机器人加入群组即可。
  3. 获取聊天 ID。 调用 getUpdates,从结果中读取 message.chat.id:
curl -s "https://api.telegram.org/bot$TG_TOKEN/getUpdates" | jq '.result[].message.chat.id'

更新记录只保留 24 小时,而且一旦为机器人设置了 Webhook,getUpdates 就无法使用。群组 ID 是负数,超级群组的 ID 以 -100 开头。

  1. 发送告警:
curl -s "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \
  -d chat_id="$TG_CHAT_ID" \
  -d text="Backup failed on db-01"

整个集成就这些:环境变量文件里放两个密钥,外加一次 HTTP 调用。

Telegram 的优势

  • 零成本。 Telegram 官方 FAQ 写明,机器人可以免费给用户发消息。
  • 随处可用。 手机、桌面和网页客户端,数据全部同步。
  • 群组免费。 把机器人加入团队群,所有人都能看到告警,并能在同一个话题里讨论。
  • 你本来就打开着它。 不需要新应用,也不需要新账号。

对于"每晚报告已生成"这类低风险通知,它很难被超越。

不便之处

所有告警听起来都一样

Bot API 只有一个投递控制选项:disable_notification,它会让消息静音发送。没有优先级,没有时效性等级,也没有任何能穿透勿扰模式的设置。凌晨 3 点的备份失败告警和群聊里的一张贴纸,到达方式完全相同。如果你为了避开噪音把群聊设为静音,告警也会一起被静音。

格式问题会频繁出错

使用 parse_mode=MarkdownV2 时,字符 _ * [ ] ( ) ~ > # + - = | { } . ! 以及反引号,只要不在格式标记内,都必须用反斜杠转义。告警内容里充斥着这些字符:文件名、版本号、URL、堆栈跟踪。db-01.internal 中一个没转义的点号,就会让 Telegram 返回 400 错误,于是报告失败的这条告警本身也发不出去。HTML 模式相对安全,但你仍然需要对发送的所有内容转义 <、> 和 &。

令牌就是机器人本身

令牌放在每个请求的 URL 路径里。Telegram 文档也说得很直白:任何拿到令牌的人都能控制你的机器人。实际上,这个 URL 会出现在 shell 历史、CI 日志,以及各种记录请求 URL 的地方。一旦泄露,只能在 BotFather 里用 /token 重新生成,然后所有脚本都得更新。

按钮需要一个在线的机器人

内联按钮可以打开 URL,这没问题。但如果按钮要执行某个操作,比如"重启服务",就需要用到 callback_data,而在你的机器人回应之前,点击后会一直转圈。这意味着要有一个全天候监听更新的进程,而定时任务通常不想承担这种负担。

突发消息触发速率限制

Telegram 要求机器人每个聊天每秒不超过一条消息,群组中每分钟不超过 20 条。如果把一个话多的 Webhook 指向群组,就会收到带 429 Too Many Requests 字段的 retry_after,而恰恰是出问题、告警最密集的时候。

服务无法直接发送

GitHub、Stripe、Grafana 和 Sentry 发送的 Webhook 都是各自的 JSON 格式。Bot API 要的是 chat_id 和 text。中间必须有人负责转换:一个小型服务器、一个无服务器函数,或者一个 n8n 或 Zapier 流程。这个中继又是一个需要持续维护的东西。

告警沉在聊天工具里

机器人消息就是普通的 Telegram 聊天消息,由 Telegram 存储,并和你的私人聊天混在一起。要查找上个月的事故,你得在聊天记录里翻找,而不能按来源筛选历史。

同一条告警通过推送 API 发送

下面是把备份告警发送到 Pocket Alert 的示例,带有优先级,以及一个打开任务日志的按钮:

curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Backup failed",
    "message": "db-01.internal: pg_dump exited with code 1",
    "level": "high",
    "actions": [{ "type": "view", "label": "Open log", "value": "https://ci.example.com/jobs/4821" }]
  }'

区别在于:

  • 一个密钥,放在请求头里。 API 密钥放在 Token 请求头中,而不是 URL 中的令牌加上聊天 ID。
  • 纯文本进,纯文本出。 没有转义规则。点号、下划线和括号都会原样到达。
  • 每条消息都能设置优先级。 可选 silent、low、default、high 或 critical。在 iPhone 上,high 和 critical 会以时效性通知的形式穿透专注模式;在 Android 上,critical 告警会覆盖勿扰模式。参见关键告警。
  • 无需机器人的按钮。 最多可添加三个操作按钮:打开 URL、调用 HTTP 端点,或复制一个值。点击时不需要任何进程在后台监听。
  • 服务可以直接发送。 每个 Webhook 都有自己的 URL。GitHub 或 Grafana 发送它们自己的 JSON,像 %alerts.0.labels.alertname% 这样的占位符可以把字段填入通知。每次调用都会记录在 Webhook 历史中。
  • 拥有独立的历史记录。 告警保存在独立的应用和控制台中,按应用分组,而不是混在你的聊天记录里。

什么时候 Telegram 仍然是更好的选择

客观地说:

  • 预算有限、消息量大。 Telegram 免费,除了速率限制之外没有每日配额。Pocket Alert 的免费套餐每天 50 条消息,更多则需要付费套餐,每月 6 美元起。
  • 需要引发对话的告警。 如果目的是让团队在告警出现的地方展开讨论,群聊可以做到,推送通知做不到。
  • 以桌面和网页为主。 如果你整天使用笔记本电脑,Telegram 桌面客户端会在你本来就会看的地方显示告警。Pocket Alert 的应用面向 iPhone 和 Android,历史记录则通过网页控制台查看。

许多团队采用的一种组合方式是:保留一个 Telegram 群用于日常交流和每日摘要,凡是需要叫醒某个人的告警,都以带等级的推送通知发送。

常见问题

Telegram 机器人消息能绕过勿扰模式吗?

从机器人这一侧看不能。Bot API 没有优先级设置,只有 disable_notification 可以让消息静音。在 iPhone 上要穿透专注模式,唯一的办法是让接收者把 Telegram 加入应用例外,但这会让所有 Telegram 通知都能穿透,而不只是告警。

如何找到我的 Telegram 聊天 ID?

先给你的机器人发送任意消息,然后调用 https://api.telegram.org/bot<token>/getUpdates,读取 message.chat.id。如果结果为空,可能是更新记录超过了 24 小时,或者机器人设置了 Webhook,而设置 Webhook 后 getUpdates 无法使用。

为什么我的 Telegram 告警返回 400 错误?

通常是 MarkdownV2 或 HTML 模式下有未转义的字符。去掉 parse_mode 以纯文本发送,或者在发送前转义所有保留字符。

推送通知 API 比 Telegram 机器人更难设置吗?

差不多。使用 Pocket Alert,你只需安装应用,从控制台复制一个 API 密钥,然后发送一次 POST 请求。不需要查找聊天 ID,也不需要创建机器人。

能同时发送到两者吗?

可以。许多团队用 Telegram 进行讨论,而把需要响应的告警以推送形式发送。一个脚本可以同时调用两个 API,而且大多数发送 Webhook 的服务都支持配置多个 URL。

注册免费的 Pocket Alert 账号,发送上面的 curl 命令;或者先阅读什么是推送通知 API。如果你还在考虑其他方案,对比中心涵盖了 Pushover、ntfy、Bark、Gotify 等更多工具。

分享这篇文章