Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.jinshuju.net/llms.txt

Use this file to discover all available pages before exploring further.

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 规则,使用「符合特定条件数据变更」,当数据标记颜色修改时触发推送,如图:
  1. 在数据页面选中推送失败期间的数据,批量编辑修改标记数据颜色。

方案二:数据导出处理

  1. 导出推送失败期间的数据;
  2. 通过 API 或其他方式手动同步。

Webhook 推送常见问题

Q:如何验证 Webhook 地址是否正确? A:使用「检测」功能可以验证地址的可用性,系统会发送测试数据到您的服务器。 Q:推送失败的数据能否重新推送? A:推送失败期间的历史数据不会自动补发,需要通过其他方式处理。 Q:支持哪些触发条件? A:详情查看「提醒推送触发条件设置」。

Webhook 相关资费介绍

免费版

专业版

专业增强版

企业基础版

企业协作版

企业高级版

价格

免费

599 元/年

2,399 元/年

299 元/月

4,399 元/年

7,399 元/年

23,999 元/年

Wbhook 推送功能

Wbhook 推送

符合条件的修改数据

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