客服网页 + Telegram 群客服系统部署在宝塔/Nginx/PHP 8.1+/MySQL 5.7+ 的轻量客服系统,访问 /install.php 安装;访客前台 /kf/、后台 /admin/,客服在 Telegram 群按话题接待。同一 IP 复用会话、消息全部落库,支持单文件 500MB 分片上传、Web Push 推送与 PWA 深色模式。
这是一套可直接部署在 宝塔 / Nginx / PHP 8.1+ / MySQL 5.7+ 上的轻量客服系统,搭建时访问域名 /install.php 安装即可;也可让 AI 添加微信公众号对接通知、QQ 机器人通知,并嵌套网页版,具体按自身需求修改。
访问入口
- 访客前台:
/kf/ - 管理后台:
/admin/ - 客服工作台:Telegram 群
Telegram 群客服工作流
- 每位访客首次发消息自动创建独立 TG 话题;话题第一条显示 IP、浏览器、系统、设备、来源。
- 话题内后续客户消息只显示客户原文,不再重复发送「新消息 / IP / 时间」抬头。
- 话题首条信息带「拉黑此访客 / 取消拉黑 / 禁言」按钮;拉黑后访客网页显示会话暂停,无法继续发送。
- 客服在话题内直接发消息,或「回复」机器人推送,网页实时收到;也支持
/r 会话号 内容。
会话、消息与界面
- 同一个 IP 自动复用同一个会话,消息全部落库;按保留天数自动清理。
- 访客浏览器持有随机 token,可在 IPv4 / IPv6 双栈切换时恢复同一会话;换浏览器且换 IP 才会新建。
- 图片、视频、音频、压缩包、文档等任意格式,单文件最大 500MB(分片上传)。
- 关键词自动回复、输入框快捷按钮,均可附带媒体。
- 界面为 iOS 风格 UI,支持深色模式、PWA、移动端安全区。
通知与声音
- 首次进入自动弹出通知引导;授权后新消息有系统通知、页面内顶部横幅、提示音。
- 支持 Web Push,页面关闭 / 切后台仍可收到系统推送。
内置浏览器兼容
- 微信、抖音、QQ 等内置浏览器通常不提供系统通知 / Web Push,页面会提示复制链接到 Chrome / Safari 打开。
- 页面内横幅与提示音仍然可用。
体验优化清单
- 首屏骨架屏 + 本地乐观发送,弱网也不空白。
- 4MB 分片上传 + 自动重试 + 取消,避免大文件中断。
- 图片懒加载、视频 Range 流式播放,节省流量。
- 智能滚动:用户在底部才自动跟随,否则出现「新消息」浮标。
- 网络断开提示、自动重连、会话失效自动恢复。
- PWA 添加到主屏幕、Service Worker 通知点击回到会话。
- iOS 风格气泡、毛玻璃、深色模式、
prefers-reduced-motion。 - 移动端安全区适配、键盘弹起高度适配、16px 输入字号防缩放。
- 管理后台会话 5 秒增量刷新、未读角标、搜索与筛选。
- 后台所有写操作 CSRF 校验、登录限流、会话过期自动跳转。


