排程式 URL 輪詢

Webhook 通常會等待有人呼叫它。若設定排程,則由應用程式主動呼叫:它會以固定間隔呼叫您指定的 URL,並將回應傳送至同一個 Webhook,因此您的 Shopify Flow 工作流程可透過定時器,從任何回傳 JSON、表單資料或 XML 的 API 執行。

常見用途:每 15 分鐘擷取供應商的庫存資料、每小時檢查 ERP 系統是否有新訂單,或每天讀取一次狀態終點,並讓 Shopify Flow 根據結果採取行動。

設定一個

若要建立新的 Webhook,請選擇「建立 Webhook」,並在「什麼會觸發此 Webhook?」一欄中選擇「無 - 依照排程執行」。 該 webhook 建立時會產生一個秘密代碼,以確保無人能呼叫其 URL,並會自動開啟至「排程」分頁。若要設定現有的 webhook,請開啟該 webhook 並前往「排程」分頁,接著填寫以下內容:

領域 功能說明
已啟用 啟用排程。無論如何,Webhook URL 都會持續運作。
網址 要擷取的網址。僅限 http 和 https,且該網址必須可從公共網際網路存取。
間隔 每 5、15 或 30 分鐘一次;每 1、3、6 或 12 小時一次;或每天一次。
模式 每次 fetch 都會在每次執行時觸發 Shopify Flow。而 only when the response changes 則僅在響應正文與前一次執行結果不同時才會觸發。
請求標頭 此為選填欄位,用於 API 金鑰或承載者憑證。資料將以加密形式儲存,且不會再次顯示。

啟用後,首次執行將在一分鐘內完成。

「建立 Webhook」頁面會詢問「什麼會觸發此 Webhook」,此時請選擇「無 - 依排程執行」,並會顯示提示訊息,說明接下來將開啟「排程」分頁
新增的排程式 Webhook:請回答「無 - 依照排程執行」,儲存後便會開啟「排程」分頁。
「排程」分頁中,包含一個待擷取的網址、每 6 小時一次的間隔,並已選取「僅在回應變更時」選項
「排程」分頁:要擷取的 URL、擷取頻率,以及「Shopify Flow」是在每次擷取時執行,還是僅在回應內容變更時執行。

繪製反應圖

擷取到的資料體會像使用者發送給您的請求一樣,經過 webhook 處理:系統會根據內容類型進行解析,您的欄位映射會選取 Shopify Flow 接收的值,若已設定陣列分割功能,則會套用該功能。

由於 API 會自行決定其回應的結構,因此排程執行的任務會跳過針對您自身系統傳送的 JSON 所進行的「意外欄位」檢查。您只需將您關心的值進行映射即可。

Example responsejson
{
  "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 次後,系統會自動暫停並顯示相關提示,而非持續呼叫已失效的網址。請修正網址或憑證,然後重新啟用此功能。
  • 達到方案上限並不被視為失敗。這些執行任務會被阻擋,並顯示在儀表板上。

此應用程式不會擷取的內容

僅限公共位址。內部及私人位址(例如 localhost、私人位址範圍、雲端元資料端點)將被拒絕,即使重定向指向此類位址亦然。回應大小上限為 1 MB,處理時間上限為 10 秒,且最多僅跟隨 3 次重定向。若重定向導向至其他網站,您的標頭將被捨棄。

排程任務會顯示在哪裡

在**「歷史**」中,來源設定為**「已排程」**。其餘功能皆如常運作:有效載荷、Shopify Flow 觸發結果、重試及重播。