N8N中文教程
集成节点/Built in_nodes/Core_nodes

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 节点的间隔或指定时间。