Telegram

您可以将 GPTBots Agent 集成到 Telegram Bot (TG Bot)，让您 Telegram 的用户透过 TG Bot 与 Agent 对话。

Telegram 目前支持三种 Agent 与 用户 对话的方式：

1. 单聊：Agent 与用户一对一对话
2. 群聊 - 被动监听：Agent 只在用户@TG Bot的时候响应
3. 群聊 - 主动监听：Agent 全量监听用户的信息并响应

创建 TG Bot

访问 BotFather，并输入/newbot命令，跟随 BotFather 的指令，创建一个 TG Bot。

创建完成后，可以获得 TG Bot 的链接(Telegram Agent Link)，以及 token。

在 GPTBots 内配置

进入 GPTBots，进入“集成 - Telegram”，开启开关，并进入管理页面。点击添加TG Bot。

填入从 BotFather 内获取的 token，点击底部的“驗證”。

验证成功后，上面的栏位会刷新你在 TG Bot 设置的头像和名称（Username）。确认无误后，在下方选择这个 TG Bot 要响应的聊天模式。接著点击"提交"。

注意：若要使用主动监听功能，需要先设置监听频率和监听规则才能启用，详细教学请看最下面的段落。

提交成功后，系统将提供 TG Bot 的链接(Telegram Agent Link)。该链接可以发给您的用户，他们可以通过这个链接访问 TG Bot，并开始与它对话。

更新 Agent 简介

点击“更新Agent简介”，可以将 Agent 当前设置的简介更新至所有的TG Bot。

在 Telegram 内单聊

将单聊的按钮开启即可。

用户访问 Telegram Agent Link 的链接，即可在 Telegram 内与 Agent 对话。

在 Telegram 内群聊 (被动监听)

群聊 (被动监听)：Agent 只在用户@TG Bot的时候响应

配置教程

首先，在 BotFather 内，将 TG Bot 的群聊权限调整成「被动监听」模式。

1. 输入setprivacy
2. 输入想要调整群聊权限的 TG Bot，如“@YourBotName”
3. 根据指示，输入Enable
4. TG传回Enable，则代表「被动监听」开启成功

接著，打开 TG Bot 的资料界面，点击“Add to Group or Channel”。

选择想要添加 TG Bot 的群。

保持使用“Admin Rights”，为 TG Bot 提供完整权限，并点击“Add Bot as Admin”，即可完成将 TG Bot 添加至群的操作。

接著回到GPTBots的Telegram集成页面，点击「设置」。

在群聊模式中，选择「被动监听」，点选提交，设定就完成了。

在 Telegram 内群聊 (主动监听)

群聊 (主动监听)：Agent全量监听用户的消息并给予回应。

完整流程：系统将会根据设置的监听频率，定时蒐集群聊消息到暂存区。接著将消息给监听规则匹配，若有成功命中，才会把群聊消息交给Agent去响应。

配置教程

首先，在 BotFather 内，将 TG Bot 的群聊权限调整成「主动监听」模式。

1. 输入setprivacy
2. 输入想要调整群聊权限的 Agent，如“@YourBotName”
3. 根据指示，输入Disable
4. TG传回Disable，则代表「主动监听」开启成功

接著，打开 TG Bot 的资料界面，点击“Add to Group or Channel”。

选择想要添加 TG Bot 的群。

保持使用“Admin Rights”，为 TG Bot 提供完整权限，并点击“Add Bot as Admin”，即可完成将 TG Bot 添加至群的操作。

接著回到 GPTBots 的 Telegram 集成页面，点击「设置」。

在群聊模式中，选择「主动监听」。主动监听的设置包含两个部分。

第一步，我们要来调整监听频率。监听频率代表系统蒐集群聊消息的频率，时间越短，Agent回覆的越频繁。

第二步，我们要来设定监听规则。点击「设置监听规则」。

注意：监听频率和监听规则皆为必填项，两者皆需设置才能开启主动监听。

监听规则提供三种模式选择：

1. 关键词匹配：支持正则匹配，当群聊中的消息命中列表下的关键词，才会将消息提供给Agent。
2. 语意匹配（普通）：LLM会根据列表的关键词判断，若群聊消息有匹配到，才会将消息提交给Agent响应。普通模式：速度快，积分消耗少，匹配效果中等。
3. 语意匹配（高级）：LLM会根据列表的关键词和描述判断，若群聊消息有匹配到，才会将消息提交给Agent响应。高级模式：速度快，积分消耗高。匹配效果好。

选择好匹配规则后，在下方的列表添加关键词和描述。


填完关键词和描述后，记得将启用的按钮打开，点击「确认」。接著回到「设置TG Bot」弹窗，点击「保存」，主动监听的设置就完成了。

若后续要调整监听规则的内容，也能点击图片中的「监听规则」来调整。

注意：使用群聊模式下「主动监听」的「语意匹配」功能，可能会消耗大量的积分。若要避免积分消耗，请使用「关键词匹配」。