消息、人工转接与历史
同一套消息 API 供 Web 无 UI 客户端和小程序客户端使用。
下载接入包
- Web / H5
含原版渠道 iframe 示例及无 UI 客户端。复用完整渠道外观请选择 web/voice-example.html 或渠道嵌入代码;无 UI 客户端需自行绘制界面。
- 微信小程序
默认 web-view 复用原版渠道页面,需业务域名;另含原生聊天与语音替代组件,按各自能力与权限完成真机验收。
方法说明
| 方法 | 返回 / 行为 | 注意事项 |
|---|---|---|
| connect() / refresh() | Promise<State>;建立 / 读取当前会话 | 初始化不应自动发送客户问题 |
| sendText(text, mediaIds?) | Promise<View>;文字最多 2000 字 | 附件先 upload,按服务端消息 ID 去重 |
| handoff() | Promise<View>;请求人工 | waiting 不等于客服已接管,需验证真人回复 |
| loadEarlier() | Promise<State>;更早历史 | before 游标,每页最多 100;不读其他访客 |
| end() / restart() | Promise<View> / Promise<State> | 未知写入保留 pending;不要自动创建新身份 |
| setChatVisible(bool) / markRead() | 前台未读与已读 | 首次历史不计未读,不是离线推送 |
关键状态
| 字段 | 含义 |
|---|---|
| view.state | ai / human / waiting / closed |
| view.messages | id、role(customer / ai / service)、text、time、media |
| view.hasMore / view.before | 当前会话分页信息;不要替换成通用 page/pageSize |
| pending(数组) | 每项含 action、operation、text、inFlight、received;结果可能待核对 |
| unread / error / storageError | 前台未读、错误信息与本地存储失败;不含访客 token |
渲染与对账
客户消息进入记录不代表 AI 已完成回答。刷新后按消息 ID 合并,逐项检查 state.pending.find(p => p.action === "message")?.received,区分已收取与未确认。转人工后由服务端所有权控制 AI 外发。用户关闭界面也不等于结束服务端会话。
实现依据 · 仓库内路径
sdk/wechat-miniapp/index.d.tssdk/wechat-miniapp/index.js
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。