AIKE 智能客服 — 开发者文档

面向集成与二次开发：嵌入式组件接入、WebSocket 推送、常用 API 与扩展约定。

一、嵌入式接入客服按钮

在官网 <head> 或 <body> 引入客服 JS，配置 business_id 与主题色即可上线。

最小示例

<script type="text/javascript">
  var ymwl={};
  ymwl.visiter_id='';
  ymwl.visiter_name='';
  ymwl.avatar='';
  ymwl.product='{}';
</script>
<script src="https://你的域名/assets/front/ymwl_1.js?v=1784834922"></script>

实际脚本路径以部署包为准；HTTPS 站点请同步配置 WSS。

二、WebSocket 协议要点

实时通道由 aike_pusher（Workerman）提供，默认端口：

WebSocket：456
Pusher HTTP API：2080

Nginx WSS 反代

生产环境将 wss://域名 反代到本机 456，并正确设置 Upgrade 头。详见《安装部署文档》。

三、常用集成路径

场景	建议路径
官网挂载	嵌入式 JS + business_id
移动 H5	独立接待页或同一组件自适应
服务端推送	PHP 调用 Pusher API（2080）
语义检索	部署 Qdrant + 后台 Embedding 配置

向量检索

执行 bash install_qdrant.sh 后，在知识库插件中配置 Embedding 与阈值即可启用。

四、插件与扩展

业务扩展优先走后台配置与现有 Service 边界，避免硬编码行业话术
新增可运营参数：先加后台字段，再在服务层读取
调试建议保留请求日志与唯一前缀，上线前清理临时埋点

安全注意

不要把后台密钥、数据库账号提交到前端仓库
对外 API 需鉴权与限流，避免开放未授权推送接口

五、联调清单

推送服务 php start.php status 正常
浏览器控制台无 WS 连接失败
访客发消息客服端即时收到
AI 回复可按策略触发，转人工可用

打开演示站社区技术文章