做个人微信二次开发微信事件消息、好友、群、状态是原始材料业务指令查订单、发通知、建工单是加工品。从事件到指令不是一步到位的中间有 3 层加工每层解决一个转化问题。Eyun 的 Webhook 把事件推过来但推过来的是原始 JSON能不能直接驱动业务得看你怎么加工。下面按转化层次拆开讲。一、事件标准化层把 4 类原始事件加工成统一格式Eyun Webhook 回调的 4 类事件 JSON 格式不一样消息事件有content、好友事件有action、群事件有member、状态事件有status。直接拿原始 JSON 写业务逻辑代码会被 if-else 撑爆。标准化层把 4 类事件加工成统一事件对象{eventType, sourceId, action, payload, timestamp}payload存各类事件特有字段。按照 Eyun 开发文档 的回调规范4 类事件的eventType值不同这是标准化的分叉点。大白话4 种快递消息/好友/群/状态包装不同先拆包重新装进统一盒子后面处理就不用再区分原始格式。二、指令推导层从标准化事件推导出业务指令统一事件对象出来后下一步是推出这个事件该执行哪个业务动作。推导靠规则引擎匹配eventTypemessage payload.content 含订单 → 指令QueryOrder、eventTypefriend actionadd → 指令SendWelcome。输出业务指令对象{command, params, priority}。Eyun API 的 Webhook 回调 JSON 中eventType和content是推导依据规则表里把它们映射成具体指令。大白话统一盒子上的信息加上规则表推出这个事件该送往哪个车间——就像快递分拣系统根据面单信息决定去处。三、指令校验层推导出的指令执行前做校验指令推导出来不能直接执行得先校验。三层校验参数完整性QueryOrder指令必须有orderId没有则降级为请提供订单号纠错指令→ 权限校验该用户是否有权限执行此指令→ 频率校验该指令是否被频繁触发需限流。校验通过送执行器校验失败生成纠错指令通过 Eyun 的sendText反馈用户。按 Eyun 开发文档规范sendText需要传wId、toUser、content三个必填参数。大白话推出指令后先检查材料齐不齐、有没有权限、是不是太频繁——不齐就让用户补材料。3 层转化对比表转化层做什么输入输出Eyun 接口大白话说明事件标准化层4 类事件加工成统一格式原始回调 JSON统一事件对象Webhook 回调拆包重装统一盒子指令推导层推导出业务指令统一事件对象业务指令对象Webhook 回调字段按面单分拣到车间指令校验层执行前做校验业务指令对象校验通过/纠错指令sendText检查材料权限频率3 层事件到指令转化框架代码下面这段把标准化→推导→校验串成一条转化管道原始事件进来干净的业务指令出去。RULES [ {when: lambda e: e[eventType]message and 订单 in e[payload][content], cmd: QueryOrder, params: lambda e: {orderId: extract_order(e[payload][content])}}, {when: lambda e: e[eventType]friend and e[action]add, cmd: SendWelcome, params: lambda e: {}}, ] def to_unified(raw): # 标准化层 et raw[eventType] pl {message: {content: raw.get(content)}, friend: {action: raw.get(action)}, group: {member: raw.get(member)}, status: {status: raw.get(status)}}[et] return {eventType: et, sourceId: raw[fromUser], action: raw.get(action), payload: pl, timestamp: raw.get(timestamp)} def derive(event): # 推导层 for r in RULES: if r[when](event): return {command: r[cmd], params: r[params](event), priority: 1} def validate(cmd, user): # 校验层 if cmd[command]QueryOrder and not cmd[params].get(orderId): return {command:AskOrderId,params:{},priority:9} # 纠错指令 if rate_limited(user, cmd[command]): return {command:RateLimited,params:{},priority:9} return cmd def transform(raw, user): cmd derive(to_unified(raw)) # 标准化→推导 return validate(cmd, user) if cmd else None # 校验管道里规则表是RULES列表新增事件类型或业务场景改规则不改代码。结尾延伸3 层转化让微信事件变成可执行的业务指令——标准化层解决格式统一、推导层解决该干什么、校验层解决能不能干。转化后的指令对象是干净的业务数据执行器只管执行不用关心事件原始格式。设计时建议把规则表做成配置化数据库或配置中心新增事件类型或业务场景时改规则不改代码这样 Eyun 回调来的新事件只需加一条规则就能接入。回调事件字段和接口参数详见 Eyun 开发文档wId 实例在 Eyun 平台 管理。