客户聊天记录散在企微里销售离职带不走管理层想复盘也调不出来。我们把聊天记录同步到自己的业务平台做成可查、可检索、可留存的客户资产。同步用的是Eyun 平台开放的企微 API凭证在Eyun 平台首页开通历史拉取走 message/getHistoryMessageList增量靠 Webhook。两个数据源历史记录调 message/getHistoryMessageList 分页拉首次同步把存量记录补齐。实时增量Webhook 推 message 事件每来一条落一条。def sync_history(appid, conversation_id): cursor None while True: resp requests.post( f{BASE}/wx-api/api/message/getHistoryMessageList, headersHEADERS, json{appid: appid, conversationId: conversation_id, cursor: cursor, limit: 200} ).json()[data] for msg in resp[list]: upsert_message(msg) # 按 msgId upsert天然去重 if not resp[hasMore]: break cursor resp[nextCursor]两个来源合在一起既有存量也有增量缺一个都不完整。字段和分页参数在开发文档里有完整说明。避免重复历史拉取和实时回调可能覆盖同一条消息。用 msgId 做唯一键入库时 upsert重复的直接忽略。这样两个来源可以放心叠加不用做复杂的去重逻辑。存储设计两张表会话表conversation_id、客户 uin、员工 uin、最近消息时间和消息表msg_id、conversation_id、方向、类型、内容、时间。会话表按 conversation_id 聚合消息表存明细。会话聚合单聊的 conversationId 是客户 uin群聊是 roomId。按 conversationId 把消息聚成会话业务平台展示时先看会话列表点进去看消息明细。检索消息表对内容字段建索引支持按客户、按时间段、按关键词查。销售要复盘某个客户的沟通史输入客户名就能拉出全部记录。留存与合规聊天记录涉及客户隐私留存要有边界只存业务相关的会话敏感字段手机号中间位做脱敏设一个留存期限到期归档或清理。留存策略写进数据规范不只靠代码控制。接口字段在开发文档里有完整说明。结尾聊天记录同步的关键是全和准——历史加实时保证不漏msgId 去重保证不重。同步之后客户沟通史成了企业资产销售离职带不走管理者能复盘这才是同步的意义。