定时URL轮询

Webhook 通常需要等待有人调用它。而通过定时任务，应用会主动进行调用：它会以固定的间隔访问您指定的 URL，并将响应发送到同一个 Webhook，因此您的 Shopify Flow 工作流程可以基于定时器运行，支持任何返回 JSON、表单数据或 XML 的 API。

典型用途：每15分钟从供应商处获取库存数据，每小时检查ERP系统中的新订单，或者每天读取一次状态端点，并让Shopify Flow据此采取行动。

设置一个

对于新的 Webhook，请选择**“创建 Webhook**”，并在“什么会触发此 Webhook？”一栏中选择“无 - - 按计划运行”。 该 Webhook 创建时会生成一个密钥，因此其他人无法调用其 URL，并会自动跳转到“计划”选项卡。对于已有的 Webhook，请打开它并转到“计划”选项卡。然后填写：

字段	功能介绍
已启用	开启计划任务。无论哪种情况，Webhook URL 都始终有效。
URL	要获取的地址。仅限 http 和 https，且该地址必须可通过公共互联网访问。
间隔	每5、15或30分钟一次，每1、3、6或12小时一次，或者每天一次。
模式	_每次获取操作_都会触发 Shopify Flow 的每次运行。_只有当响应发生变化时，_即仅当_响应_正文与上一次运行不同时，才会触发。
请求头	可选，用于 API 密钥或持有人令牌。以加密形式存储，且不会再次显示。

启用该功能后，首次运行将在一分钟内完成。

绘制响应图

获取到的数据体在 Webhook 中处理的过程，与用户向您发送的请求完全相同：系统会根据内容类型进行解析，您的字段映射会确定 Shopify Flow 接收的值，如果设置了数组拆分，则会应用该操作。

由于 API 会自行决定响应格式，因此定时任务会跳过针对您自身系统发送的 JSON 数据所进行的“意外字段”检查。您只需映射您关心的那些值即可。

{
  "updated_at": "2026-09-17T08:00:00Z",
  "items": [
    { "sku": "ABC-1", "stock": 4 },
    { "sku": "ABC-2", "stock": 0 }
  ]
}

将updated_at映射到一个 Shopify Flow 字段，以便在您的工作流程中使用它。若要单独处理每个项目，请在**“高级设置**”中将拆分路径设置为 items - - 这样每个元素都会触发各自的 Shopify Flow 运行。参见 正文格式和数组拆分。

现在运行

“立即运行”会立即执行一次实际运行：它会加载该 URL，向您显示 HTTP 状态、响应预览以及发生的情况（已触发、未更改或出现错误），如果响应可用，则触发 Shopify Flow。在修改 URL 或请求头后，请直接使用此功能，而非等待下一个时间间隔。

只有当响应发生变化时

在此模式下，应用会将获取到的响应正文与上一次的进行比较，仅在两者存在差异时触发 Shopify Flow。该模式适用于那些在内容实际发生变化之前始终返回相同文档的接口，例如股票行情或状态更新接口。由于比较的是整个响应正文，因此如果某个 API 在每次响应中都包含时间戳或请求 ID，则每次响应的内容都会显示为不同。

当计划失败时

该选项卡上的**“状态**”块显示了上次运行情况、上次HTTP状态、下次运行计划以及上次出现的错误。

• 网络错误、非 2xx 状态码或无法解析的请求体均被视为请求失败，不会触发 Shopify Flow。
• 连续失败 20 次后，该计划任务会自动暂停并显示相应提示，而不是无限期地调用一个无效的 URL。请修复该 URL 或凭据，然后重新启用该计划任务。
• 达到套餐限额不被视为失败。这些运行会被阻止，并在仪表盘上显示。

该应用不会获取的内容

仅限公共地址。内部和私有地址（如 localhost、私有地址范围、云元数据端点）将被拒绝，即使重定向指向此类地址也不例外。响应大小上限为 1 MB，响应时间上限为 10 秒，且最多跟随 3 次重定向。如果重定向指向其他网站，您的请求头将被丢弃。

计划运行的显示位置

在**“历史**”中，源为**“已安排”**。其他所有功能均照常运行：负载、Shopify Flow触发器结果、重试和重放。