跳到主要内容

Telegram 适配器配置

网络环境说明

网络环境

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

适配说明

EasyBot 在设计之初未将 Telegram 平台作为首要适配目标,因此部分功能存在限制。

已知限制

功能状态说明
同步群聊不支持直接同步Telegram 未提供列出所有群组的 API 接口
自动发现群组不支持需手动在群内发送指令启用

群聊启用方式

由于无法直接拉取群组列表,你需要先将机器人添加至目标群组,然后由具有群主或管理员权限的成员在群内发送以下指令:

/easybot_group

发送后在 EasyBot 管理页面中即可看到该群组,点击 启用群聊 即可完成配置。

发送 /easybot_group 指令的截图

创建机器人

Telegram 的机器人通过官方 Bot Father 进行创建与管理。

第一步:创建新 Bot

在 Telegram 中搜索 @BotFather,进入对话后输入 /newbot 开始创建:

@BotFather 对话中输入 /newbot 的截图

第二步:设置名称与用户名

BotFather 会依次要求你输入:

  • 显示名称:可随意填写,支持中文
  • 用户名:必须以 bot 结尾,仅允许英文与数字,且不能与已有 Bot 重复

BotFather 要求输入名称和用户名的截图

第三步:获取并保管 Token

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

BotFather 返回 Token 的截图,标注 Token 位置

关闭隐私模式

Telegram 默认启用隐私模式,此模式下机器人仅能接收以 / 开头的命令消息,无法读取群组中的普通聊天内容。

@BotFather 对话中输入 /setprivacy,选择你刚创建的机器人:

/setprivacy 后选择机器人的截图

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

点击 Disable 的截图

务必关闭隐私模式

关闭隐私模式(选择 DISABLE)后,机器人才能读取群组中的所有消息(包括 @ 提及消息)。对于对话型机器人或自动回复功能而言,此步骤至关重要,否则 EasyBot 将无法正常处理群聊消息。

关闭前关闭后

在 EasyBot 中配置

打开 EasyBot 管理页面,导航至 适配器管理,点击 新建适配器,选择 Telegram 协议。在 Token 字段中填入 BotFather 提供的 Token,然后点击保存:

EasyBot 新建 Telegram 适配器并填写 Token 的截图

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

适配器启动成功的截图

启用群聊

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

群聊列表中启用群聊的截图

注意

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

遇到麻烦了?

有偿服务

我们提供有偿代安装服务,解决您的环境配置烦恼。

了解详情
Miku

少年,买服务器吗?

持证经营

专注高性价比游戏云VPS,铂金 / I7 / R9 / 物理机

💰 最低六元起、买不了吃亏买不了上当,快来看看吧~

快来看看