# Telegram双向转发客服机器人

{% hint style="success" %}

#### 免费体验双向转发/客服机器人 <a href="#demo" id="demo"></a>

在线体验步骤：

{% stepper %}
{% step %}

### 与机器人对话并留言任意消息 [@ForwardHubBOT](https://t.me/ForwardHubBOT)

* 此时与机器人对话的<mark style="color:orange;">您的身份是客户/用户</mark>，在向客服发消息。
  {% endstep %}

{% step %}

### 加入群组 [@ForwardHubBotGroup](https://t.me/ForwardHubBotGroup)

* 鼠标右键点击 群内机器人转发您的消息 -> 回复 ，输入任意内容进行回复；
* 机器人会将您在群中引用回复的消息以私聊形式发送给客户/用户
* 此时在群中的<mark style="color:red;">您的身份是客服工作人员</mark>。
  {% endstep %}
  {% endstepper %}
  {% endhint %}

{% hint style="info" %}

### Telegram客服机器人介绍 <a href="#telegram-bot-intro" id="telegram-bot-intro"></a>

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 %}

#### 🌟双向转发/客服机器人工作流程示意图 <a href="#workflow" id="workflow"></a>

<figure><img src="/files/REnqdWuZPJRg4RbA9HSO" alt=""><figcaption><p>Telegram机器人消息转发流程（可点击放大图片观看）</p></figcaption></figure>

{% hint style="success" %}

### <mark style="color:purple;">机器人亮点功能</mark> <a href="#highlight-features" id="highlight-features"></a>

我们愿称之为<mark style="color:red;">**最强客服机器人**</mark>，最完整的支持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 %}

### 创建机器人 <a href="#step1" id="step1"></a>

