25 lines
2.1 KiB
Markdown
25 lines
2.1 KiB
Markdown
# 微信客服接入
|
||
|
||
## 已配置
|
||
|
||
- 企业ID：`wwf8bbe2cad2e9e84b`。
|
||
- 官方客服链接：`https://work.weixin.qq.com/kfid/kfc5a57c84cb0feb2fd`。
|
||
- 统一入口：`src/services/customerService.ts`。这两个参数为公开入口信息，不是企业Secret或访问令牌。
|
||
- “我的→联系我们”和首页／元素未绑定提示中的“联系我们”共用该入口。
|
||
|
||
小程序点击时直接调用 `Taro.openCustomerServiceChat({corpId, extInfo: {url}})`，不先等待网络请求，保留微信要求的用户点击上下文。不跳转项目里的模拟聊天页，不发送用户资料或自动发送聊天消息，不连接自建聊天后端。
|
||
|
||
H5仅提示“请在微信小程序中联系客服”；不支持的微信版本提示更新；接口失败提示重试；用户取消不报错。连续点击去重，完成或失败后可再次点击。不配置企业Secret，不开启API消息接管或消息回调。
|
||
|
||
## 管理员配置及真机验收
|
||
|
||
1. 在微信公众平台的小程序后台，确认客服设置已绑定上述企业ID；企业微信中确认该客服账号已启用并添加接待人员。
|
||
2. 微信开发者工具导入项目，重新编译当前 `dist`，再使用微信真机预览或体验版测试。H5提示正常不代表官方客服已可用。
|
||
3. “我的→联系我们”：预期进入对应微信客服会话。人工发送一条测试消息，企业微信接待人员应能收到并回复。
|
||
4. 未绑定神仙时，在首页或“我的元素”的绑定提示点击“联系我们”：应进入同一个官方客服，不弹“入口待配置”，不进入模拟聊天页。
|
||
5. 如提示打开失败，先检查企业ID关联、客服链接及账号启用状态，再检查微信版本和主体资质是否满足后台要求。不要把Secret或密码发到聊天。
|
||
|
||
## 边界
|
||
|
||
本次只接入官方客服入口，无新增HTTP业务接口，不修改后端或企业微信管理后台，不购买服务、不自动向客服发送消息。真实客服可用性需管理员配置和真机验收，本地测试不替代该验收。前一条被中断的8张神仙图片压缩上传及数据库更新，本次未执行。
|