Telegram 固定 Topic 客服机器人部署方案
本版本实现的是： 顾客私聊机器人 机器人自动发送欢迎语与菜单 顾客消息自动转发到指定客服群的指定 Topic 客服在该 Topic 内回复顾客消息时，机器人自动转回顾客 支持文字、图片、文件 自动记录最近 100 条回复映射，超出后按时间删除最旧记录
项目名称
Telegram 固定 Topic 客服机器人
功能简介
本版本实现的是：
- 顾客私聊机器人
- 机器人自动发送欢迎语与菜单
- 顾客消息自动转发到指定客服群的指定 Topic
- 客服在该 Topic 内回复顾客消息时，机器人自动转回顾客
- 支持文字、图片、文件
-
自动记录最近 100 条回复映射，超出后按时间删除最旧记录
运行环境
推荐环境：
- Ubuntu 22.04 LTS
- 宝塔面板
- Nginx
- PHP 8.2
- 已配置 HTTPS 域名
- Telegram Bot 已创建
- 已开启 Webhook
文件说明
- 部署目录示例：
/www/wwwroot/bot.888888.com/
主要文件：
webhook.php 主程序
log.txt 日志文件
welcome_users.json 欢迎语用户记录
topic_reply_map.json Topic消息与顾客映射记录
前置条件
在 Telegram 侧需要准备好：
1. Bot 机器人
通过 @BotFather 创建好机器人，并拿到 Bot Token。
2. 客服群
必须是：
- 超级群
- 已开启 Topics / 话题功能
- 机器人已加入群组
- 机器人已设为管理员
3. 固定 Topic
在客服群里先手动创建一个测试 Topic。
例如：
测试话题1
获取该 Topic 的 message_thread_id。
配置参数
在 webhook.php 中修改以下参数：
$token = "你的BOT_TOKEN";
$service_chat_id = "-1000003060400";
$fixed_thread_id = 5;
初始化文件
首次部署时执行：
touch /www/wwwroot/bot.888888.com/welcome_users.json
touch /www/wwwroot/bot.888888.com/topic_reply_map.json
chmod 666 /www/bot.888888.com/welcome_users.json
chmod 666 /www/wwwroot/bot.888888.com/topic_reply_map.json
设置 Webhook
Webhook 地址示例：
https://bot.888888.com/webhook.php
设置方式：
https://api.telegram.org/bot你的BOT_TOKEN/setWebhook?url=https://bot.888888.com/webhook.php
返回：
{"ok":true,"result":true,"description":"Webhook was set"}
说明设置成功。
上一篇：TG双向机器人功能简介
下一篇：TG双向机器人使用方法