Wait#
Wait 节点用于暂停工作流的执行。当工作流暂停时,执行数据会被卸载到数据库中。当满足恢复条件时,工作流将重新加载数据并继续执行。
操作#
Wait 节点可在以下条件下恢复执行:
- 时间间隔后:节点等待指定时长
- 指定时间点:节点等待至特定时间点
- Webhook 调用时:节点等待接收到 HTTP 调用
- 表单提交时:节点等待接收到表单提交
详细操作说明请参阅下文各章节。
时间间隔后#
等待指定时间长度。 该参数包含两个配置字段:
- 等待时长:输入需要等待的时间数值
- 时间单位:选择等待时长的计量单位。可选选项:
- 秒
- 分钟
- 小时
- 天
请参考基于时间的操作了解这些间隔的工作方式和所使用的时区。
指定时间#
等待直到特定日期和时间再继续执行。使用日期和时间选择器设置日期和时间。 请参考基于时间的操作了解所使用的时区详情。
通过Webhook调用#
此参数使您的工作流在Wait节点收到HTTP调用时恢复执行。
用于恢复执行的webhook URL将在运行时生成。Wait节点提供$execution.resumeUrl变量,以便您可以在需要的地方引用和发送这个尚未生成的URL,例如发送给第三方服务或包含在电子邮件中。
当工作流执行时,Wait节点会使用$execution.resumeUrl生成恢复URL和工作流中的webhook。这个生成的URL对每次执行都是唯一的,因此您的工作流可以包含多个Wait节点,当webhook URL被调用时,它将按顺序恢复每个Wait节点。
对于这种恢复模式,请设置下面列出的更多参数。
身份验证#
选择是否以及如何对发送到$execution.resumeUrl的恢复webhook请求进行身份验证。选项包括:
- 基础认证:使用基础认证。选择或输入新的基础认证凭据。
- 头部认证:使用头部认证。选择或输入新的头部认证凭据。
- JWT认证:使用JWT认证。选择或输入新的JWT认证凭据。
- 无:不使用身份验证。
认证参考 有关每种认证类型的更多信息,请参阅 Webhook 节点 | 认证文档。
HTTP 方法#
选择 Webhook 应使用的 HTTP 方法。更多信息请参阅 Webhook 节点 | HTTP 方法文档。
响应代码#
输入 Webhook 应返回的响应代码。您可以使用常用代码或输入自定义代码。
响应方式#
从以下选项设置何时以及如何响应 Webhook:
- 立即响应:节点执行后立即响应
- 当最后节点完成时:返回工作流中最后执行节点的响应代码和数据输出。如果选择此选项,还需设置:
- 响应数据:选择应返回的数据及使用的格式。选项包括:
- 所有条目:以数组形式返回最后节点的所有条目
- 首条目 JSON:以 JSON 对象形式返回最后节点第一个条目的 JSON 数据
- 首条目二进制:以二进制文件形式返回最后节点第一个条目的二进制数据
- 无响应体:不返回响应体
- 响应数据:选择应返回的数据及使用的格式。选项包括:
- 使用 '响应 Webhook' 节点:按照 响应 Webhook 节点中的定义进行响应
限制等待时间#
设置工作流是否在特定限制类型后自动恢复执行(开启)或不自动恢复(关闭)。如果开启,还需设置:
- 限制类型:从以下选项中选择要实施的限制类型:
- 时间间隔后:等待特定时长
- 输入限制的时间数量
- 选择限制的时间单位
- 指定时间:等待到特定日期和时间再恢复
- 最大日期和时间:使用日期和时间选择器设置节点应恢复执行的具体时间
- 时间间隔后:等待特定时长
关于 Webhook 调用选项#
- 二进制属性:输入用于存储接收文件数据的二进制属性名称。仅当接收到二进制数据时此选项才相关。
- 忽略机器人:设置是否忽略来自链接预览器和网络爬虫等机器人的请求(开启)或不忽略(关闭)。
- IP 白名单:在此输入 IP 地址以限制可调用 webhook URL 的访问者。输入逗号分隔的允许 IP 地址列表,非白名单 IP 的访问将抛出 403 错误。若留空则所有 IP 地址均可调用该 webhook URL。
- 无响应体:设置 n8n 是否在响应中发送响应体(关闭),或阻止 n8n 在响应中发送响应体(开启)。
- 原始正文:设置是否以原始格式(如 JSON 或 XML)返回正文(开启)或不返回(关闭)。
- 响应数据:输入需要在响应中发送的任何自定义数据。
- 响应头:在 webhook 响应中发送更多头部信息。请参阅 MDN Web 文档 | 响应头 了解响应头的更多信息。
- Webhook 后缀:输入要附加到恢复 URL 的后缀。当工作流包含多个等待节点时,此功能可用于为每个等待节点创建唯一的 webhook URL。注意:生成的
$resumeWebhookUrl不会自动包含此后缀,您必须在暴露 webhook URL 前手动将其附加到 URL 中。
关于 Webhook 调用限制#
使用 Webhook 调用时需要注意以下限制:
- 工作流的部分执行会改变
$resumeWebhookUrl,因此请确保将此 URL 发送给第三方目标节点的操作与等待节点在同一执行流程中运行。
表单提交时#
等待表单提交后再继续执行。需设置以下参数:
表单标题#
输入将显示在表单顶部的标题文本。
表单描述#
输入将显示在标题下方的表单描述。该描述可指导用户如何填写表单。
表单字段#
通过以下参数配置表单中需要显示的每个字段:
- 字段标签:输入表单中要显示的字段标签
- 字段类型:选择表单中要显示的字段类型。可选类型包括:
- 日期
- 下拉列表:在字段选项中输入每个下拉选项
- 多选:设置用户可选择单个下拉选项(关闭)或多个下拉选项(开启)
- 数字
- 密码
- 文本
- 文本域
- 必填字段:设置用户是否必须填写此字段才能提交表单(开启),或是否可不填写直接提交(关闭)
响应时机#
设置何时响应表单提交。可选选项:
- 表单提交时:当此节点收到表单提交后立即响应
- 工作流完成时:当本工作流最后一个节点执行完成时响应
- 使用'响应Webhook'节点时:当响应Webhook节点执行时响应
限制等待时间#
设置工作流是否在特定限制类型后自动恢复执行(开启)或不自动恢复(关闭)。 若开启,还需设置:_ 限制类型:从以下选项中选择要实施的限制类型:_ 时间间隔后:等待特定时长。_ 输入限制的时间数量。_ 选择限制的时间单位。_ 指定时间点:等待至特定日期和时间再恢复。_ 最大日期和时间:使用日期和时间选择器设置节点应恢复的具体时间。
表单响应选项#
- 表单响应:从以下选项中选择表单的响应方式和响应内容:
- 表单提交文本:用户填写表单后,表单将显示在要显示的文本字段中输入的内容。若需显示确认信息,请使用此选项。
- 重定向网址:用户填写表单后,表单将重定向至要重定向的网址。此处必须填写有效的网址。
- Webhook 后缀:输入要附加到恢复网址的后缀。当工作流包含多个等待节点时,此功能可用于为每个等待节点创建唯一的 Webhook 网址。注意:生成的
$resumeWebhookUrl不会自动包含此后缀,您必须在公开 Webhook 网址前手动将其附加到网址中。
模板与示例#
使用 Seedance 生成 AI 病毒视频并上传至 TikTok、YouTube 和 Instagram 作者:Firas 博士 查看模板详情
使用 Google Veo3 生成 AI 视频,保存至 Google 云端硬盘并上传至 YouTube 作者:Davide 查看模板详情
无需第三方 API 从 Google 地图抓取企业邮箱 作者:Akram Kadri 查看模板详情
浏览 Wait 集成模板,或搜索所有模板
基于时间的操作#
关于基于时间的恢复操作,请注意:
- 对于少于 65 秒的等待时间,工作流不会将执行数据卸载到数据库。相反,进程会持续运行,并在指定间隔过后恢复执行。
- 无论时区设置如何,始终使用 n8n 服务器时间。工作流时区设置及其任何更改都不会影响 Wait 节点的间隔或指定时间。