1. 引言只调发送接口做出来的是通知器。搜「企业微信Webhook」「企业微信消息回调」「企微进群事件」的人要的是客户在企微上的动作实时进系统。2. 企微回调常见事件客户文本 / 图片 / 文件消息好友申请、通过客户入群、退群设备掉线、登录状态接收侧对接QIWe API。网关把回调 payload 转成内部统一事件解析逻辑按事件类型分发不要堆在一个 if-else 里。3. 最小规范公网可达、验签、快速 200、消息 ID 幂等、消费者可重入。app.post(/cb/qiwe)defcb():datarequest.get_json(forceTrue)ifnotverify(request):returninvalid,403event_idextract_id(data)ifredis.setnx(fqiwe:evt:{event_id},1):redis.expire(fqiwe:evt:{event_id},86400)queue.publish(qiwe.events,data)returnok4. 分发消息 → 会话/自动回复好友 → 客户档案/打标签入群 → 欢迎语掉线 → 运维告警与重连。配置回调、查看字段和调试以 QiWe API文档https://doc.qiweapi.com/为准。先打原始 JSON 日志再写解析能少踩一半字段坑。5. 调试同一报文重放三次只处理一次接口超时是否重推掉线恢复后是否误补发欢迎语。6. 安全回调 URL 不暴露前端QIWe APIToken 只放服务端不要写进前端或 Git。7. 总结企业微信 Webhook 是 SCRM 和智能客服的中枢。企微收事件不稳工作台会话列表就会假死。 企业微信API：Webhook回调开发
1. 引言只调发送接口做出来的是通知器。搜「企业微信Webhook」「企业微信消息回调」「企微进群事件」的人要的是客户在企微上的动作实时进系统。2. 企微回调常见事件客户文本 / 图片 / 文件消息好友申请、通过客户入群、退群设备掉线、登录状态接收侧对接QIWe API。网关把回调 payload 转成内部统一事件解析逻辑按事件类型分发不要堆在一个 if-else 里。3. 最小规范公网可达、验签、快速 200、消息 ID 幂等、消费者可重入。app.post(/cb/qiwe)defcb():datarequest.get_json(forceTrue)ifnotverify(request):returninvalid,403event_idextract_id(data)ifredis.setnx(fqiwe:evt:{event_id},1):redis.expire(fqiwe:evt:{event_id},86400)queue.publish(qiwe.events,data)returnok4. 分发消息 → 会话/自动回复好友 → 客户档案/打标签入群 → 欢迎语掉线 → 运维告警与重连。配置回调、查看字段和调试以 QiWe API文档https://doc.qiweapi.com/为准。先打原始 JSON 日志再写解析能少踩一半字段坑。5. 调试同一报文重放三次只处理一次接口超时是否重推掉线恢复后是否误补发欢迎语。6. 安全回调 URL 不暴露前端QIWe APIToken 只放服务端不要写进前端或 Git。7. 总结企业微信 Webhook 是 SCRM 和智能客服的中枢。企微收事件不稳工作台会话列表就会假死。