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

> Telegram 机器人是免费、熟悉的自我告警方式。本文完整介绍设置步骤，分析它适用与不便之处：所有通知共用一种提示音、转义规则、URL 中暴露的令牌，以及何时推送 API 是更好的选择。

*08.10.2026*

<!-- source: https://pocketalert.app/zh/blog/telegram-bot-vs-push-notifications -->

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

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

## Telegram 设置全流程

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

```bash
curl -s "https://api.telegram.org/bot$TG_TOKEN/getUpdates" | jq '.result[].message.chat.id'
```

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

4. **发送告警：**

```bash
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](/) 的示例，带有优先级，以及一个打开任务日志的按钮：

```bash
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 告警会覆盖勿扰模式。参见[关键告警](/use-cases/critical-alerts)。
- **无需机器人的按钮。** 最多可添加三个[操作按钮](/features/action-buttons)：打开 URL、调用 HTTP 端点，或复制一个值。点击时不需要任何进程在后台监听。
- **服务可以直接发送。** 每个 [Webhook](/use-cases/webhook-notifications) 都有自己的 URL。GitHub 或 Grafana 发送它们自己的 JSON，像 `%alerts.0.labels.alertname%` 这样的占位符可以把字段填入通知。每次调用都会记录在 [Webhook 历史](/features/webhook-history)中。
- **拥有独立的历史记录。** 告警保存在独立的应用和控制台中，按应用分组，而不是混在你的聊天记录里。

## 什么时候 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 账号](/signup)，发送上面的 curl 命令；或者先阅读[什么是推送通知 API](/blog/what-is-a-push-notification-api)。如果你还在考虑其他方案，[对比中心](/alternatives)涵盖了 Pushover、ntfy、Bark、Gotify 等更多工具。
