多商户AI客服系统源码支持多平台扫码聊天下载与搭建教程
源码介绍
多商户+扫码聊天，这套系统到底解决什么问题
先把这个场景说透：一个平台方想同时服务几十上百个商家，每个商家有自己的客服和访客，访客不需要下载App，扫一个二维码就能直接进入对应商家的聊天窗口。彩虹源码网（www.yuanmaz.com）这次整理的多商户AI客服系统，核心能力就在这两条线上——商户隔离和扫码即聊。后台可以无限添加商户和坐席，每个商户有独立的客服入口、独立的数据空间；访客侧通过二维码或专属链接进入，系统根据链接里的商户标识自动路由到对应商户的客服池，不会串到别家去。AI部分负责在人工不在线或高峰时段做知识库自动应答，常见问题在前两级匹配里就能解决，不需要每条都转人工。这套组合适合平台型建站、多品牌客服托管、或者想以SaaS方式对外提供客服能力的场景。
扫码聊天在技术上是怎样跑通的
扫码聊天听起来简单，底下是三层东西在配合。第一层是入口生成：后台为每个商户或指定坐席生成专属二维码和聊天链接，链接里携带商户标识参数（常见是merchant_id或类似字段）。第二层是路由隔离：访客扫码打开H5页面后，系统读取参数，把会话绑定到对应商户，数据表或查询条件按商户维度隔离。多商户隔离的常见做法有两种：一种是用ThinkPHP的动态域名绑定，给每个商户分配子域名，数据库按subdomain字段分表；另一种是统一域名下用merchant_id参数做逻辑隔离，H5入口在会话初始化时把商户标识注入session。第三层是长连接通信：聊天窗口通过WebSocket或Workerman维持长连接，消息实时推送到商户客服端和访客端。扫码只负责“把人带进门”，真正让聊天不卡壳的是后面的长连接进程，这也是部署时最需要盯住的一环。
多商户和无限坐席，后台结构长什么样
多商户系统的后台不是“一个后台管所有”，而是平台管理端 + 商户独立后台的双层结构。平台端负责开通商户、分配域名或入口、查看全局数据；每个商户登录自己的后台，管理自己的坐席、客服分组、知识库、快捷回复和访客记录。坐席数量在代码层面不设硬上限，新增坐席就是往坐席表插记录，不涉及额外的表结构变更。AI知识库同样按商户隔离，A商户上传的问答对不会串到B商户的回复里。这种隔离设计在同类多商户客服源码里是标准做法，但具体字段命名和表结构因打包来源而异，拿到包后对着后台菜单和数据库表逐项确认，比直接套用其他版本的路径更稳。
多平台接入的方式，不止二维码一种
“支持多平台扫码聊天”里的“多平台”，落到源码层面通常是这几种入口并存：二维码扫码进入（H5聊天窗口，适配手机和平板）、专属聊天链接（可以放在网页按钮、公众号菜单、文章内嵌里）、JS代码嵌入（在网页右下角挂客服图标，点击唤起聊天窗口）。部分版本还支持公众号、小程序、APP的接入配置，但核心链路是一致的：不同入口最终都指向同一个商户隔离的会话系统。二维码和链接的好处是不依赖特定平台的开放API，任何能展示图片或链接的地方都能用；如果对接抖音、快手等平台的官方客服授权，则需要走各自的开放平台扫码授权流程，那属于平台侧的接入配置，不是这套源码本身能单方面完成的。
AI自动回复的匹配逻辑，决定它是“能用”还是“好用”
AI客服的价值不在于“接了某个大模型”，而在于答案能不能在合理的时间内命中用户的问题。同类多商户客服源码的机器人匹配通常采用分层策略：第一级精准匹配，用户输入与知识库问题完全一致时直接返回答案；第二级关键词模糊匹配，提取问题中的关键词，在知识库的keywords字段中做LIKE查询；第三级AI兜底，前两级都没有命中时，调用配置的AI接口或图灵类API生成回复。实测数据显示，前两级可以解决大部分常见问题，把AI调用成本压下来，也减少等待时间。知识库的维护方式通常是“关键词—回复内容”的配对，回复内容支持文字和图片。这套逻辑在源码里是否完整保留，取决于你拿到的包；有些整理版只留了前两级，AI兜底被注释或删掉，部署后测试一下“知识库有明确答案”和“知识库没有答案”两种输入，就能判断AI链路是否通了。
功能边界与部署形态
这套源码是PHP + MySQL的整站系统，常见框架组合是ThinkPHP5/6 + Workerman或Swoole，源码大小在35MB级别，完全开源，免授权。它不包含大模型训练、语音识别引擎、视频客服和商业级高并发架构，AI能力依赖你在后台配置的API接口或知识库数据。部署需要Linux服务器（独立主机或VPS），宝塔面板安装Nginx、PHP 7.2–7.3、MySQL 5.6，Workerman或Swoole作为常驻进程运行，不是上传到虚拟主机就能直接用的纯PHP站点。
源码展示
目录结构：ThinkPHP骨架 + Workerman常驻进程
源码解压后能看到ThinkPHP的标准目录结构：application（业务模块，商户端、客服端、访客端的控制器和模型）、public（入口文件和前端静态资源）、config（数据库和系统配置）、route（路由规则，商户隔离的动态域名绑定通常写在这里）。Workerman相关的启动脚本一般在根目录或server目录下，常见文件名是start.php或server.php，需要在命令行手动启动，不是随Nginx自动拉起。前端聊天窗口的静态文件通常在public下的独立目录中，二维码生成和链接拼接的逻辑在商户后台的控制器里。
商户后台与平台后台的入口分离
平台管理端和商户端通常使用不同的入口路径或不同的登录账号体系。平台端负责开通商户、配置全局参数、查看所有商户的会话统计；商户端登录后只看到自己的坐席、知识库和访客数据。后台登录地址和默认账号密码在源码包说明中给出，登录后第一件事是修改默认凭据和后台路径。部分版本支持商户自助注册，平台审核后开通，具体流程以包内后台菜单为准。
扫码链路的关键代码位置
二维码和聊天链接的生成逻辑，通常在商户后台的“接入设置”或“渠道管理”模块里。代码层面，系统会根据当前商户的标识（商户ID或子域名）拼出带参数的聊天URL，再将URL生成二维码图片。访客打开这个URL后，H5页面在初始化会话时会从请求参数中读取商户标识，写入session或直接带入接口查询，后续的会话查询、消息发送都基于这个标识做数据隔离。修改入口样式或二维码落地页时，优先改前端模板和样式文件，不要动参数传递逻辑，否则可能导致会话串商户或无法建立连接。
搭建教程
1. 环境：CentOS + 宝塔 + PHP 7.2–7.3 + MySQL 5.6
同类多商户客服系统的标准环境是Linux（CentOS 7.6–8.0）、Nginx、PHP 7.2–7.3、MySQL 5.6，服务器建议2核4G起步。PHP需要安装fileinfo、redis（如果源码使用Redis做缓存）和pcntl、posix（Workerman/Swoole常驻进程依赖）扩展。PHP 8不在推荐范围内，ThinkPHP5和Workerman的旧版本在PHP 8下兼容性不稳定。宝塔安装后放行客服端口和WebSocket通信端口，云服务器安全组同步开放。
2. 上传源码、设运行目录、配伪静态
源码上传到网站根目录解压后，运行目录设为public（ThinkPHP的标准入口位置）。伪静态选择thinkphp规则，保存后重启Nginx。如果首页能打开但后台或聊天页面404，先确认运行目录和伪静态，这两个是ThinkPHP项目最常见的部署卡点。数据库连接信息写入config/database.php，填主机、库名、用户名、密码。
3. 导入数据库，启动Workerman常驻进程
按源码包内的SQL文件导入数据库。然后进入Workerman启动脚本所在目录，在命令行执行启动命令（常见形式为php start.php start -d，以包内说明为准）。正常启动后会看到进程监听端口的输出。Workerman不启动，聊天消息无法实时推送，前台表现是页面能打开、能登录，但发消息没有反应或一直转圈。启动失败优先检查pcntl和posix扩展是否安装、端口是否被占用、PHP版本是否匹配。如果源码使用的是Swoole而不是Workerman，启动方式和扩展要求不同，以包内文档为准。
4. 后台基础配置与商户开通
登录平台管理后台，修改默认密码和后台路径。然后开通一个测试商户，为商户创建至少一个客服坐席，进入该商户后台配置知识库（添加几条“关键词—回复内容”的问答对）、快捷回复和客服分组。知识库是AI自动回复的数据基础，空知识库的机器人在测试时不会产生有意义的回复，这是正常现象，不是AI功能坏了。
5. 生成二维码，走一遍“扫码→聊天→人工接管”
在商户后台的接入设置中生成二维码或聊天链接，用手机扫码打开H5聊天窗口。发送一条知识库中已配置的问题，观察是否返回预设答案；再发送一条知识库未覆盖的问题，观察AI兜底是否响应（如果该版本启用了AI接口）。然后在客服端后台以坐席身份接管会话，回复一条消息，确认访客端能实时收到。这条链路跑通，才算真正验证了“扫码聊天 + AI + 人工”的完整流程。测试时同时开两个不同商户的二维码，交叉扫码确认会话不会串到对方商户，验证隔离生效。
6. 常见问题排查
扫码后页面空白或无法建立会话：查二维码链接中的商户标识参数是否完整、H5入口的接口地址是否指向正确域名。消息发送无响应、不实时：查Workerman/Swoole进程是否在运行、WebSocket端口是否放行、浏览器控制台是否有连接报错。AI不回复：查知识库是否已添加问答、机器人开关是否开启、AI接口（如果使用）是否已配置有效密钥。不同商户数据串了：查商户隔离字段（merchant_id或子域名）在会话查询条件中是否生效，不要急于改代码，先确认入口参数和数据库记录。
源码下载
🔥永久赞助9.9(高速下载/无广告/无转存)
✅网盘下载(下载限速/需要转存/有广告)
包里有什么，没什么
下载包通常包含ThinkPHP后端、Workerman或Swoole启动脚本、商户端和客服端前端、H5聊天窗口、数据库SQL和安装说明，源码大小在35MB左右，完全开源。不包含商业级大模型训练、语音识别引擎、视频客服和官方技术支持。AI能力依赖知识库数据和你在后台配置的第三方AI接口，源码本身不内置模型。不同来源的包在AI兜底是否启用、多语言支持范围、后台菜单完整度上可能存在差异，下载前确认包内是否包含完整的启动脚本和SQL文件。
上线前的准备
先在测试服务器完成商户开通、坐席创建、知识库配置和扫码聊天全链路测试，确认消息实时和商户隔离正常后再部署正式环境。上线前修改默认后台凭据和路径、扫描application和public目录中的可疑文件、确认Workerman进程已配置为守护运行（避免服务器重启后聊天服务中断）。多商户客服系统涉及访客聊天数据，隐私和内容合规需自行把握。
免责声明：本文源码介绍与教程由彩虹源码网（www.yuanmaz.com）整理发布，仅供PHP和即时通讯技术学习及合法客服系统搭建参考。多商户AI客服系统涉及用户通信数据和商户隔离，运营者须自行确保数据安全和内容合规。流传版本的安全性与功能完整性需自行审计，本文不构成对任何特定源码包可用性和安全性的保证。不得用于侵权、违规采集或未经许可的商业分发。
觉得内容不错？我要
