Webhook 触发

功能说明

Webhook 触发器用于通过 HTTP 请求启动连接流。调用方可以选择同步或异步执行方式，并按需配置测试数据和 IP 白名单。

请求要求

当前目标租户的 Webhook 触发器只接收：

请求方法：POST

Content-Type：application/json

请求体应为合法 JSON，并与连接流中的变量引用一致。不要按通用 Webhook 能力假设支持 GET、PUT、PATCH 或 DELETE。

配置 Webhook 触发器

连接流画布中的 Webhook 触发器及后续节点；流程标识已脱敏

添加 Webhook 触发器

在连接流画布中添加 Webhook 触发器。页面会生成只读 Webhook 地址。

选择执行方式

选择同步或异步：

同步：等待连接流执行完成，并把最后执行结果返回给调用方。

异步：接收请求后启动连接流，不等待完整执行结果。

当前运行态已确认两种选项都存在，但本次只读核验没有新建触发器，因此不声明新建节点的默认方式。

填写测试数据

根据业务请求填写 JSON 测试数据。测试数据用于画布调试，不应包含真实密码、Token、身份证号或客户敏感信息。

配置 IP 白名单

可填写单个 IP 或 CIDR 网段，多个规则使用英文逗号分隔。

保存并测试

保存触发器后，使用测试请求验证参数接收、流程执行和返回结果。

Webhook 触发器配置面板展示只读地址、执行方式和测试数据；地址已脱敏

同步与异步

同步执行

同步方式最长等待 10 秒。

连接流在等待时间内完成时，调用方获取最后执行结果。

超过等待时间时，不应依赖连接保持直到整个流程结束。

调用方必须为超时、空结果或非预期返回准备容错逻辑。

文档不约定未被当前接口契约证明的固定 requestId、accepted 状态或异步结果查询 API。

异步执行

异步方式适用于调用方不需要立即获得最终业务结果的场景。连接流是否执行成功，应在流程运行日志中确认。

如业务需要异步完成通知，应通过已经验证的回调、消息或后续节点实现，不能假设 Webhook 触发器自动提供结果查询接口。

IP 白名单

IP 白名单支持：

单个 IPv4 地址。

单个 IPv6 地址。

IPv4 或 IPv6 CIDR 网段。

多个规则使用英文逗号分隔。

白名单为空时不限制来源 IP。配置了无效规则时，系统不会把无效规则当成放行条件。

示例：

192.168.1.10,192.168.2.0/24

生产使用前，应从实际网关链路验证平台识别到的来源 IP，尤其是请求经过反向代理、网关或 NAT 的场景。

请求示例

以下示例只展示基本 JSON 请求形式。请把地址和字段替换为当前连接流的实际配置。

不要在公开文档、截图或工单中放置真实 Webhook 地址、Token 或客户数据。

验证清单

使用 POST 且请求体为 JSON 时可以触发连接流。

同步方式在 10 秒内完成时返回最后执行结果。

超过同步等待时间时，调用方有明确容错处理。

异步方式的最终结果可在运行日志中确认。

允许 IP 可以访问，非允许 IP 被拒绝。

CIDR 规则与实际来源 IP 一致。

请求数据能在后续节点中正确引用。

日志和截图没有泄露 Webhook 地址或敏感数据。

常见问题

Webhook 默认是同步还是异步？

当前页面提供同步和异步两种方式。本次只读核验没有新建触发器，不能据此确认新建节点的默认值；请以创建时页面显示为准。

同步请求会一直等待连接流结束吗？

不会。同步方式最长等待 10 秒。耗时更长的流程应考虑异步设计或其他结果通知方式。

白名单为空时会发生什么？

白名单为空时不限制来源 IP。生产环境是否允许空白名单应按安全要求评估。

功能说明#

请求要求#

配置 Webhook 触发器#

同步与异步#

同步执行#

异步执行#

IP 白名单#

请求示例#

验证清单#

常见问题#