搜索
更新人
更新时间 更新日期

1. 简介

1.1 功能概述

Webhook触发节点 是一种由外部系统主动向本应用发送事件通知的触发机制,可理解为 反向API。当外部事件发生时,外部系统 自动 将数据推送至本应用,无需本应用反复查询。
外部应用通过系统生成的Webhook URL发送HTTPS请求,服务器接收请求后 自动触发 工作流,执行新增或更新数据等操作,从而实现 跨系统间的数据实时对接

1.2 应用场景

  • 同步订单状态:客户支付成功后,外部系统通过Webhook推送支付结果,本系统自动更新订单状态并通知相关人员。
  • 自动新增意向客户:用户在官网提交“申请试用”表单后,外部系统自动将客户信息通过Webhook录入本系统的意向客户表中。
  • 同步快递信息:快递公司推送揽件通知后,系统自动将订单状态更新为“已揽件”,便于客户实时查询物流进度。

1.3 版本说明

Webhook触发节点功能属于高级组件,仅企业版及以上版本 用户可用。

2. 设置入口

操作路径:进入工作流管理页面 >> 点击右上角 「+工作流」 按钮 >> 选择 「Webhook触发」 >> 点击 「确定」 按钮。
Webhook触发节点创建入口

3. 操作指南

3.1 节点说明

进入工作流编辑页面,点击 「Webhook」 节点,弹出配置窗口。窗口中可设置 节点名称Webhook URL 以及 JSON数据示例填写
Webhook节点配置界面

3.2 节点配置

3.2.1 Webhook URL配置
在节点配置窗口中,系统会生成一个唯一的URL地址,用于接收外部应用发送的实时通知和数据。用户需将该地址配置到外部应用中,外部应用收到数据后,系统会 自动解析字段 并触发工作流。点击 「复制链接」 按钮可复制该地址。
Webhook URL生成与复制
3.2.2 设置请求数据JSON格式
用户需提供一份 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节点被触发,工作流自动将数据写入“用户反馈收集”表单中,完成数据同步。
Webhook触发效果演示

5. 注意事项

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