> For the complete documentation index, see [llms.txt](https://wiki.vtx.team/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.vtx.team/servo/telegram-topics.md).

# Telegram 客服

自 Servo2 镜像开始，支持使用 Telegram 群组的 Topics 功能处理每个用户的消息，一个用户一个 Topic 。

{% hint style="warning" %}
使用 Telegram 客服，请千万不要删除群组中的 Topic ，会造成无法正常接收和回复用户消息的问题，导致数据库不同步只能删除数据库！
{% endhint %}

#### 1、创建 Telegram Bot

Telegram 找到 [@BotFather ](https://t.me/BotFather)，创建一个新的 Bot

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

自定义 Bot 的名称和用户名，创建完成后如下所示，记录 bot token 备用

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

#### 2、浏览器先打开 <https://api.telegram.org/bot\\><bot token>/getUpdates，将 \<bot token> 替换为上述  bot token

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

#### 3、创建一个私密群组，并将刚刚创建的 Bot 拉入群组

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

#### 4、开启群组的 Topics 功能

<figure><img src="/files/WaHgfVbgj2SI8QHQMDH9" alt=""><figcaption><p>打开群组设置</p></figcaption></figure>

<figure><img src="/files/VnjICBmv0mM0uOEiEFNn" alt=""><figcaption><p>勾选“Topics”后，点击 Save 保存</p></figcaption></figure>

#### 5、给予 Bot 管理权限，特别注意必须给 Bot 管理 Topics 的权限

<figure><img src="/files/fFgGtILdcR9B25WS2CpH" alt=""><figcaption><p>添加管理员</p></figcaption></figure>

<figure><img src="/files/fjWCbt9UQ4NS3etWRe8B" alt=""><figcaption><p>注意权限</p></figcaption></figure>

#### 6、回到步骤2的浏览器界面，点击刷新，找到title为你刚刚创建的群组名称且type为supergroup的，复制 id，一般以 - 开头

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

#### 7、将步骤1的 Bot token 和步骤6的 id，填入 [服务端搭建](/servo/server-setup.md) 的 user.json

{% hint style="danger" %}
注意：

1、若升级使用 Telegram 客服需修改 `~/servo/docker-compose.yml` 中的 docker 镜像为 `vtxteam/servo2:latest`

2、全新搭建客服无需修改！

3、不使用 Telegram 客服也无需修改，仍保持 `vtxteam/servo:latest` 即可
{% endhint %}