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 请求进行身份验证。选项包括:
- Basic Auth:使用基本身份验证。选择或输入新的Basic Auth凭证。
- Header Auth:使用头部身份验证。选择或输入新的Header Auth凭证。
- JWT Auth:使用 JWT 身份验证。选择或输入新的JWT Auth凭证。
- None:不使用身份验证。
身份验证参考
有关每种身份验证类型的更多信息,请参阅 Webhook 节点 | 身份验证文档。
HTTP 方法#
选择 webhook 应使用的 HTTP 方法。更多信息请参阅 Webhook 节点 | HTTP 方法文档。
响应代码#
输入 webhook 应返回的响应代码。您可以使用常见代码或输入自定义代码。
响应方式#
设置何时以及如何响应来自以下选项的 webhook:
- 立即响应:节点执行后立即响应。
- 当最后一个节点完成时:返回响应代码和工作流中最后执行节点的数据输出。如果选择此选项,还需设置:
- 响应数据:选择应返回的数据及其格式。选项包括:
- 所有条目:以数组形式返回最后一个节点的所有条目。
- 首个条目 JSON:以 JSON 对象形式返回最后一个节点首个条目的 JSON 数据。
- 首个条目二进制:以二进制文件形式返回最后一个节点首个条目的二进制数据。
- 无响应体:返回无内容响应。
- 响应数据:选择应返回的数据及其格式。选项包括:
- 使用'响应 Webhook'节点:按照 Respond to Webhook 节点中的定义进行响应。
等待时间限制#
设置工作流是否会在特定限制类型后自动恢复执行(开启)或不恢复(关闭)。如果开启,还需设置:
- 限制类型:从以下选项中选择要实施的限制类型:
- 时间间隔后:等待特定时长。
- 输入限制的时间量。
- 选择限制的时间单位。
- 在指定时间:等待至特定日期和时间恢复。
- 最大日期和时间:使用日期时间选择器设置节点应恢复的具体时间。
- 时间间隔后:等待特定时长。
Webhook 调用选项#
- 二进制属性:输入用于存储接收文件数据的二进制属性名称。仅当接收到二进制数据时此选项才相关。
- 忽略机器人:设置是否忽略来自链接预览器和网络爬虫等机器人的请求(开启)或不忽略(关闭)。
- IP白名单:输入IP地址以限制可调用webhook URL的访问者。输入逗号分隔的允许IP地址列表。来自白名单外的IP访问将返回403错误。留空则表示所有IP都可调用webhook URL。
- 无响应体:设置n8n是否应在响应中包含响应体(关闭)或阻止n8n发送响应体(开启)。
- 原始体:设置是否以JSON或XML等原始格式返回响应体(开启)或不返回(关闭)。
- 响应数据:输入您希望在响应中发送的任何自定义数据。
- 响应头:在webhook响应中发送更多头信息。参考MDN Web文档 | 响应头了解更多关于响应头的信息。
- Webhook后缀:输入要附加到恢复URL的后缀。当工作流包含多个Wait节点时,这可用于为每个Wait节点创建唯一的webhook URL。注意生成的
$resumeWebhookUrl
不会自动包含此后缀,您必须在公开webhook URL前手动添加它。
Webhook 调用限制#
使用Webhook调用时需要注意以下限制:
- 工作流的部分执行会改变
$resumeWebhookUrl
,因此请确保将此URL发送给第三方节点的操作与Wait节点在同一执行中运行。
表单提交时等待#
等待表单提交后再继续。设置以下参数:
表单标题#
输入要显示在表单顶部的标题。
表单描述#
输入表单描述内容,该描述将显示在标题下方,用于指导用户如何填写表单。
表单字段#
通过以下参数设置表单中需要显示的每个字段:
- 字段标签:输入表单中显示的字段标签名称
- 字段类型:选择表单中显示的字段类型,可选类型包括:
- 日期
- 下拉列表:在字段选项中输入每个下拉选项
- 多选:设置用户只能选择单个选项(关闭)还是多个选项(开启)
- 数字
- 密码
- 文本
- 文本域
- 必填字段:设置用户必须填写该字段才能提交表单(开启),或允许用户不填写直接提交(关闭)
响应时机#
设置何时响应表单提交,可选选项:
- 表单提交时:当该节点收到表单提交时立即响应
- 工作流结束时:当本工作流最后一个节点完成时响应
- 使用"响应Webhook"节点:当响应Webhook节点执行时响应
等待时间限制#
设置工作流是否会在特定限制条件后自动恢复执行(开启)或不自动恢复(关闭)
如果开启,还需设置: * 限制类型:从以下选项中选择强制执行的时间限制类型: * 时间间隔后:等待特定时长 * 输入时间限制的数值 * 选择时间限制的单位 * 指定时间点:等待至特定日期时间恢复 * 最大日期时间:使用日期时间选择器设置节点应恢复执行的具体时间
表单响应选项#
- 表单响应:从以下选项中选择表单的响应方式和响应内容:
- 表单提交文本:用户填写表单后,表单会显示在要显示的文本字段中输入的内容。如需显示确认消息,请使用此选项。
- 重定向 URL:用户填写表单后将被重定向至重定向目标 URL。此处必须输入有效的 URL 地址。
- Webhook 后缀:输入要附加到恢复 URL 的后缀。当工作流包含多个 Wait 节点时,此功能可用于为每个 Wait 节点创建唯一的 webhook URL。注意:生成的
$resumeWebhookUrl
不会自动包含此后缀,您必须在公开 webhook URL 前手动将其附加到 URL 中。
模板与示例#
基于时间的操作#
对于基于时间的恢复操作,请注意:
- 当等待时间小于 65 秒时,工作流不会将执行数据卸载到数据库。相反,进程会继续运行,并在指定时间间隔过后恢复执行。
- 无论时区设置如何,始终使用 n8n 服务器时间。工作流时区设置及其任何更改都不会影响 Wait 节点的时间间隔或指定时间。