必须微信后台、云函数/后端、uni-app前端三端联动配置,缺一不可:微信后台需配置HTTPS消息推送URL、Token和43位EncodingAESKey;云函数须实现签名验证、XML解密及客服消息接口调用;前端需校验基础库版本≥2.10.4、使用条件编译且extInfo.url须在小程序后台审核通过。

不能只在 uni-app 前端配,必须完成「微信后台配置 + 云函数/后端服务 + 前端唤起」三端联动,缺一不可。前端 uni.openCustomerServiceChat 只负责打开窗口,不参与消息收发逻辑。
微信公众平台必须填对三项服务端配置
微信要求你提供一个能被它主动调用的 HTTP 接口地址,所有用户消息都经此入口推送过来。配置位置:「开发管理 → 开发设置 → 消息推送」。
-
URL:必须是 HTTPS 地址,指向你的云函数或后端(如https://xxx.bspapp.com/http/customerservice),不能是本地 localhost 或 http -
Token:自定义字符串(如mytoken123),后续云函数校验签名时要用到,需保持一致 -
EncodingAESKey:微信生成的 43 位随机字符串(含大小写字母和数字),务必完整复制保存,漏一位都会导致解密失败 - 加密方式建议选「安全模式」,明文模式已逐步弃用,且不适用于生产环境
云函数必须实现签名验证 + 消息解密 + 客服接口调用
微信服务器每次推送消息前,会先 GET 请求你的 URL 校验连通性(带 echostr 参数),之后才 POST XML 消息体。云函数要分两步处理:
Windows 微信自动发送工具。支持搜索微信联系人并发送文字、图片、文件和**批量文件**。通过 GUI 自动化控制微信窗口,无需微信开放接口。触发场景: 离开电脑时,远程指令OpenClaw发送图片/文件给微信联系人。条件: 微信打开并登录(允许最小化)。举例:1、把桌面上的龙虾图片发送给张三(默认微信发送);2、查找D盘最新的报价单Excel表并发送给李四(默认微信发送);3、搜索报价单并批量发送给联系人。
- GET 阶段:用
Token、timestamp、nonce拼接后 SHA1 加密,比对signature参数是否一致;一致则原样返回echostr - POST 阶段:读取
event.body(XML 格式),若启用了加密,需用EncodingAESKey解密;再解析出FromUserName、MsgType、Content等字段 - 调用客服消息接口前,必须先通过
getAccessToken获取有效access_token,且每 2 小时需刷新,硬编码会失效 - 回复示例(POST 到
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=xxx):{ "touser":"oAbc1234567890", "msgtype":"text", "text": { "content":"您好!请问有什么可以帮您?" } }
前端唤起客服会话有硬性限制
uni.openCustomerServiceChat 不是万能按钮,它只打开聊天窗口,无法自动发消息,也不能监听用户输入。
- 必须校验基础库版本:调用前用
uni.getSystemInfo取SDKVersion,语义化比较是否 ≥2.10.4,字符串直接比大小会出错 -
extInfo.url必须是小程序后台「客服管理 → 客服链接」中已添加并审核通过的 HTTPS 地址(如https://xxx.com/kefu),未配置或配置后未生效(缓存延迟 5–10 分钟)都会报fail: invalid url - 仅限
MP-WEIXIN平台,App 和 H5 调用无效,必须用#ifdef MP-WEIXIN条件编译包裹 - 无法自动发送欢迎语——这是微信限制,不是代码问题;所谓“自动回复”实际是后端监听到
user_enter_tempsession事件后,立即调用客服消息接口推一条消息
最容易被忽略的是 EncodingAESKey 的长度和字符集(必须 43 位,含大小写+数字),以及 access_token 的时效性管理——很多线上故障就卡在这两个点上。










