更新日期
1. 简介
1.1 功能概述
Webhook触发节点 是一种由外部系统主动向本应用发送事件通知的触发机制,可理解为 反向API。当外部事件发生时,外部系统 自动 将数据推送至本应用,无需本应用反复查询。
外部应用通过系统生成的Webhook URL发送HTTPS请求,服务器接收请求后 自动触发 工作流,执行新增或更新数据等操作,从而实现 跨系统间的数据实时对接。
1.2 应用场景
- 同步订单状态:客户支付成功后,外部系统通过Webhook推送支付结果,本系统自动更新订单状态并通知相关人员。
- 自动新增意向客户:用户在官网提交“申请试用”表单后,外部系统自动将客户信息通过Webhook录入本系统的意向客户表中。
- 同步快递信息:快递公司推送揽件通知后,系统自动将订单状态更新为“已揽件”,便于客户实时查询物流进度。
1.3 版本说明
Webhook触发节点功能属于高级组件,仅企业版及以上版本 用户可用。
2. 设置入口
操作路径:进入工作流管理页面 >> 点击右上角 「+工作流」 按钮 >> 选择 「Webhook触发」 >> 点击 「确定」 按钮。

3. 操作指南
3.1 节点说明
进入工作流编辑页面,点击 「Webhook」 节点,弹出配置窗口。窗口中可设置 节点名称、Webhook URL 以及 JSON数据示例填写。

3.2 节点配置
3.2.1 Webhook URL配置
在节点配置窗口中,系统会生成一个唯一的URL地址,用于接收外部应用发送的实时通知和数据。用户需将该地址配置到外部应用中,外部应用收到数据后,系统会 自动解析字段 并触发工作流。点击 「复制链接」 按钮可复制该地址。

3.2.2 设置请求数据JSON格式
用户需提供一份 JSON数据示例,系统将据此解析数据结构,供后续流程使用其中的参数字段。点击 「下一步」 可查看解析得到的参数列表,点击 「编辑」 可修改JSON数据格式。

3.3 后续节点使用Webhook节点参数示例
配置完Webhook节点后,可在工作流的后续节点中调用接收到的数据。以下以“在企业小程序中收集用户反馈并同步至英雄云”为例,演示如何将Webhook数据写入指定表单并完成字段映射。
配置步骤如下:
1)创建包含Webhook触发节点的工作流,并按3.2.2节的要求设置请求数据格式。
2)点击 「+」 添加 「新增数据」 节点(数据节点),选择新增方式及新增条数(如单条新增)。
3)选择目标表单字段,将其值 关联 为对应的Webhook数据字段,完成字段映射配置。

外部应用通过调用Webhook URL发送HTTPS请求。例如,在小程序中,用户填写反馈并点击提交按钮后,将会触发以下方法。该方法使用 wx.request 调用Webhook URL发送HTTPS请求。英雄云系统收到回调后即可 自动新增 一条表单数据。

4. 效果演示
本示例展示从企业小程序到英雄云的 跨系统数据同步 效果:用户在小程序 提交反馈 后,Webhook节点被触发,工作流自动将数据写入“用户反馈收集”表单中,完成数据同步。

5. 注意事项
- JSON格式校验:提供的JSON数据示例需符合标准格式,否则系统无法正确解析数据结构,影响后续字段映射。
- 版本限制:该功能仅企业版及以上版本可用,请确认当前版本后再行配置。