ThinkPHP6.x 在线客服：集成第三方客服系统与历史消息存储-ThinkPHP-PHP中文网

应集成腾讯云智服sdk或welive js方案，并建mysql消息表、配redis缓存及gatewayworker队列。具体包括：配置tencentcloud sdk；嵌入welive脚本；建customer_messages表并生成模型；用redis缓存5条上下文；以gatewayworker解耦高并发消息。

thinkphp6.x 在线客服：集成第三方客服系统与历史消息存储

如果您正在使用ThinkPHP6.x开发在线客服系统，但面临第三方客服系统集成困难或历史消息无法持久化保存的问题，则可能是由于SDK配置缺失、消息表结构不匹配或未启用消息存储逻辑。以下是解决此问题的步骤：

一、集成腾讯云智服SDK

腾讯云智服提供标准化小程序端接入能力，通过引入轻量级SDK可绕过自研通信层，直接复用其消息路由与会话管理能力。该方式适用于需快速上线且对数据主权要求不极端严格的场景。

1、登录腾讯云控制台，在【智服】产品页创建新实例，获取AppID、Secret及WebSocket接入域名。

2、在ThinkPHP6项目根目录执行命令安装官方SDK：composer require tencentcloud/tcsdk。

3、在config/tencentcloud.php中配置参数，确保region设为ap-guangzhou，timeout不低于5秒。

4、于小程序前端调用TCSdk.init()并传入AppID与用户OpenID，后端通过TencentCloud\TcSdk\Client::sendMessage()透传消息至智服工作台。

二、对接WeLive客服系统JS嵌入方案

WeLive采用纯前端注入模式，无需修改ThinkPHP6后端业务逻辑，仅需在客服页面HTML中嵌入指定脚本即可完成对接。适用于已有成熟客服团队、仅需补充线上触点的中小企业。

1、访问http://im.68ying.com/admin/login/index.html，使用账号在线客服2018与密码123456登录WeLive后台。

2、进入【站点管理】→【添加站点】，填写您的ThinkPHP6项目域名，获取唯一site_id。

3、在ThinkPHP6视图模板中（如public/static/kefu.html），插入WeLive提供的标准JS代码块，其中data-siteid属性替换为上一步获取的值。

4、启动ThinkPHP6内置服务器后，访问该页面，确认右下角出现WeLive悬浮客服按钮，并能正常发起会话。

三、构建MySQL消息持久化表结构

为保障对话记录可审计、可追溯，必须在MySQL中建立专用消息表，支持按OpenID、时间范围、消息类型多维检索。该表需与ThinkPHP6模型层严格对齐，避免ORM操作异常。

1、执行以下SQL语句创建customer_messages表：CREATE TABLE `customer_messages` (`id` int(11) NOT NULL AUTO_INCREMENT, `openid` varchar(50) NOT NULL, `message_type` varchar(20) NOT NULL, `content` text, `create_time` datetime NOT NULL, PRIMARY KEY (`id`)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;