Webhook 回调驱动：企业微信消息接收与自动回复架构

从「只能发」到「能收能回」构建完整的消息闭环本文说明如何配置 Webhook 回调实现企业微信消息接收、业务处理与自动回复的完整链路适用于 AI 客服、群机器人等场景。功能说明单向推送只能覆盖一半需求。AI 客服、群机器人、关键词自动应答都依赖「接收消息 → 业务处理 → 再发送」的闭环。平台支持在控制台配置 Webhook 回调地址当执行节点收到好友消息或群消息时平台将事件 POST 到开发者服务器。开发者解析 payload 后再调用发送类 API 完成回复。该模式与常见 IM 开放平台的事件订阅类似但底层由 RPA 节点承担消息监听无需企业自行部署消息加解密服务。整体流程用户发消息 → RPA 节点接收 → 平台 POST Webhook → 业务服务处理 → 调用 sendText 回复快速上手步骤操作预期结果1完成节点登录与 Token 获取前置环境就绪2在控制台填写 Webhook URL需公网可访问配置保存成功3向该节点发送一条测试消息触发消息事件4在服务器日志中确认收到回调事件日志中有完整 payload5编写处理逻辑并调用/msg/sendText回复用户收到自动回复代码示例const express require(express); const app express(); app.use(express.json()); app.post(/webhook/qw, async (req, res) { const event req.body; // 根据文档解析消息类型、发送方 ID、文本内容 if (event.msgType text event.content) { await fetch(http://manager.qiweapi.com/qiwe/api/qw/doApi, { method: POST, headers: { X-QIWEI-TOKEN: process.env.API_KEY, Content-Type: application/json }, body: JSON.stringify({ method: /msg/sendText, params: { guid: event.guid, toid: event.fromId, content: 已收到${event.content} } }) }); } res.json({ code: 0 }); }); app.listen(3000);落地场景外部群关键词触发自动应答接入大模型的智能客服对话群消息采集后写入工单系统外部联系人咨询分流到不同业务队列答疑问Webhook 收不到回调怎么办确认 URL 公网可达、HTTPS 证书有效、控制台配置已保存且 guid 节点处于在线状态。问回调会重复推送吗建议业务侧做幂等处理按消息 ID 或时间戳去重。问群消息和个人消息回调格式一样吗结构类似但字段中会有 roomId 等群相关标识需按文档区分处理分支。问响应超时有什么影响平台侧通常异步投递但建议快速返回 200耗时逻辑放队列异步执行。延伸链接想继续往下做可以从这里开始查看 API 文档 — 完整接口说明、Webhook 配置与快速开始访问官网平台 — 注册账号、扫码登录节点、在线调试