n8n Wait 節點(16):暫停、排程與人機互動——時間、Webhook、表單一次到位

需要「先停一下,再繼續」的情境很多:等 10 分鐘再重試、等外部系統回呼、等人工核准表單。

Wait 節點正是為此而生:它會在暫停時把執行狀態卸載到資料庫,待條件達成後再恢復並續跑
可選模式包含:

  • After Time Interval:等秒/分/時/天。
  • At Specified Time:等到指定日期時間。
  • On Webhook Call:收到 HTTP 回呼就繼續(每次執行都有唯一$execution.resumeUrl)。
  • On Form Submitted:顯示表單,等使用者提交再續跑。
    另外可設定限制等待時間(逾時自動恢復),並在 Webhook 模式中設定驗證、HTTP Method、回應碼與回應時機
    兩個關鍵特性必記:① 短於 65 秒的等待不會卸載到 DB(在記憶體中等);② 一律用 n8n 伺服器時間計算,不受工作流程時區設定影響。
Hourglass or timer icon with a workflow paused at a specific point

Wait 節點 (Wait Node)

Wait 節點用於暫停工作流程的執行。當工作流程暫停時,它將執行數據卸載到數據庫。當滿足恢復條件時,工作流程重新加載數據並繼續執行。

After Time Interval

節點等待一定的時間。

  • 設置 Wait Amount(等待時間量)
  • 選擇 Wait Unit(等待時間單位):秒、分鐘、小時或天

At Specified Time

節點等待到特定的日期和時間才繼續。

  • 使用日期和時間選擇器設置 Date and Time

On Webhook Call

節點等待接收 HTTP 調用。

  • 可以配置身份驗證、HTTP 方法、響應代碼等
  • 提供 $execution.resumeUrl 變量以引用生成的 URL

On Form Submitted

節點等待表單提交。

  • 設置表單標題、描述和字段
  • 配置表單提交後的響應方式
Custom form with various input fields and a submit button

Wait 節點 – On Webhook Call

On Webhook Call 操作允許您的工作流程在 Wait 節點接收到 HTTP 調用時恢復。

主要參數

  • Authentication:選擇傳入恢復 webhook 請求的身份驗證方式
  • HTTP Method:選擇 webhook 應使用的 HTTP 方法
  • Response Code:輸入 webhook 應返回的響應代碼
  • Respond:設置何時以及如何響應 webhook

限制等待時間

設置工作流程是否在特定限制類型後自動恢復執行:

  • After Time Interval:等待一定時間後恢復
  • At Specified Time:在指定時間恢復

使用 $execution.resumeUrl 變量可以引用生成的 URL,這個 URL 在每次執行時都是唯一的。

Wait 節點 – On Form Submitted

On Form Submitted 操作允許您的工作流程在表單提交後恢復。

表單配置

  • Form Title:顯示在表單頂部的標題
  • Form Description:顯示在標題下方的表單描述
  • Form Fields:設置要在表單中顯示的每個字段

字段類型

  • Date(日期)
  • Dropdown List(下拉列表)
  • Number(數字)
  • Password(密碼)
  • Text(文本)
  • Textarea(文本區域)

響應選項

  • Respond When:設置何時響應表單提交
  • Form Response:選擇表單如何以及用什麼響應

Wait 節點 – 基於時間的操作

對於基於時間的恢復操作,請注意以下幾點:

短時間等待

對於少於 65 秒的等待時間,工作流程不會將執行數據卸載到數據庫。相反,進程繼續運行,執行在指定間隔過後恢復。

時區設置

無論時區設置如何,始終使用 n8n 服務器時間。工作流程時區設置及其任何更改都不會影響 Wait 節點間隔或指定時間。

這些特性對於理解 Wait 節點的行為很重要,特別是在處理時間敏感的工作流程時。

Wait 節點是實現定時操作、延遲處理和外部觸發工作流程的強大工具。

Clock or calendar showing time intervals and scheduled events

總結

  • 怎麼選模式
    • 純延遲/定時:用 After Time Interval / At Specified Time
    • 等外部系統:用 On Webhook Call(把 $execution.resumeUrl 傳給對方;必要時加認證與回應設定)。
    • 人工核准/補件:用 On Form Submitted(自訂欄位與回應內容)。
  • 實務心法
    • 小於 65 秒的等待屬於進程內等待,適合短暫節流;更長的等待才會卸載到 DB、更耐久可靠。
    • 時間計算用伺服器時間(例如自架可能是 UTC 或你設的系統時區),不吃工作流程時區;跨時區流程請自已換算。
    • Webhook 回呼要驗證來源(Auth/簽名/白名單),並善用 Respond 參數決定何時回應。
    • 表單模式把必要欄位設齊,回應設定清楚(成功訊息/導頁),避免使用者重複提交。
    • 限制等待時間作為 fail-safe(逾時自動恢復),並在恢復後分支「成功回呼」與「逾時路徑」。
  • 常見搭配
    • Loop Over Items / Rate Limit 搭配,做批次節流與重試間隔。
    • IF / Filter 搭配,在恢復後依回呼結果或表單內容分流。
    • Merge(Append)收攏多條等待後的結果。
  • 避免踩雷
    • 不要把 Wait 當排程器;週期性任務應用 Schedule Trigger / Cron
    • 長時間等待前先最小化 payload,避免恢復時載入過大。
    • 需要冪等保護(外部重複回呼)時,增加去重/狀態檢查
    • 在通知或審批流程加入逾時提醒審計紀錄,便於追蹤。

把 Wait 用在該停的地方,你的工作流程就能既可控又可靠:能等、會醒、醒來就接著把事做好。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

返回頂端