Webhook 推送配置

Webhook 推送功能说明

核心功能：系统自动将数据以 JSON 格式通过 HTTP POST 请求发送至您配置的服务器地址。

适用场景：

• 数据同步至企业内部系统；

• 触发自动化工作流程；

• 实时数据分析和处理；

• 第三方系统集成。

设置步骤

第一步：创建提醒推送

1. 进入表单「设置」页面；

2. 选择「提醒推送」；

3. 点击「新建提醒推送」；

4. 选择触发条件（如：有新数据提交时）；

5. 点击「确认」。

第二步：配置 Webhook

1. 选择推送方式为「发 Webhook」；

2. 粘贴您的 Webhook 接收地址（必须为 HTTPS 或 HTTP 协议）；

3. 点击「检测」按钮，验证地址可用性；

4. 检测成功后，点击「保存并启用」。

Webhook 数据推送数据结构

推送的数据采用标准 JSON 格式，点击「推送字段」即可展开查看推送数据每一个字段对应的 API Code 。

Webhook 推送重连机制

响应要求

• 您的服务器必须在 2 秒内 返回 HTTP 状态码 2XX（如 200）；

• 未在规定时间内正确响应将触发重试机制。

重试策略

重试规则：

• 最多重试 6 次；

• 重试间隔采用斐波那契数列递增。

重试间隔计算公式（单位：秒）：

间隔时间 = (retry_count * 4) + 15 + (rand(30) * (retry_count + 1))

其中：

• retry_count：重试次数（1-6）；

• rand(30)：0-30 之间的随机数。

Webhook 推送推送失败处理方案

连续失败 6 次后：

1. 系统自动停止该表单的数据推送；

2. 向表单创建者发送邮件和短信通知；

3. 需要手动恢复推送服务。

恢复推送服务：

1. 进入表单「设置」→「提醒推送」；

2. 找到对应的 Webhook 规则；

3. 重新保存设置；

4. 确保检测通过后，数据推送将恢复。

⚠️ 重要提示：推送失败到重新开启期间产生的新数据不会补发，仅会推送重新开启后的新数据。

Webhook 未推送数据处理方案

如需处理推送失败期间的数据，建议：

方案一：使用修改后触发推送的数据的功能补充推送

1. 创建一条新的 Webhook 规则，使用「符合特定条件数据变更」，当数据标记颜色修改时触发推送，如图：

   

2. 在数据页面选中推送失败期间的数据，批量编辑修改标记数据颜色。

方案二：数据导出处理

1. 导出推送失败期间的数据；

2. 通过 API 或其他方式手动同步。

Webhook 推送常见问题

Q：如何验证 Webhook 地址是否正确？

A：使用「检测」功能可以验证地址的可用性，系统会发送测试数据到您的服务器。

Q：推送失败的数据能否重新推送？

A：推送失败期间的历史数据不会自动补发，需要通过其他方式处理。

Q：支持哪些触发条件？

A：详情查看「提醒推送触发条件设置」。

Webhook 相关资费介绍