👍方法一(推荐)：[打开 @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云平台添加机器人 <a href="#step2" id="step2"></a>

将你的机器人Token添加到 [双向转发/客服机器人管理平台](https://t.me/tghelp?startapp=customer-service_add)

转发到对话ID，填写个人ID或群组ID，见下文及教程
{% endstep %}

{% step %}

### 配置机器人转发消息到哪个对话（转给个人 或 群组） <a href="#step3" id="step3"></a>

#### 3.1 单客服模式介绍 <a href="#step3.1" id="step3.1"></a>

客户跟机器人对话时，机器人将消息转发给管理员个人；

[<mark style="color:purple;">**单客服配置教程>>**</mark>](#dan-ke-fu-pei-zhi-jiao-cheng)

#### 3.2 多客服模式介绍 <a href="#step3.2" id="step3.2"></a>

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云平台）

[<mark style="color:purple;">**多客服配置教程>>**</mark>](#duo-ke-fu-pei-zhi-jiao-cheng)
{% endstep %}
{% endstepper %}

### 如何获取对话ID <a href="#get-chatid" id="get-chatid"></a>

#### 如何获取单客服模式对话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

&#x20;   <mark style="color:red;">如果群组使用</mark>[<mark style="color:blue;">**话题模式**</mark>](#group-topics)<mark style="color:red;">，开启群组的话题设置后，必须再次设置机器人的管理员权限，给予其管理话题的权限！</mark>

2️⃣.3、在这个群内发送 **`/id`** 获取本群ID 如： `-100xxx1234567` ，然后回到[机器人配置](https://cloud.nextcli.com/bot/csb/bot)填写到该机器人的 **转发至对话ID** ；

&#x20;       <mark style="color:green;">建议设置群组的 \[新成员是否可见聊天记录] 为可见，历史消息就会具备 \[拷贝消息链接] 私聊发送给群成员，点击该链接即可定位到该消息，如</mark> [<mark style="color:green;">https://t.me/nextcli/20</mark>](https://t.me/nextcli/20)

2️⃣.4、在[添加机器人页面](https://cloud.nextcli.com/bot/csb/bot)，填写/编辑机器人Token

&#x20;       修改  **转发至对话ID** 如果没有可以先不填写对话ID

至此，已配置完成

客户与机器人的对话都将通过机器人转发到这个群组！

&#x20;

**测试**：

模拟客户：单独给机器人发消息123，机器人会转发消息给自己

模拟客服：引用机器人转发的客户的消息123 并回复消息456，机器人会将消息456转发给客户(还是自己)

也可以找其他TG账号发消息来测试，更直观。

**注意事项**：

在此期间，可以删除对话历史记录，但一定不能 停用并屏蔽机器人
{% endtab %}
{% endtabs %}

### 话题模式 Group-Topics <a href="#group-topics" id="group-topics"></a>

> #### 1️⃣ **说明**：
>
> 每位用户与机器人对话后，机器人转发消息到群组时都将以用户的Telegram唯一ID创建一个话题，该用户的所有对话都将转发到该话题下。
>
> **✅ 优点**：
>
> &#x20; \- 不需要引用转发的消息，直接在话题下发消息机器人就会转发给客户
>
> &#x20; \- 显示客户 @Username 方便您记录、私聊该用户！
>
> &#x20; \- 如果是重点客户，您可以单独点击话题进行修改
>
> &#x20; <img src="/files/hFrPOrisIJvlRRMLbij2" alt="" data-size="original">
>
> 🧰 **话题命名规范**
>
> ```
> Telegram ID | @Username | First name  Last name
> 123456 | @TGHelp | TGHelp Group/Channel / Crypto Monitor / Forward Bot🆓
> ```
>
> **Telegram ID**：Telegram 唯一数字 ID，绝对不会重复！
>
> **@Username**：用户设置的Username，唯一值，不会与其他用户重复
>
> &#x20;       用户可以随时修改该 @Username&#x20;
>
> &#x20;       同时，用户也可以不设置 @Username&#x20;
>
> **First name  Last name**：Telegram用户昵称，可以随时、任意修改。
>
> {% hint style="danger" %}
> **其他说明**：
>
> 1. 截止 2026-01-01  Telegram群组最大只能创建10000个话题
>
> 2. 如果用户修改了 @Username 或名字，机器人将不对话题名字进行更新，但请放心：Telegram数字ID是唯一且不会变的！
>    {% endhint %}
>
> ***
>
> #### 2️⃣ 设置方法
>
> 📤 **开启话题模式**：
>
> &#x20;     机器人转发消息去到的**群组 -> 管理群组 Manage -> 话题Topics -> 列表List -> 保存Save**
>
> &#x20;     开启后，机器人将自动识别群组为话题模式！
>
> <img src="/files/CqgfX0VEleyIzu09MbdX" alt="" data-size="original">
>
> 2. ⚠️您的双向转发机器人**必须是管理员**！
> 3. ⚠️并且该双向转发机器人**必须拥有管理话题Manage topics的权限**，如图：
>
> <img src="/files/jFM07Q1NsiKqofJ816oG" alt="" data-size="original">
>
> #### 3️⃣ 测试
>
> 您可以测试给您的双向机器人发消息，机器人将在群组内为您创建以您Telegram ID为唯一值的话题，说明已正常生效！&#x20;
>
> &#x20;\- 如果看不懂Telegram语言，请先[点此设置您的Telegram语言>>](https://t.me/tghelp?start\&text=/lang)
>
> &#x20;\- 如有其他设置问题或寻求帮助，请联系客服 👩‍💻 [@NextCLiCloudBOT](https://t.me/NextCLiCLoudBOT?start\&text=%23feedback%0A)&#x20;

***

### 支持的命令列表 <a href="#command-list" id="command-list"></a>

| 命令              | 使用说明                                                                                                                                                          |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| /id             | **获取对话ID**，可以在群中获取，也可以单独跟机器人对话获取                                                                                                                              |
| /ban            | <p>封禁用户</p><ol><li>引用机器人转发用户消息，回复 /ban 即可禁止该用户与机器人对话</li><li>也可以在对话框单独使用</li></ol><p><code>/ban 888444</code></p><p><code>/ban @username</code> </p>          |
| /unban          | <p>解禁用户</p><ol><li>引用机器人转发的用户消息，回复 /unban 即可允许该用户与机器人再次对话</li><li>也可以在对话框单独使用</li></ol><p><code>/unban 888444</code></p><p><code>/unban @username</code> </p> |
| /send           | 单独给用户发送消息                                                                                                                                                     |
| /delete         | <p>双向删除被引用的这一条消息：引用消息并回复 /delete 即可双向删除该消息；</p><p>可以作用于机器人转发来的消息和群组中其他人(客服)的消息从用户侧删除。</p>                                                                     |
| /deleteall      | 双向删除用户与机器人的所有消息记录：引用用户的消息并回复 /deleteall 将双向删除该用户和本机器人的所有对话                                                                                                    |
| 其他命令，等待您来提需求！😊 |                                                                                                                                                               |

### 机器人->命令->数据接口 <a href="#api" id="api"></a>

<figure><img src="/files/NjDAN8YGjXMel1BZ5Cej" alt=""><figcaption></figcaption></figure>

接口参数示例如下：

1. 开发自己的后端接口： <https://api.xxx.com/v1/getinfo?mode={0}\\&address={1}（注意只支持GET请求）>
2. 添加bot命令： /cmd param1 param2 （参数个数与接口地址占位符一致）
3. 添加 <https://api.xxx.com/v1/getinfo> 到数据接口

用户每次调用命令即可触发您自己的后端接口

#### &#x20;/id 命令代码 <a href="#id-code" id="id-code"></a>

&#x20; 用户向机器人发送 `/id` 时返回的个人/群组 Telegram唯一id 查询代码

&#x20; ⚠️本代码由Cloud开发，只适用于Cloud后台文本内容编辑器！

[查看 `/id` 代码>>](/cloud/telegram-bot/telegram-bot-notification-template-sharing.md#id)

{% hint style="info" %}

### ⚠️注意事项：群组ID是会变更的！ <a href="#note" id="note"></a>

改变群组类型，会引发群组ID变更，因为客服机器人转发到老的群组ID，所以无法转发消息到群内：

1. 初次创建群组，群组类型为私密群组时，群组的ID较短 如：-4731660548 (不推荐用这种)
2. 当把群组设置为【历史记录对新成员可见】，或设置为公开群组时（公开群组可能会暴露群聊信息，任何人都能通过群 @ID 看到群消息），群组ID会变得更长，如：-1002649557645 (推荐)

**预处理方案**：

* 创建群组后，先将【群组类型】设置为【公开群组】，然后再设置为【私密群组】，此时群组ID将始终为 -10开头不会再发生变化。
* 设置为【公开群组】后，群内成员新发出来的消息，将可以【复制消息链接】 便于后续分享/定位到该消息；
* 建议将 新成员是否可见聊天记录 默认的【隐藏】设置为【可见】；
  {% endhint %}

如有使用问题或功能建议，请联系 [<mark style="color:purple;">**@NextCLiCloudBOT**</mark>](https://t.me/NextCLiCloudBOT)&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nextcli.com/cloud/telegram-bot/telegram-customer-service-bot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
