版本更新记录

本文记录开发文档中的接口契约与接入说明调整，不替代应用程序的发布公告。接入方应在升级前检查受影响页面的请求字段、实时事件与认证说明。

2026-07-25（补充）

• 补全 WebSocket 连接、事件合并、后端推送频道与失败恢复说明。
• 补全 Web 访客 Token 的字段、服务端签发与安全边界。
• 补全访客 SDK 的平台入口、Token Provider 和资料/上下文说明。
• 补充统一错误处理、重试与日志脱敏建议。

2026-07-25

• 建立 Web 接口目录。
• 完成访客端主流程、客服端会话与消息主流程的单接口页面。
• 明确访客 Token 鉴权、统一响应结构与 WebSocket 事件约定。

文档更新原则

• 接口字段、响应示例和事件名称以当前控制器、Web 页面与 SDK 契约为准。
• 可配置数据使用占位符或运行时说明，不在文档中写入真实商户、用户、密钥或 Session。
• 行为变化会优先更新对应接口页、实时事件页与 SDK 页面，再补充本页记录。