需要「先停一下,再繼續」的情境很多:等 10 分鐘再重試、等外部系統回呼、等人工核准表單。
Wait 節點正是為此而生:它會在暫停時把執行狀態卸載到資料庫,待條件達成後再恢復並續跑。
可選模式包含:
- After Time Interval:等秒/分/時/天。
- At Specified Time:等到指定日期時間。
- On Webhook Call:收到 HTTP 回呼就繼續(每次執行都有唯一的
$execution.resumeUrl
)。 - On Form Submitted:顯示表單,等使用者提交再續跑。
另外可設定限制等待時間(逾時自動恢復),並在 Webhook 模式中設定驗證、HTTP Method、回應碼與回應時機。
兩個關鍵特性必記:① 短於 65 秒的等待不會卸載到 DB(在記憶體中等);② 一律用 n8n 伺服器時間計算,不受工作流程時區設定影響。
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
節點等待表單提交。
- 設置表單標題、描述和字段
- 配置表單提交後的響應方式
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 節點是實現定時操作、延遲處理和外部觸發工作流程的強大工具。
總結
- 怎麼選模式
- 純延遲/定時:用 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 用在該停的地方,你的工作流程就能既可控又可靠:能等、會醒、醒來就接著把事做好。