企业官网建设流程全解析

客户聊天记录散在企微里，销售离职带不走，管理层想复盘也调不出来。我们把聊天记录同步到自己的业务平台，做成可查、可检索、可留存的客户资产。

同步用的是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", headers=HEADERS, 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 去重保证不重。同步之后客户沟通史成了企业资产，销售离职带不走，管理者能复盘，这才是同步的意义。