智能客服与工单系统搭建实录：Telegram自动回复机器人部署笔记

声明：本文仅供技术学习参考，不构成任何投资建议或运营指导；任何实际部署必须遵守当地法律法规，禁止用于任何违法违规用途。

最近帮客户把一套开源客服机器人从测试机搬到正式环境。需求不复杂：Telegram 上能自动答疑，复杂问题转工单，客服能在后台接管。原来那套统计脚本只能看消息量，真到接待就露馅。这次我按智能客服与工单系统的思路重搭，顺手把部署坑记下来。

功能实测：自动回复、工单、人工接管怎么串起来

1. 自动回复不是关键词堆砌

后台先建 FAQ 库，支持分类、命中次数、启停。Bot 收到消息后先走菜单按钮，再走关键词，最后用相似度匹配，阈值我设 0.72。低于阈值不硬答，直接生成待处理工单。实测比纯关键词少很多答非所问。

2. 工单流转看状态机

工单表就几个字段：ticket_id、user_id、group_id、status、assignee、created_at、updated_at。状态只允许 open→pending→closed，人工接管时加锁，客服点“接手”后 Bot 暂停自动回复，释放后恢复。重复推送用 update_id 做唯一索引，避免一条消息建两张单。

3. 后台控制和数据导入

后台是独立管理端，能看会话、工单、客服绩效和关键词命中。FAQ 和工单历史支持 CSV 一键导入，字段映射在页面上选，不用改代码。导入前统一 UTF-8，时间字段用 ISO 格式，能省一半排查时间。

亮点提示：人工接管状态建议放 Redis，设置 30 分钟无操作自动释放，不然客服下班后用户一直收不到自动回复。

部署要点：环境、Webhook 和权限

环境组合

我用的 Ubuntu 22.04，2 核 4G，PHP 8.1 + MySQL 8.0 + Redis。Nginx 反代到 127.0.0.1:8080，SSL 必须上，Telegram Webhook 只认 HTTPS。Bot Token 放 .env，别写进前端。队列用 Redis，消息先入队再处理，重启服务不丢消息。

Webhook 踩坑

第一次设 Webhook 忘了加 secret_token，结果被扫描器打到接口，日志一堆空请求。后来在 URL 里加随机路径，再加请求头校验，世界安静了。还有时区问题，MySQL 用 UTC，后台展示再转本地时区，不然工单时间对不上。

支付接口和二开

如果做付费服务包，支付接口走异步回调，验签、金额、订单号都在服务端二次校验，前端只负责跳转。演示环境可以先关掉支付模块。二开建议走 hook，别改核心文件；多语言用 lang/zh.json、lang/en.json，缺词自动回退中文，别在模板里写死文案。

适合人群和上线建议

适合跨境小团队、SaaS 售前咨询、社群客服这种消息量不大但需要留痕的场景。日消息 5000 条以内，2C4G 够用；再往上先把 Redis 和 MySQL 拆开。上线前跑三天灰度，重点看三件事：自动回复命中率、工单重复率、人工接管释放是否正常。权限别偷懒，admin 和 agent 分角色，导出和删除操作单独记日志。