企微 API 最务实的价值不是搭炫酷的机器人，而是把团队每天在做的那几件重复活自动化。这篇不讲功能清单，讲五个真实团队在做的自动化场景，每个场景给一句"怎么做"。

场景一：新客户加好友自动发欢迎语

客户通过扫码或手机号加了企微，系统自动按渠道发不同欢迎语。

怎么做：监听 Webhook 事件 add_external_contact，data 里直接带客户 uin 和 conversationId，拿到后调 message/sendText 发对应的模板。按渠道（source 字段）分支选模板——扫码来的发"欢迎加入会员"，手机号加的发"您好，感谢关注"。

场景二：订单发货自动通知客户

电商后台订单改状态后，自动把物流信息推给下单客户。

怎么做：订单系统改状态时 publish 一条事件，Worker 订阅后调 message/sendText。客户的 conversationId 提前存好（首次下单时通过手机号反查 uin → 开单聊 → 存 id）。限流用令牌桶限速，批量发货不一次性全打出去。

场景三：新线索进群自动分配客服

客户扫码进群，系统自动按轮询或负载分配给不同客服跟进。

怎么做：监听 group_member_add 事件，判断是外部客户进群（不是内部员工），按预设的分配规则选一个客服，把客服的名片或群私发推给客户。分配规则可以很简单——维护一个客服列表，每次取模。

场景四：内部告警自动推到企微群

监控系统发现异常、服务器负载过高，自动把告警推到内部运维群。

怎么做：告警系统触发时调 message/sendText，conversationId 是运维群的会话 id。告警内容建议走 sendRichText，可以把关键字段（IP、指标、时间）加粗高亮，比纯文本好读。

场景五：客户资料自动回流 CRM

客户在企微里改了昵称、加了标签，或和销售聊完关键信息，自动同步回 CRM。

怎么做：监听通讯录变更事件和标签变更事件（label_change），拿到变更的 uin 后调 contact/getUserProfileDetail 换最新资料，再 upsert 到 CRM。这里要注意字段主辅——企微主的字段（昵称、头像）覆盖，业务系统主的字段（扩展备注）不动。

共性：自动化设计的三个原则

这五个场景虽然业务不同，但设计时都遵循同一条原则：触发源解耦 + 幂等优先 + 限流前置。

• 触发源解耦：业务触发时只 publish 事件，不直接调企微接口

• 幂等优先：每条任务带唯一 id（比如订单号 + 客户 uin），重复执行不产生副作用

• 限流前置：在发消息前控制节奏，不等平台返回 -301002 再退避

用的是 Eyun 平台的企微 API，接口路径 /wx-api/api/<模块>/<动作>，鉴权 Bearer eyk_xxxx。凭证在官网开通实例时拿到，字段和事件列表可以对照开发文档。

自动化的核心选对场景——先挑规则明确、每天重复、量大的那几件做，做完一件团队立刻能省出时间。五个场景里，新客户欢迎语和订单通知是 ROI 最高的两个，建议先做。