本文档详解 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 可以接收消息回执通知(例如消息送达、已读等状态回调)。具体配置方法,请参见回执消息简介与配置流程。
后续步骤
完成机器人连接后,可以继续以下操作: