通知与 Telegram 配置
双域通知说明，以及用 BotFather 创建机器人、获取 chat_id、在系统通知/通知设置中绑定并试发。
Adswds Platform 支持运维通知：许可将到期、域名异常等事件可通过 Telegram 投递。运营侧与账号侧均可另配 Webhook（URL + 可选签名），与 Telegram 可单独或同时启用。Webhook 对接说明见 通知与 Webhook 配置。
两套配置，互不影响
| 运营后台「系统通知」 | 控制台「系统管理 → 通知设置」 | |
|---|---|---|
| 谁用 | 平台运营侧 | 本账号管理员 |
| 收到什么 | 运营侧告警 | 本账号相关告警 |
| Telegram | 填运营群/号的 Bot Token 与 Chat ID | 填本账号自己的 Bot Token 与 Chat ID |
| Webhook | 运营侧接收 URL（可选签名） | 本账号接收 URL（可选签名） |
| 通知语言 / 模板 | 系统一份；只影响运营系统通知 | 每账号一份；只影响本账号通知设置 |
| 停用或到期账号 | — | 该账号相关通知不发送 |
同源事件可同时 fan-out 到两边；一边未配置或未开启时，另一边仍可单独投递。同一侧也可同时开 Telegram 与 Webhook。
通知事件
- 许可将到期：按运营配置的提前天数提醒
- 域名异常：域名探测失败或证书申请/更新失败
- 其他事件以各端通知设置页的列表为准（如账号侧「每日域名健康」、运营侧「系统健康简况」等）
事件可按开关启用；未绑定可用的 Telegram / Webhook、总开关关闭（系统侧）、或账号不可用时，对应路径不发送。
通知语言与消息模板
- 通知语言（
zh/en/ja，默认中文）：决定正文语言，与控制台界面语言相互独立 - 消息模板：可按事件编辑标题与正文；支持
{{变量}}占位（页面有提示） - 编辑与「恢复默认」只作用于当前通知语言；切换语言不会清空其它语言已保存的覆盖
- 留空则使用该语言的内置默认文案
配置 Telegram 机器人
运营后台与控制台填写字段相同：Bot Token + Chat ID。可共用一个机器人，也可分开建两个。
1. 用 BotFather 创建机器人
- 在 Telegram 搜索并打开官方 @BotFather（带认证标记）
- 发送
/newbot，按提示填写显示名与用户名（用户名须以bot结尾） - 创建成功后，BotFather 会返回一串 HTTP API token——这就是要填入产品的 Bot Token
- 勿把 token 发到公开群或截图外传；泄露后可在 BotFather 用
/revoke作废并换新
Bot Token 格式（务必完整）
- 完整格式为
数字ID:密钥，例如7123456789:AAH... - 冒号前后都必须保留，缺一不可
- 不要在前面加
bot前缀（产品会自行拼接到 API 路径） - 不要粘贴完整的
https://api.telegram.org/bot...URL；只填 token 本身 - 若只填冒号后半段（缺数字 ID），调用 Telegram 时会得到 HTTP 404 Not Found
校验 Token 是否可用
在终端执行（把 <TOKEN> 换成完整 token）：
curl https://api.telegram.org/bot<TOKEN>/getMe返回 JSON 中 "ok": true 即表示 token 有效。
2. 获取 Chat ID
发给个人（私聊）
- 在 Telegram 里搜索你的机器人，点 Start 或发任意消息（机器人必须先收到过你的消息）
- 浏览器打开（把
<BOT_TOKEN>换成真实 token）：
https://api.telegram.org/bot<BOT_TOKEN>/getUpdates- 在返回的 JSON 里找到
"chat":{"id": ...}，该数字即为 Chat ID（私聊一般为正数）
发到群组 / 超级群
- 把机器人拉进目标群
- 在群里发一条消息（若
getUpdates一直为空，可到 BotFather 对该 bot 关闭 Group Privacy，再在群里发一条） - 同样打开上面的
getUpdates地址，读取chat.id - 群 / 超级群的 Chat ID 为负数，升级为超级群后常见形式为
-100... - 把完整数字（含负号）填入 Chat ID，不要只抄链接里的片段
群升级为超级群后
普通群升级为超级群后，旧的 chat id 可能失效。请重新对机器人发一条消息，再通过 getUpdates 读取新的 -100... id，并更新产品中的 Chat ID。
若曾给机器人配过 Telegram 侧 Webhook，getUpdates 可能为空；需先调用 deleteWebhook 再试，或改用可靠的 Chat ID 查询方式后填入产品。
3. 填到哪里
控制台（本账号告警）
- 以管理员登录控制台
- 打开 系统管理 → 通知设置
- 在「渠道」中开启 Telegram，粘贴 Bot Token 与 Chat ID
- 按需开启相关事件，选择通知语言，可选改模板
- 保存后点 试发，确认手机/群收到测试消息
运营后台（平台运维告警）
- 登录运营后台
- 打开 系统通知
- 配置总开关、提前提醒天数、事件、通知语言与模板
- 在「渠道」中开启 Telegram，填入运营侧 Bot Token 与 Chat ID
- 保存后试发；日常告警还依赖服务端定时任务（许可扫描、域名探测等）已部署
两套配置的 token / chat_id 互不共用同一套表；改运营侧不会覆盖账号侧，反之亦然。
常见填错
界面试发失败时，优先核对下面几项（与 UI 报错常见原因一致）：
| 填错 | 表现 / 原因 | 正确做法 |
|---|---|---|
| Token 缺了冒号前的数字 ID | 只粘贴了 :AAH... 后半段；Telegram 返回 404 Not Found | 填完整 数字ID:密钥，冒号前后都要有 |
Token 带了 bot 前缀或整段 API URL | 字段值非法，请求路径重复或无法解析 | 只填 BotFather 给出的 token，不要加 bot，不要贴 URL |
| 群 Chat ID 漏了负号 | 把 -100123... 写成 100123... | 群 / 超级群必须带负号 |
| 仍用升级前的旧群 ID | 普通群升超级群后旧 id 失效 | 用 getUpdates 取新的 -100... 并更新 |
试发与排障
| 现象 | 可检查 |
|---|---|
| 试发失败 | 对照上一节「常见填错」；Token 是否完整、Chat ID 正负号、机器人是否已收到过该会话消息；可用 getMe 先校验 token |
| 试发成功但业务告警没有 | 事件开关是否开启；系统侧总开关是否开；账号是否仍在服务期内 |
| 群收不到 | 机器人是否在群内；群隐私模式是否挡住普通消息；是否已换成超级群新 id |
| 文案不对 | 当前「通知语言」与模板是否对应；恢复默认只清当前语言 |
相关页面：通知与 Webhook 配置 · 系统与账号 · 控制台总览 · 常见问题。