> ## Documentation Index
> Fetch the complete documentation index at: https://jinshuju-20a27453.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook 推送配置

> Webhook 功能支持将表单数据以 JSON 格式实时推送至指定的第三方服务器，实现数据的自动化传输和处理。该功能适合有一定编程基础的用户使用。

## Webhook 推送功能说明

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

**适用场景**：

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

* 触发自动化工作流程；

* 实时数据分析和处理；

* 第三方系统集成。

***

## 设置步骤

<img src="https://mintcdn.com/jinshuju-20a27453/T3R0aMcfYazCeIGp/next/attachments/xoNNyEfJhrxXBKLb5rcYgw1V.png?fit=max&auto=format&n=T3R0aMcfYazCeIGp&q=85&s=626c9c95487261cef6b02fd4c30bd328" alt="PC|Webhook|「新建提醒推送」设置页。可设置当「有数据新增」时" width="781" height="1000" data-path="next/attachments/xoNNyEfJhrxXBKLb5rcYgw1V.png" />

**第一步：创建提醒推送**

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

2. 选择「提醒推送」；

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

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

5. 点击「确认」。

**第二步：配置 Webhook**

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

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

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

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

***

## Webhook 数据推送数据结构

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

<img src="https://mintcdn.com/jinshuju-20a27453/5Ys1g6_4sNymP1E5/next/attachments/bSQL8NB41L8LWy4PNxgHbpev.png?fit=max&auto=format&n=5Ys1g6_4sNymP1E5&q=85&s=646e17081dffc3bb6fcfa9d5e260a614" alt="PC|Webhook推送|推送字段配置界面，顶部填入地址可检测，下方选择序号提交人等推送字段" width="857" height="1000" data-path="next/attachments/bSQL8NB41L8LWy4PNxgHbpev.png" />

***

## 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 规则，使用「[符合特定条件数据变更](/next/articles/Reminder#触发条件四：符合特定条件的数据变更)」，当数据标记颜色修改时触发推送，如图：

<img src="https://mintcdn.com/jinshuju-20a27453/eFPaAnC3qZ-6meBS/next/attachments/HAFNw6GXNw3dDRCBZJxhem63.png?fit=max&auto=format&n=eFPaAnC3qZ-6meBS&q=85&s=d63376d3acf4923c51de23f160e5c392" alt="PC|Webhook|编辑提醒推送功能的设置页，主要用于配置数据变更时的自动提醒推送" width="1018" height="910" data-path="next/attachments/HAFNw6GXNw3dDRCBZJxhem63.png" />

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

<img src="https://mintcdn.com/jinshuju-20a27453/PXjNpuVOxWvDlg9n/next/attachments/pq8R7oLZfEG2Ck8QkZoNfyfZ.png?fit=max&auto=format&n=PXjNpuVOxWvDlg9n&q=85&s=5fc5ca99096d7609e6df4fe193ffc804" alt="PC|Webhook|数据管理页面，主要用于批量操作和标记数据" width="980" height="486" data-path="next/attachments/pq8R7oLZfEG2Ck8QkZoNfyfZ.png" />

### 方案二：数据导出处理

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

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

***

## Webhook 推送常见问题

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

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

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

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

**Q：支持哪些触发条件？**

A：详情查看「[提醒推送触发条件设置](/next/articles/Reminder#提醒推送触发条件设置)」。

***

## Webhook 相关资费介绍

<table style={{ minWidth: "175px" }}>
  <colgroup><col style={{ minWidth: "25px" }} /><col style={{ minWidth: "25px" }} /><col style={{ minWidth: "25px" }} /><col style={{ minWidth: "25px" }} /><col style={{ minWidth: "25px" }} /><col style={{ minWidth: "25px" }} /><col style={{ minWidth: "25px" }} /></colgroup><tbody><tr><th colspan="1" rowspan="1"><p /></th><th colspan="1" rowspan="1"><p><strong>免费版</strong></p></th><th colspan="1" rowspan="1"><p><a target="_blank" rel="noopener noreferrer nofollow" href="https://jinshuju.net/plan_payment"><strong>专业版</strong></a></p></th><th colspan="1" rowspan="1"><p><a target="_blank" rel="noopener noreferrer nofollow" href="https://jinshuju.net/plan_payment"><strong>专业增强版</strong></a></p></th><th colspan="1" rowspan="1"><p><a target="_blank" rel="noopener noreferrer nofollow" href="https://jinshuju.net/plan_payment"><strong>企业基础版</strong></a></p></th><th colspan="1" rowspan="1"><p><a target="_blank" rel="noopener noreferrer nofollow" href="https://jinshuju.net/plan_payment"><strong>企业协作版</strong></a></p></th><th colspan="1" rowspan="1"><p><a target="_blank" rel="noopener noreferrer nofollow" href="https://jinshuju.net/plan_payment"><strong>企业高级版</strong></a></p></th></tr><tr><th colspan="1" rowspan="1"><p><strong>价格</strong></p></th><td colspan="1" rowspan="1"><p>免费</p></td><td colspan="1" rowspan="1"><p>599 元/年</p></td><td colspan="1" rowspan="1"><p>2,399 元/年</p><p>299 元/月</p></td><td colspan="1" rowspan="1"><p>4,399 元/年</p></td><td colspan="1" rowspan="1"><p>7,399 元/年</p></td><td colspan="1" rowspan="1"><p>23,999 元/年</p></td></tr><tr><th colspan="1" rowspan="1"><p><strong>Wbhook 推送功能</strong></p></th><td colspan="1" rowspan="1"><p>❌</p></td><td colspan="1" rowspan="1"><p>✅</p></td><td colspan="1" rowspan="1"><p>✅</p></td><td colspan="1" rowspan="1"><p>✅</p></td><td colspan="1" rowspan="1"><p>✅</p></td><td colspan="1" rowspan="1"><p>✅</p></td></tr><tr><th colspan="1" rowspan="1"><p><strong>Wbhook 推送</strong></p><p><strong>符合条件的修改数据</strong></p></th><td colspan="1" rowspan="1"><p>❌</p></td><td colspan="1" rowspan="1"><p>❌</p></td><td colspan="1" rowspan="1"><p>❌</p></td><td colspan="1" rowspan="1"><p>✅</p></td><td colspan="1" rowspan="1"><p>✅</p></td><td colspan="1" rowspan="1"><p>✅</p></td></tr></tbody>
</table>

⚠️ 注意：专业版和专业增强版支持使用 Webhook 推送新增数据，并不支持 API 和 URL 传参功能。企业基础版及以上套餐支持使用 API ，企业高级版支持使用 URL 传参。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.