使用流程

顾客侧

顾客向机器人发送：

• 普通文字
• 图片
• 文件
• 数字菜单 1 / 2 / 3 / 4

机器人会：

• 第一次发消息时自动发送欢迎语
• 发送菜单说明
• 将非菜单消息自动转发到客服群固定 Topic

客服侧

客服在固定 Topic 内查看顾客消息。

如果需要回复顾客：

• 必须在 Topic 内回复那条顾客消息
• 机器人会自动把该回复转发给对应顾客

支持回复：

• 文字
• 图片
• 文件

菜单说明

顾客发送：

1

查看价格咨询

2

查看下单流程

3

查看售后帮助

4

请求人工客服

请求人工客服

数据记录说明

welcome_users.json

记录已发送过欢迎语的私聊顾客，避免重复欢迎。

示例：

{
  "7998778355": 1776849785,
  "7365730854": 1776849806
}

topic_reply_map.json

记录群内消息与顾客的映射关系，用于客服回复时回传给正确顾客。

示例：

{
  "16": {
    "user_id": "7365730854",
    "created_at": 1776855000
  },
  "24": {
    "user_id": "7998778355",
    "created_at": 1776855022
  }
}

超过 100 条后，系统会自动删除最旧记录。

日志排查

查看最新日志：

tail -n 30 /www/wwwroot/bot.hdd888.net/log.txt

常见排查点：

• Webhook 是否收到消息
• 群消息是否带 message_thread_id
• 客服回复是否带 reply_to_message
• topic_reply_map.json 是否正常写入

---

注意事项

• 
  
1. 客服回复必须在 Topic 内“回复那条顾客消息”，不能直接随便发一句。
2. 群 ID 和 Topic ID 必须填写正确。
3. 如果更换 Bot Token，需要重新设置 Webhook。
4. 建议定期备份 webhook.php。
5. 当前版本为固定 Topic 版，即所有顾客先进入同一个 Topic。

---

当前版本适用场景

适合：

• 小团队真人客服
• TG 接单咨询
• 虚拟商品/账号业务接待
• 先验证客服流程，再逐步升级