ThinkPHP项目集成客服系统需先确认版本兼容性：TP5.1.x用专用SDK，TP6.0+用think-service-chat扩展；安装后配置appId等参数并注入前端资源，最后添加带正确data-appid的按钮即可成功接入。
在ThinkPHP项目中快速集成客服系统，让访客点击即聊、消息不丢失、后台实时响应。
确认ThinkPHP版本与环境兼容性
打开项目根目录下的composer.json，检查"topthink/framework"的版本号：5.1.x需用ThinkPHP5专用SDK，6.0+必须使用官方推荐的think-service-chat扩展包。
运行php think version命令，终端输出结果必须为v6.1.0+或v5.1.43+，低于此版本【无法加载客服WebSocket连接】，强行安装会导致前端按钮点击无反应。
安装客服插件扩展包
方法一（TP6推荐）：执行composer require topthink/think-service-chat，等待自动完成依赖注入和配置文件发布。
立即学习“PHP免费学习笔记（深入）”；
方法二（TP5手动集成）：下载官方tp5-customer-service压缩包→解压到application/common/service/目录→在application/tags.php中追加'app_init'=>[\common\service\ChatService::class.'@init']。
安装完成后检查vendor/topthink/下是否存在think-service-chat文件夹，缺失说明Composer未成功拉取，需清缓存重试：composer clear-cache && composer install。
配置客服系统基础参数
第一步：编辑config/chat.php（若不存在则新建），填入从客服平台获取的appId、appSecret和serverUrl。
第二步：在config/app.php中启用调试模式：'debug'=>true，否则客服窗口加载时控制台报错Invalid token却无提示。
第三步：将客服前端资源注入模板——在public/static/index.html的</body>前插入：<script src="/static/chat/js/embed.js"></script>，路径必须以/static/开头，写成./static/会导致跨域加载失败。
在页面中调用客服入口按钮
在需要显示客服按钮的模板文件（如index/index.html）里，任意位置添加：<div id="chat-button" data-appid="your_appid_here"></div>。
这一步操作起来很简单，直接把代码复制进HTML区块就行；但注意data-appid值必须与config/chat.php中的appId完全一致，字母大小写错误会导致按钮静默失效。
刷新网页，右下角出现浮动客服图标即表示接入成功。
