Telegram Bot¶

Bots 是在 Telegram 应用内部运行的小型应用程序。用户通过灵活的界面与机器人进行交互，这些界面可以支持任何类型的任务或服务。本文档介绍如何在观测云创建 Telegram Bot 通知对象，将告警消息直接推送至 Telegram 私聊、群组或频道。

点击了解 Bot 更多信息.

注意

该通知对象仅适用于已绑定国际版费用中心账号的国际站点工作空间。

配置前准备¶

在观测云配置前，需要先在 Telegram 完成以下准备工作：

第一步：创建 Bot 并获取 Token¶

在 Telegram 中搜索并启动 @BotFather；
发送 /newbot 指令创建新 Bot；
按提示设置 Bot 名称和用户名（用户名必须以 bot 结尾）；
创建成功后，妥善保存返回的 Bot Token（格式如：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）。

注意

Bot Token 是调用 Telegram API 的凭证，请妥善保管，切勿泄露。

第二步：获取 Chat ID¶

将 Bot 添加至目标群组，或创建个人私聊，在聊天中发送消息 @userinfobot 并点击跳转获取 Chat ID。

Chat ID 支持以下格式：

接收场景	Chat ID 格式	示例
私聊	用户 ID（纯数字）	`123456789`
群组	群组 ID（负数）	`-1001234567890`
频道	频道用户名	`@my_channel`

第二步：获取 Topic ID（可选）¶

仅当目标为论坛群（Forum Supergroup）且需要发送至指定话题时需要：

在目标话题中发送一条消息；
访问 https://api.telegram.org/bot<YourBOTToken>/getUpdates；
在返回数据中查找 message_thread_id 字段值。

回到 Telegram Bot 配置页面¶

定义当前通知对象名称，用于在通知对象列表中识别；
填入从 @BotFather 获取的 Bot Token；
填入 Chat ID；
如果您需要发送至论坛群，需要填入 Message Thread ID；
按需测试通知是否已发送（❗️系统发送一条测试消息，请前往对应通知对象内查看测试信息是否成功发送）；
配置操作权限；
确认。