> For the complete documentation index, see [llms.txt](https://docs.nextcli.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nextcli.com/cloud/telegram-bot/telegram-customer-service-bot.md). # Telegram双向转发客服机器人 {% hint style="success" %} #### 免费体验双向转发/客服机器人 在线体验步骤： {% stepper %} {% step %} ### 与机器人对话并留言任意消息 [@ForwardHubBOT](https://t.me/ForwardHubBOT) * 此时与机器人对话的您的身份是客户/用户，在向客服发消息。 {% endstep %} {% step %} ### 加入群组 [@ForwardHubBotGroup](https://t.me/ForwardHubBotGroup) * 鼠标右键点击 群内机器人转发您的消息 -> 回复 ，输入任意内容进行回复； * 机器人会将您在群中引用回复的消息以私聊形式发送给客户/用户 * 此时在群中的您的身份是客服工作人员。 {% endstep %} {% endstepper %} {% endhint %} {% hint style="info" %} ### Telegram客服机器人介绍 Telegram客服机器人，永久免费使用！是 livegram 等产品的绝佳替代！ 与 [Telegram群组/频道管理机器人](/cloud/telegram-bot/telegram-group-channel-management-bot.md)、 [加密货币收/支监控通知机器人](/cloud/telegram-bot/cryptocurrency-notification-bot.md) 不同，Telegram客服机器人主要定位于被Telegram双向限制发消息的个人/公司/组织、团队的对外统一客服入口！ 1. 主要功能是将用户与机器人的对话转发给指定个人或群组； 2. 主要应用场景： ✅ 公司/组织/团队对外统一的客服账号（公司多位客服可以通过群内回复机器人转发的客户消息，便于倒班调休、多客服协作处理客户问题） ✅ 想要隐藏个人Telegram身份的组织、团队； {% endhint %} #### 🌟双向转发/客服机器人工作流程示意图

Telegram机器人消息转发流程（可点击放大图片观看）

{% hint style="success" %} ### 机器人亮点功能 我们愿称之为**最强客服机器人**，最完整的支持Telegram所有消息格式、以及消息的引用结构！同时支持双向删除消息！ 所有这些创新能力，都是基于我们自身超过5年使用Telegram转发客服消息的实战经验： 1. **支持发送 Telegram Desktop 和 Telegram Mobile App 支持的所有消息/资源类型** 1. **包括**：文本、图片和视频、文档、投票、位置、Wallet、Emoji、表情(含Telegram 会员表情)、Gif动态图 2. **Include**: Text、Photo or video、Document、Creat poll、Location、Wallet、Emoji(Include Telegram Premium Emoji)、Stickers、Gifs.. 3. 还支持zip/rar/mp3/mp4/视频录像等几乎所有格式 2. **支持引用消息，双向继承消息的引用关系** 1. 当用户A发消息 Text-1 给客服BOT，然后引用了该消息回复 Text-B ，则客服BOT侧会显示用户A引用了自己发送给客服BOT的消息 Text-1 回复了 Text-B ； 即用户侧引用的消息结构，会完整呈现在客服机器人侧；同理，机器人引用已经发送给用户的消息，用户侧也会显示客服BOT得引用关系； 3. **支持展示消息修改** 1. 当用户A发消息 Text-1 给客服BOT，然后将该条消息修改为 Text-A1 ，机器人会自动引用原消息 Text-1 并告知已修改的消息内容为 Text-A2 ； 4. **支持客服BOT侧双向删除指定消息、双向删除所有消息** 1. 支持客服BOT侧删除自己发送给用户的消息； 2. 支持客服BOT侧删除用户发送给客服BOT的消息，同时在用户侧也会删除该消息； 3. 支持客服BOT侧删除客服与用户的所有双向对话消息； 5. 无引用关系的消息（用户侧单方面删除了消息），系统将自动尝试用独立新消息的形式发送给用户！ 6. 用户发送消息后对消息进行修改，会在客服侧引用展示新编辑后的消息！ 7. 当客服发送消息给用户时，用户单方面删除了引用消息时，客服机器人会自动尝试使用独立消息发送给用户，并返回发送成功、失败的状态！ 8. 支持使用 `/send 消息` 单独给用户发送消息，而不引用上文消息； 9. **全员消息通知**：支持群发消息给所有曾经跟机器人对话过的用户！（已屏蔽机器人的用户除外） 10. 更多功能，等您亲自来发现.. {% endhint %} {% tabs fullWidth="false" %} {% tab title="使用方法" %} {% stepper %} {% step %} ### 创建机器人 👍方法一(推荐)：[打开 @botfather 的小程序](https://t.me/botfather?startapp)，创建机器人 -> Create a New Bot -> ... -> Copy Token! ⚙️方法二：与 [@BotFather](https://t.me/BotFather) 对话，发送 `/newbot` 创建机器人，或 `/mybot` 在现有机器人中选择要使用的机器人，API Token获取机器人Token，示例：`506853588:AAFr81Dfz2ZpMxAQpfMXGHAXM_7Qo_h_xUX` {% endstep %} {% step %} ### 在Cloud云平台添加机器人 将你的机器人Token添加到 [双向转发/客服机器人管理平台](https://t.me/tghelp?startapp=customer-service_add) 转发到对话ID，填写个人ID或群组ID，见下文及教程 {% endstep %} {% step %} ### 配置机器人转发消息到哪个对话（转给个人 或 群组） #### 3.1 单客服模式介绍 客户跟机器人对话时，机器人将消息转发给管理员个人； [**单客服配置教程>>**](#dan-ke-fu-pei-zhi-jiao-cheng) #### 3.2 多客服模式介绍 3.2.1 客户跟机器人对话时，机器人将消息转发给群组，可以由任何群成员引用机器人转发进来的客户消息进行回复，机器人都会把消息转发给客户； 3.2.2 多客服模式需要将您创建的客服机器人bot添加到群中，**设置为管理员**并给予全部管理员权限 3.2.3 在群中使用 `/id` 即可获取当前群组ID （⚠️注意：私密群切换为公开群可能导致[群组ID变更](https://docs.nextcli.com/cloud/telegram-bot/telegram-customer-service-bot#note)，请及时将群组ID更新到Cloud云平台） [**多客服配置教程>>**](#duo-ke-fu-pei-zhi-jiao-cheng) {% endstep %} {% endstepper %} ### 如何获取对话ID #### 如何获取单客服模式对话ID/个人ID 使用个人的Telegram账号与机器人对话，发送 `/id` 即可获取 #### 如何获取多客服模式对话ID/群组ID 将您的客服机器人拉进群组后，发送 `/id` 即可获取 {% endtab %} {% tab title="单客服配置教程" %} **单客服模式介绍**： 客户跟机器人对话时，机器人将消息转发给管理员个人 管理员引用消息回复，机器人将把消息转发回给目标用户！ **配制方法**： 1️⃣、[打开 @botfather 的小程序](https://t.me/botfather?startapp)，创建机器人 -> Create a New Bot -> ... -> Copy Token! 示例：`506853588:AAFr81Dfz2ZpMxAQpfMXGHAXM_7Qo_h_xUX` 2️⃣.1、跟机器人 @TGHelp 对话 发送 [/id](https://t.me/tghelp?start\&text=/id) 获取你的Telegram ID，如：`Your User ID: 942378888` 2️⃣.2、将 **机器人Token** 和 **接收消息的你的Your User ID** [添加到机器人配置](https://cloud.nextcli.com/bot/csb/bot) 的 转发到对话ID。 2️⃣.3、添加好token，云平台即接管了机器人 至此，已配置完成 客户与与机器人的对话都将通过机器人转发给管理员个人！ **测试**： 模拟客户：单独给机器人发消息123，机器人会转发消息给自己 模拟客服：引用机器人转发的客户的消息123 并回复消息456，机器人会将消息456转发给客户(还是自己) 也可以找其他TG账号发消息来测试，更直观。 **注意事项**： 在此期间，可以删除对话历史记录，但一定不能 停用并屏蔽机器人 {% endtab %} {% tab title="多客服配置教程" %} **多客服模式介绍**： 客户跟机器人对话时，机器人将消息转发给群组，可以由群内任何人引用机器人转发进来的客户消息进行回复，机器人都会把消息转发给客户 可以实现客服、技术、老板 都在群内的场景 也能实现客服倒班轮岗，有历史问题未处理完的也可以让后续值班的同事继续跟进处理，技术人员/老板都可以随时看到进展！ **配制方法**： 1️⃣、[打开 @botfather 的小程序](https://t.me/botfather?startapp)，创建机器人 -> Create a New Bot -> ... -> Copy Token! 示例：`506853588:AAFr81Dfz2ZpMxAQpfMXGHAXM_7Qo_h_xUX` 2️⃣.1、创建一个私有群组，将群组设置里的->历史消息对新成员可见 开启，做了这个操作之后群组ID将会变为 `-100xxx1234567` 开头且以后也不会改变的Chat ID. 2️⃣.2、将客服机器人拉进群，并**设置成管理员**，**给予机器人所有管理员权限**；1 如果群组使用[**话题模式**](#group-topics)，开启群组的话题设置后，必须再次设置机器人的管理员权限，给予其管理话题的权限！ 2️⃣.3、在这个群内发送 **`/id`** 获取本群ID 如： `-100xxx1234567` ，然后回到[机器人配置](https://cloud.nextcli.com/bot/csb/bot)填写到该机器人的 **转发至对话ID** ； 建议设置群组的 \[新成员是否可见聊天记录] 为可见，历史消息就会具备 \[拷贝消息链接] 私聊发送给群成员，点击该链接即可定位到该消息，如 [https://t.me/nextcli/20](https://t.me/nextcli/20) 2️⃣.4、在[添加机器人页面](https://cloud.nextcli.com/bot/csb/bot)，填写/编辑机器人Token 修改 **转发至对话ID** 如果没有可以先不填写对话ID 至此，已配置完成 客户与机器人的对话都将通过机器人转发到这个群组！ **测试**： 模拟客户：单独给机器人发消息123，机器人会转发消息给自己 模拟客服：引用机器人转发的客户的消息123 并回复消息456，机器人会将消息456转发给客户(还是自己) 也可以找其他TG账号发消息来测试，更直观。 **注意事项**： 在此期间，可以删除对话历史记录，但一定不能 停用并屏蔽机器人 {% endtab %} {% endtabs %} ### 话题模式 Group-Topics > #### 1️⃣ **说明**： > > 每位用户与机器人对话后，机器人转发消息到群组时都将以用户的Telegram唯一ID创建一个话题，该用户的所有对话都将转发到该话题下。 > > **✅ 优点**： > > \- 不需要引用转发的消息，直接在话题下发消息机器人就会转发给客户 > > \- 显示客户 @Username 方便您记录、私聊该用户！ > > \- 如果是重点客户，您可以单独点击话题进行修改 > > > > 🧰 **话题命名规范** > > ``` > Telegram ID | @Username | First name Last name > 123456 | @TGHelp | TGHelp Group/Channel / Crypto Monitor / Forward Bot🆓 > ``` > > **Telegram ID**：Telegram 唯一数字 ID，绝对不会重复！ > > **@Username**：用户设置的Username，唯一值，不会与其他用户重复 > > 用户可以随时修改该 @Username > > 同时，用户也可以不设置 @Username > > **First name Last name**：Telegram用户昵称，可以随时、任意修改。 > > {% hint style="danger" %} > **其他说明**： > > 1. 截止 2026-01-01 Telegram群组最大只能创建10000个话题 > > 2. 如果用户修改了 @Username 或名字，机器人将不对话题名字进行更新，但请放心：Telegram数字ID是唯一且不会变的！ > {% endhint %} > > *** > > #### 2️⃣ 设置方法 > > 📤 **开启话题模式**： > > 机器人转发消息去到的**群组 -> 管理群组 Manage -> 话题Topics -> 列表List -> 保存Save** > > 开启后，机器人将自动识别群组为话题模式！ > > > > 2. ⚠️您的双向转发机器人**必须是管理员**！ > 3. ⚠️并且该双向转发机器人**必须拥有管理话题Manage topics的权限**，如图： > > > > #### 3️⃣ 测试 > > 您可以测试给您的双向机器人发消息，机器人将在群组内为您创建以您Telegram ID为唯一值的话题，说明已正常生效！ > > \- 如果看不懂Telegram语言，请先[点此设置您的Telegram语言>>](https://t.me/tghelp?start\&text=/lang) > > \- 如有其他设置问题或寻求帮助，请联系客服 👩‍💻 [@NextCLiCloudBOT](https://t.me/NextCLiCLoudBOT?start\&text=%23feedback%0A) *** ### 支持的命令列表 | 命令 | 使用说明 | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /id | **获取对话ID**，可以在群中获取，也可以单独跟机器人对话获取 | | /ban |

封禁用户

  1. 引用机器人转发用户消息，回复 /ban 即可禁止该用户与机器人对话
  2. 也可以在对话框单独使用

/ban 888444

/ban @username

| | /unban |

解禁用户

  1. 引用机器人转发的用户消息，回复 /unban 即可允许该用户与机器人再次对话
  2. 也可以在对话框单独使用

/unban 888444

/unban @username

| | /send | 单独给用户发送消息 | | /delete |

双向删除被引用的这一条消息：引用消息并回复 /delete 即可双向删除该消息；

可以作用于机器人转发来的消息和群组中其他人(客服)的消息从用户侧删除。

| | /deleteall | 双向删除用户与机器人的所有消息记录：引用用户的消息并回复 /deleteall 将双向删除该用户和本机器人的所有对话 | | 其他命令，等待您来提需求！😊 | | ### 机器人->命令->数据接口
接口参数示例如下： 1. 开发自己的后端接口： 2. 添加bot命令： /cmd param1 param2 （参数个数与接口地址占位符一致） 3. 添加 到数据接口 用户每次调用命令即可触发您自己的后端接口 #### /id 命令代码 用户向机器人发送 `/id` 时返回的个人/群组 Telegram唯一id 查询代码 ⚠️本代码由Cloud开发，只适用于Cloud后台文本内容编辑器！ [查看 `/id` 代码>>](/cloud/telegram-bot/telegram-bot-notification-template-sharing.md#id) {% hint style="info" %} ### ⚠️注意事项：群组ID是会变更的！ 改变群组类型，会引发群组ID变更，因为客服机器人转发到老的群组ID，所以无法转发消息到群内： 1. 初次创建群组，群组类型为私密群组时，群组的ID较短 如：-4731660548 (不推荐用这种) 2. 当把群组设置为【历史记录对新成员可见】，或设置为公开群组时（公开群组可能会暴露群聊信息，任何人都能通过群 @ID 看到群消息），群组ID会变得更长，如：-1002649557645 (推荐) **预处理方案**： * 创建群组后，先将【群组类型】设置为【公开群组】，然后再设置为【私密群组】，此时群组ID将始终为 -10开头不会再发生变化。 * 设置为【公开群组】后，群内成员新发出来的消息，将可以【复制消息链接】 便于后续分享/定位到该消息； * 建议将 新成员是否可见聊天记录 默认的【隐藏】设置为【可见】； {% endhint %} 如有使用问题或功能建议，请联系 [**@NextCLiCloudBOT**](https://t.me/NextCLiCloudBOT)