企业微信会话管理API：会话列表、消息同步与客服工作台

1. 引言「企业微信会话API」「企微聊天记录对接」「企业微信客服工作台」要解决的是坐席在自建系统里看到客户会话而不是只在手机企业微信里翻。会话层是 SCRM 工作台的核心。2. 会话层要什么会话列表最近联系人、未读、最后一条历史消息展示文本/图片/文件实时新消息Webhook 增量坐席回复调用发消息接口会话分配、转接、备注数据来自QIWe API的会话模块与消息模块。工作台必须按坐席和guid过滤防止串数据。3. 推荐同步策略不要每次打开页面都全量拉历史。用 Webhook 做增量本地落库图片文件按需下载首次打开某客户再补一段历史。Webhook 新消息 → 写入 message 表 → 更新 conversation.last_msg_at 坐席打开会话 → 读本地库 坐席点击发送 → QIWe API → 写自己的出站消息也要幂等4. 工作台权限按owner_seat过滤客户主管可看团队离职客户走继承流程后再允许新坐席发送。所有出站必须留操作人。会话与消息相关 method对照 QiWe API文档https://doc.qiweapi.com/。先做到「回调能写进列表、坐席能回一条」。5. 文件与图片列表里不要直接塞二进制。存资源 ID 或下载任务点击再拉。下载失败要可重试并注意客户隐私访问需登录态。6. 注意点回调重推导致重复气泡用 msgId 去重坐席连点发送前端防抖 后端幂等键QIWe API掉线时工作台应明确提示「设备离线」不同设备的聊天记录不要混进同一条会话时间线而不标来源7. 总结企业微信会话管理二次开发的目标是把企微通道变成可分配、可审计的坐席工作台。会话模块只提供数据分配规则在你的业务里。