开发者文档中心

OpenAPI进入控制台

Web / H5 · 2026-10-31

消息、人工转接与历史

同一套消息 API 供 Web 无 UI 客户端和小程序客户端使用。

下载接入包

方法说明

方法返回 / 行为注意事项
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.stateai / human / waiting / closed
view.messagesid、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.ts
  • sdk/wechat-miniapp/index.js

文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。