Telegram 适配器配置
网络环境说明
Telegram 服务在某些网络环境下可能存在访问延迟或不稳定的情况,这与你的本地网络状况有关。请确保你的设备能够正常与 Telegram 服务器通信后再进行配置。

适配说明
EasyBot 在设计之初未将 Telegram 平台作为首要适配目标,因此部分功能存在限制。
已知限制
| 功能 | 状态 | 说明 |
|---|---|---|
| 同步群聊 | 不支持直接同步 | Telegram 未提供列出所有群组的 API 接口 |
| 自动发现群组 | 不支持 | 需手动在群内发送指令启用 |
群聊 启用方式
由于无法直接拉取群组列表,你需要先将机器人添加至目标群组,然后由具有群主或管理员权限的成员在群内发送以下指令:
/easybot_group
发送后在 EasyBot 管理页面中即可看到该群组,点击 启用群聊 即可完成配置。

创建机器人
Telegram 的机器人通过官方 Bot Father 进行创建与管理。
第一步:创建新 Bot
在 Telegram 中搜索 @BotFather,进入对话后输入 /newbot 开始创建:

第二步:设置名称与用户名
BotFather 会依次要求你输入:
- 显示名称:可随意填写,支持中文
- 用户名:必须以
bot结尾,仅允许英文与数字,且不能与已有 Bot 重复

第三步:获取并保管 Token
创建成功后,BotFather 会返回一串格式如 123456:ABC-DEF1234ghikl 的 Token。这是 EasyBot 配置 Telegram 适配器的唯一凭证,请务必妥善保管,切勿泄露给他人。

关闭隐私模式
Telegram 默认启用隐私模式,此模式下机器人仅能接收以 / 开头的命令消息,无法读取群组中的普通聊天内容。
在 @BotFather 对话中输入 /setprivacy,选择你刚创建的机器人:

然后点击 Disable 关闭隐私模式:

关闭隐私模式(选择 DISABLE)后,机器人才能读取群组中的所有消息(包括 @ 提及消息)。对于对话型机器人或自动回复功能而言,此步骤至关重要,否则 EasyBot 将无法正常处理群聊消息。
| 关闭前 | 关闭后 |
|---|---|
在 EasyBot 中配置
打开 EasyBot 管理页面,导航至 适配器管理,点击 新建适配器,选择 Telegram 协议。在 Token 字段中填入 BotFather 提供的 Token,然后点击保存:

点击 启动适配器,待连接状态显示为「运行中」即表示配置成功:

启用群聊

将机器人添加到目标群组后,由群主或管理员在群内发送 /easybot_group,然后回到 EasyBot 适配器管理页面,点击同步群聊,即可看到该群组。

EasyBot 默认全群关闭,每个群组都需要按上述方式手动启用。
