企业微信API二次开发：私域 CRM 用客户事件建档打标

私域团队的痛点，经常不是「触达不到」，而是客户进了企微之后状态全靠销售脑子记：谁问过价、谁加过购、谁该回访。群发话术再多，也补不回断掉的跟进链。

企业微信 API 接口二次开发在私域里，更长期的价值往往是事件采集，而不只是自动回复。本文讲怎么用客户相关事件驱动 CRM 建档与打标。

先改预期：先记状态，再谈触达

对 CRM 有用的，通常是这些变化：

• 新客户通过 / 好友新增

• 客户发来咨询（文本）

• 外部联系人资料或标签变更

• 客户删粉 / 关系解除

• 进入某个客户群

有了事件，才能生成任务：今日待回访、待报价、待发资料。没有事件，系统只是一个定时群发器。

最小数据模型就够起步

不必一上来上中台。先有四张逻辑表：

表	存什么
contact	外部联系人 ID、昵称、备注、来源、负责人
tag	意向、阶段、产品线
event	加好友、消息、进群、删粉、转人工
task	待跟进动作与截止时间

Webhook 进线后写 event，再驱动 tag / task。消息自动回可以后接；建档不要等自动回做完才开始。

加好友后的 30 秒比欢迎长文重要

客户关系确认后，建议立刻做三件短动作：

1. 建档：没有 contact 就创建，写上来源（渠道活码、销售工号、活动名）

2. 打底标：如 新好友、未分级

3. 发一个短问题：引导对方说出需求，而不是丢一页说明书

问题越具体，后续标签越好打。例如：「你更想了解课程还是服务套餐？」比「您好欢迎咨询」更容易进入可运营状态。

联系人变更类事件（新增、修改、删除）要单独路由，不要和普通聊天文本共用一套「关键词回复」逻辑。删粉事件应关闭跟进任务，而不是继续群发。

用消息给客户「升温」，不必每条都回

客户每发一条，都可以更新 CRM，哪怕机器人选择静默：

• 提到价格 → 意向分 +1，打 询价

• 提到竞品 → 记竞品字段

• 连续多日活跃 → 进入高意向池

• N 天无互动 → 生成轻量回访任务

这才是事件驱动：聊天发生在企微，状态沉淀在 CRM。企业微信自动化此时更像传感器。

文本消息从回调体读取正文后，先做意图粗分（规则即可），再决定是否进入发送队列。发送仍走统一限速出口，避免 CRM 一激动就并发触达。

标签以 CRM 为准，企微侧按需回写

两套标签别混职责：

• CRM 标签：报表、自动化、权限

• 企微侧备注 / 标签：方便手机端筛选

建议以 CRM 为源，成交、流失等关键状态再回写备注。例如成交后备注带订单号与负责人，手机端一眼能认。回写失败要可重试，但不能阻塞主交易流程。

和销售工作台怎么接才有人用

只在后台多几个字段，销售不会打开。尽量嵌进现有习惯：

• 今日待跟进列表（来自 task）

• 客户最后一句原文（来自 event）

• 一键发资料（创建发送任务，不直调接口）

• 一键转交（改负责人 + 通知）

人工一旦接手，机器人必须静默。否则客户正谈方案，系统还在推活动，事件驱动会反噬信任。

实现时几个容易踩的点

1. 大整数 ID：联系人、群、消息 ID 按字符串或 BigInt 处理，避免精度丢失导致「同一个人建了两条档」。

2. 去重：推送重试与业务重复不是一回事；事件 ID 与业务主键都要有。

3. 实例维度：多客服号时，contact 建议带实例 / 账号维度，避免串档。

4. 合规：控制新增与触达频率，敏感操作留审计；能做不等于该做。

具体回调事件名与同步接口，以你对接的开放文档为准。若使用 .eyunz.地址，可把 friend.* / contact.modified 与外部联系人同步配合使用，再映射到自己的 CRM 表。

小结

私域 CRM 要的是客户状态变化，不是更多话术模板。企业微信 API 接口二次开发先把加好友建档、消息升温、关键状态回写跑通，触达才会有依据。下一篇可以写客户群自动回：默认沉默、命中再回，怎样才敢长期开着。