本文档详解 Telegram bot 与通道的连接流程、API token 配置及 webhook 设置。您将了解如何在 Chat App 控制台中实现向用户主动发送消息、接收用户回复,并对多个 Telegram 机器人进行集中化运维与更新。
前提条件
已创建Telegram机器人,操作请参见:如何创建Telegram机器人。
已创建Telegram类型通道,操作请参见:创建及管理 Telegram 通道。
操作步骤
可以参考以下步骤连接公共主页账号。
在左侧导航栏,选择通道管理。
单击需管理的Telegram类型的通道ID。
在通道操作页面,进入机器人管理页面,按需选择创建机器人或连接已有机器人。
输入 Telegram机器人Token。
单击连接。
创建机器人
创建机器人需要企业在Telegram 客户端中进行,机器人创建完成后复制 API Token,在输入框中粘贴,单击连接按钮。
连接已有机器人
将 API Token 粘贴到输入框中,单击连接按钮。连接成功后,您的机器人信息将在页面中进行显示。
一个Telegram类型的通道仅支持连接一个机器人,如需管理多个机器人,请创建多个Telegram类型通道,并在通道中连接机器人。
更新 Token
当机器人的 API Token 泄露或过期时,可以在控制台中更新 Token。
更新 Token 将替换已有 Token,更新过程中可能出现短暂断连,影响消息发送。建议在业务低峰期操作。
在 Telegram 客户端中打开 BotFather,为目标机器人生成新的 API Token。
在机器人管理页面,单击更新Token。
在弹出的对话框中,粘贴新的 API Token。
单击确定。
配置消息工作台
消息工作台用于集中查看和管理用户发送给机器人的上行消息。
在机器人管理页面,单击消息工作台设置。
配置说明:
模式
说明
适用场景
启用消息工作台
所有用户上行消息均在消息工作台中显示。
需要查看全部上行消息
关键字触发
仅当用户消息命中设置的关键字时,该消息才在工作台中显示。
需要过滤低价值消息,聚焦重点内容
删除机器人
删除机器人后,将无法再通过此机器人发送消息。已同步的群组和频道信息也会同步删除,且无法恢复。
在机器人管理页面,单击删除。
在弹出的确认对话框中,单击确定。
Webhook 设置
在机器人管理页面,单击设置Webhook。
通过 Webhook 可以接收消息回执通知(例如消息送达、已读等状态回调)。具体配置方法,请参见回执消息简介与配置流程。
在弹出的Webhook 设置对话框中,配置以下参数:
参数
说明
http协议
开启后,下方三个回调地址字段变为必填并可编辑;关闭后,回调地址字段自动禁用。
状态报告回调地址
接收消息状态报告的 HTTP 回调地址。http协议开启时必填。
消息上行回调地址
接收用户上行消息的 HTTP 回调地址。http协议开启时必填。
通知回调地址
接收审核通知的 HTTP 回调地址。http协议开启时必填。
消息队列监控
开启后,可通过消息队列接收各类回调消息。
状态回执消息队列
接收状态回执消息的队列名称。只读,可单击右侧复制按钮复制队列名称。
消息上行消息队列
接收用户上行消息的队列名称。只读,可单击右侧复制按钮复制队列名称。
通知队列
接收审核通知消息的队列名称。只读,可单击右侧复制按钮复制队列名称。
配置完成后,单击确定保存设置。
后续步骤
完成机器人连接后,可以继续以下操作: