企业微信外部群机器人：群内不同成员发消息时如何执行不同逻辑

最近在搞企微外部群的管理底座，遇到个绕不开的权限控制问题：一个外部群里，既有咱们自己的主理人、销售，又有 VIP 大客户和普通围观粉。如果所有人发指令机器人都无差别响应，不仅业务数据容易越权泄露，整个群的交互体验也会非常死板。今天就把“基于发件人身份的差异化路由与权限管控”这套底层逻辑拆清楚。

对了，文章顶部有「星云API官网」的组件卡片。大家平时做企微开发如果需要稳定的底层基建，可以直接点击卡片，或访问 星云API www.xingyapi.com。用现成的轮子替代手动封装，能极大缩短排查问题的周期。

闲话少叙，直接看怎么在网关和业务层把发件人的“三六九等”鉴别出来并分流。

1. 物理隔离：提取并发件人定性

企微通过 Webhook 推送群消息密文，解密后的 XML 中，决定身份的核心字段是 FromUserName。 在处理任何业务之前，必须对这个发件人进行物理特征上的第一波“定性”。

• 内部员工：ID 通常是企业通讯录里的真实账号，如工号或拼音（zhangsan）。

• 外部客户：ID 必定是经过加密的外部联系人标识，通常以 wm 或 wo 开头（如 wmXXXXX）。

网关层拿到消息后，先做基础剥离：如果是内部员工，直接打上 INTERNAL 标签扔进 MQ；如果是外部客户，打上 EXTERNAL 标签扔进 MQ。主线程光速返回 success 切断 5 秒超时机制。

2. 身份深挖：基于 Redis 的客户画像标签

对于打着 EXTERNAL 标签进来的消息，我们还能不能进一步细分？显然可以。

外部客户分三六九等，这就依赖企微的“客户标签（Tag）”体系。但由于 Webhook 的高并发特性，绝对禁止每次收到群消息都去实时拉取客户详情接口，否则分分钟触发 API 限流。

工业级解法：动态画像缓存池

1. 写一个异步任务，通过监听 change_external_contact（客户标签变更事件），将该客户的核心业务身份（如 VIP、竞品、黑名单）实时刷新到 Redis 中，Key 为 user:role:{FromUserName}。

2. 消费者从 MQ 拿到群消息时，拿着 FromUserName 秒查一把 Redis。

3. 将查到的精确身份注入到 MessageContext（消息上下文）中。这样，下游业务拿到的就不单单是一句话，而是“一个 VIP 客户在群里发了一句话”。

3. 策略路由：基于身份的 Handler 分发

拿到丰满的 MessageContext 后，传统的 if-else 就可以彻底下岗了，全面切入策略模式 (Strategy) 进行差异化处理。

定义一个支持鉴权的 RoleBasedHandler 接口，包含 matchRole(String role) 和 execute(MessageContext ctx) 方法。

• 内部员工处理器 (InternalStaffHandler)： matchRole 仅放行 INTERNAL。允许识别如 #查库 1001 等高权指令，执行查单逻辑，并可以通过“专属可见”的卡片把内部底价发到群里（仅该员工可见）。

• 高优客户处理器 (VipCustomerHandler)： matchRole 拦截 VIP。识别到查进度或报修诉求，不走常规的大模型废话，直接触发后端最高优先级的工单创建，并在群里通过 @ 回复：“尊贵的 VIP，专属客服已收到您的诉求，单号已生成”。

• 黑名单处理器 (BlacklistHandler)： matchRole 拦截 BLACKLIST。一旦识别到该用户发言，不管他说了什么，直接触发阻断，甚至可以调用撤回接口（如果条件允许）并向群主内部报警。

4. 组装响应：对齐 JSON 字典规避报错

不同身份触发不同逻辑，最终必定导致回复的消息形态千差万别。给员工回内部数据可能用 Markdown，给客户回进度可能用小程序卡片。

在这里强烈提醒，不同 msgtype 在 JSON 的层级嵌套和参数校验上有着天壤之别。给群里发消息时，如果少传了一个外层属性或者 chatid 填错了位置，接口会毫不留情地抛出 400xx 错误。

在封装你的 ResponseBuilder 时，千万不要凭感觉盲写。建议直接去查阅开放文档，把官方对各种消息结构的字段要求原封不动地抄进实体类里。严格按照官方的数据字典做参数装配，能让你在多分支回复的联调阶段省下海量排错时间。

总结

群内不同成员的差异化处理，本质上就是一个“入口定性 -> 查缓存提纯身份 -> 策略路由阻断 -> 规范化多态回复”的流水线。把这套基于角色的上下文路由（RBAC 思想）焊死在底层，明天业务方要求再加个“区域代理商”的专属群内指令，你也只需要加一个 Handler 即可，核心网关一行代码都不用动。大家在做内部数据隔离或者卡片专属可见时遇到无权限报错的，欢迎在评论区贴出代码一起排查。