会话存档|想把企微数据接到自己的 CRM?先弄清开放平台的边界(会话存档的三个步骤) ypxx.net

上周一个客户提了个需求,很有代表性:把企业微信里的聊天记录全部同步到自研 CRM,再让公司 AI 重新读一遍,判断员工有没有违规。

需求合理,但用企小码开放平台做不到——不是功能不够,而是边界问题。

今天就把开放平台能做什么、不能做什么,一次说清楚。

先划边界:这四类内容拿不到

第一,聊天原文和完整上下文。 开放平台不同步聊天记录,也不支持外部 AI 重新阅读原始对话来做判断。

第二,原始消息里的附件。 文件、图片、语音、视频都不提供文件流。

第三,客户联系方式。 手机号、微信号、客户头像、群头像均不在开放范围——客户标识不等于手机号或微信号,别指望靠接口补齐资料。

第四,AI 的主动调用。 开通 AI 分析结果权限,只能读取已有分析结果,不能调用模型分析新内容。

还有两条容易被忽略:开启某类数据权限 ≠ 能拿到后台页面的全部内容,接口不会自动产生原本没有的数据;外部系统的筛选结果也不会回写企小码,不会自动关闭企小码原有通知。

再谈能力:七类数据,三个典型场景

开放平台可以输出七类业务数据:客户、客户群、员工标识、风险、超时、统计、已有 AI 分析结果。落到实际业务里,最常见的用法有三种:

同步客户到 CRM。 客户标识、名称、企业、来源、归属员工、标签、跟进状态一并带出,在 CRM 里和既有客户记录关联,销售不用在两套系统间反复查。

风险和超时进 BI 看板。 风险事件的类型、命中规则、等级、审计状态,超时的规则、时长、回复状态,再加各类数量、趋势、分布和排行——经营报表和服务质量报表直接取数。

让工单系统接住风险事件。 工单系统接收风险和超时事件后继续流转,谁处理、处理到哪一步,在企业自己的流程里闭环。

怎么接:五步跑通

第一步,先明确需求。 接哪个系统?要哪些数据?多久同步一次?开发前先拿到对应版本的接口文档。

第二步,创建应用并保存凭证。 路径「系统设置 → 开放平台 → API 应用」。建议不同接入系统分别建应用,名称体现用途,如"CRM 客户同步""BI 风险看板"。创建后复制 App ID 和 App Secret——Secret 完整值只展示一次,交给技术人员安全配置。

第三步,配置数据权限。 只授权实际需要的对象:CRM 要客户和风险状态,BI 要客户、风险、超时指标,按需勾选。

第四步,配置 IP 白名单。 填接入系统服务器的公网出口 IP,不是管理员电脑的内网 IP;服务器迁移后记得同步更新。

第五步,小批量验证再放量。 先发起一次查询,到「调用日志」看结果,核对字段、业务对象、时间范围都对,再安排日常同步。批量数据分批处理,别高频重复查询。

特别提醒:仅在后台创建 API 应用,不会自动同步任何数据。 管理员负责建应用、授权;技术人员负责开发调用、保存数据和联调。应用显示"启用中",调用仍受凭证、权限、白名单和频率的多重约束。