Wait 节点#
使用 Wait 节点暂停工作流的执行。当工作流暂停时,它将执行数据卸载到数据库中。当恢复条件满足时,工作流重新加载数据并继续执行。
操作#
Wait 节点可以在以下条件下 Resume 恢复:
- After Time Interval 时间间隔后:节点等待一定的时间。
- At Specified Time 在指定时间:节点等待到特定时间。
- On Webhook Call 在 Webhook 调用时:节点等待直到收到 HTTP 调用。
- On Form Submitted 在表单提交时:节点等待直到收到表单提交。
有关更详细的说明,请参阅下面的更详细部分。
After Time Interval 时间间隔后#
等待一定的时间。
此参数包含两个更多字段:
- Wait Amount 等待时间:输入要等待的时间量。
- Wait Unit 等待单位:为 Wait Amount 等待时间 选择测量单位。选择:
- Seconds 秒
- Minutes 分钟
- Hours 小时
- Days 天
有关这些间隔如何工作和使用的时区的更多详细信息,请参阅基于时间的操作。
At Specified Time 在指定时间#
等待到特定的日期和时间继续。使用日期和时间选择器设置 Date and Time 日期和时间。
有关使用的时区的更多详细信息,请参阅基于时间的操作。
On Webhook Call 在 Webhook 调用时#
此参数使您的工作流能够在 Wait 节点收到 HTTP 调用时恢复。
恢复执行的 webhook URL 在运行时生成。Wait 节点提供 $execution.resumeUrl
变量,以便您可以引用并将尚未生成的 URL 发送到任何需要的地方,例如第三方服务或电子邮件中。
当工作流执行时,Wait 节点生成恢复 URL,工作流中使用 $execution.resumeUrl
的 webhook。这个生成的 URL 对每次执行都是唯一的,因此您的工作流可以包含多个 Wait 节点,当调用 webhook URL 时,它将按顺序恢复每个 Wait 节点。
对于此 Resume 恢复 样式,设置下面列出的更多参数。
Authentication 身份验证#
选择是否以及如何对传入的恢复-webhook-请求到 $execution.resumeUrl
进行身份验证。选项包括:
- Basic Auth 基本认证:使用基本身份验证。选择或输入新的 Credential for Basic Auth 基本认证凭据 使用。
- Header Auth 标头认证:使用标头身份验证。选择或输入新的 Credential for Header Auth 标头认证凭据 使用。
- JWT Auth JWT 认证:使用 JWT 身份验证。选择或输入新的 Credential for JWT Auth JWT 认证凭据 使用。
- None 无:不使用身份验证。
认证参考
有关每种认证类型的更多信息,请参阅 Webhook 节点 | 身份验证文档。
HTTP Method HTTP 方法#
选择 webhook 应使用的 HTTP 方法。有关更多信息,请参阅 Webhook 节点 | HTTP 方法文档。
Response Code 响应代码#
输入 webhook 应返回的响应代码。您可以使用常见代码或输入自定义代码。
Respond 响应#
设置何时以及如何响应 webhook,选项包括:
- Immediately 立即:节点执行后立即响应。
- When Last Node Finishes 当最后一个节点完成时:返回响应代码和工作流中执行的最后一个节点的数据输出。如果您选择此选项,还要设置:
- Response Data 响应数据:选择应返回什么数据以及使用什么格式。选项包括:
- All Entries 所有条目:在数组中返回最后一个节点的所有条目。
- First Entry JSON 第一个条目 JSON:在 JSON 对象中返回最后一个节点的第一个条目的 JSON 数据。
- First Entry Binary 第一个条目二进制:在二进制文件中返回最后一个节点的第一个条目的二进制数据。
- No Response Body 无响应正文:返回时不带正文。
- Response Data 响应数据:选择应返回什么数据以及使用什么格式。选项包括:
- Using 'Respond to Webhook' Node 使用 'Respond to Webhook' 节点:按照 Respond to Webhook 节点中定义的方式响应。
Limit Wait Time 限制等待时间#
设置工作流是否会在特定限制类型后自动恢复执行(开启)或不会(关闭)。如果开启,还要设置:
- Limit Type 限制类型:从这些选项中选择要强制执行的限制类型:
- After Time Interval 时间间隔后:等待一定的时间。
- 输入限制的 Amount 时间量。
- 选择限制的 Unit 时间单位。
- At Specified Time 在指定时间:等待到特定的日期和时间恢复。
- Max Date and Time 最大日期和时间:使用日期和时间选择器设置节点应恢复的指定时间。
- After Time Interval 时间间隔后:等待一定的时间。
On Webhook Call options 在 Webhook 调用时选项#
- Binary Property 二进制属性:输入要将接收到的文件数据写入的二进制属性的名称。此选项仅在接收到二进制数据时相关。
- Ignore Bots 忽略机器人:设置是否忽略来自机器人(如链接预览器和网络爬虫)的请求(开启)或不忽略(关闭)。
- IP(s) Whitelist IP 白名单:在此处输入 IP 地址以限制谁(或什么)可以调用 webhook URL。输入允许的 IP 地址的逗号分隔列表。来自白名单外 IP 的访问会抛出 403 错误。如果留空,所有 IP 地址都可以调用 webhook URL。
- No Response Body 无响应正文:设置 n8n 是否应在响应中发送正文(关闭)或阻止 n8n 在响应中发送正文(开启)。
- Raw Body 原始正文:设置是否以 JSON 或 XML 等原始格式返回正文(开启)或不返回(关闭)。
- Response Data 响应数据:输入您要在响应中发送的任何自定义数据。
- Response Headers 响应标头:在 webhook 响应中发送更多标头。有关响应标头的更多信息,请参阅 MDN Web Docs | Response header。
- Webhook Suffix Webhook 后缀:输入要附加到恢复 URL 的后缀。这对于在工作流包含多个 Wait 节点时为每个 Wait 节点创建唯一的 webhook URL 很有用。请注意,生成的
$resumeWebhookUrl
不会自动包含此后缀,您必须在公开 webhook URL 之前手动将其附加到其上。
On Webhook Call limitations 在 Webhook 调用时限制#
使用 On Webhook Call 时要记住一些限制:
- 工作流的部分执行会更改
$resumeWebhookUrl
,因此请确保将此 URL 发送到您所需第三方的节点与 Wait 节点在同一次执行中运行。
On Form Submitted 在表单提交时#
等待表单提交后再继续。设置这些参数:
Form Title 表单标题#
输入要在表单顶部显示的标题。
Form Description 表单描述#
输入要在标题下方显示的表单描述。此描述可以帮助提示用户如何完成表单。
Form Fields 表单字段#
使用这些参数设置您希望在表单中出现的每个字段:
- Field Label 字段标签:输入您希望在表单中出现的字段标签。
- Field Type 字段类型:选择要在表单中显示的字段类型。选择:
- Date 日期
- Dropdown List 下拉列表:在 Field Options 字段选项 中输入每个下拉选项。
- Multiple Choice 多选:选择用户是否可以选择单个下拉选项(关闭)或多个下拉选项(开启)
- Number 数字
- Password 密码
- Text 文本
- Textarea 文本区域
- Required Field 必填字段:设置用户是否必须完成此字段才能提交表单(开启)或用户是否可以在不完成此字段的情况下提交表单(关闭)。
Respond When 何时响应#
设置何时响应表单提交。选择:
- Form Is Submitted 表单已提交:此节点收到表单提交后立即响应。
- Workflow Finishes 工作流完成:此工作流的最后一个节点完成时响应。
- Using 'Respond to Webhook' Node 使用 'Respond to Webhook' 节点:Respond to Webhook 节点执行时响应。
Limit Wait Time 限制等待时间#
设置工作流是否会在特定限制类型后自动恢复执行(开启)或不会(关闭)。
如果开启,还要设置: * Limit Type 限制类型:从这些选项中选择要强制执行的限制类型: * After Time Interval 时间间隔后:等待一定的时间。 * 输入限制的 Amount 时间量。 * 选择限制的 Unit 时间单位。 * At Specified Time 在指定时间:等待到特定的日期和时间恢复。 * Max Date and Time 最大日期和时间:使用日期和时间选择器设置节点应恢复的指定时间。
On Form Response options 在表单响应时选项#
- Form Response 表单响应:从这些选项中选择您希望表单如何以及用什么 Respond With 响应内容:
- Form Submitted Text 表单提交文本:表单在用户填写表单后显示在 Text to Show 要显示的文本 中输入的任何文本。如果您想显示确认消息,请使用此选项。
- Redirect URL 重定向 URL:表单将在用户填写表单后将用户重定向到 URL to Redirect to 重定向到的 URL。这必须是有效的 URL。
- Webhook Suffix Webhook 后缀:输入要附加到恢复 URL 的后缀。这对于在工作流包含多个 Wait 节点时为每个 Wait 节点创建唯一的 webhook URL 很有用。请注意,生成的
$resumeWebhookUrl
不会自动包含此后缀,您必须在公开 webhook URL 之前手动将其附加到其上。
模板和示例#
基于时间的操作#
对于基于时间的恢复操作,请注意:
- 对于少于 65 秒的等待时间,工作流不会将执行数据卸载到数据库。相反,进程继续运行,在指定间隔过去后执行恢复。
- 无论时区设置如何,始终使用 n8n 服务器时间。工作流时区设置以及对它们所做的任何更改都不会影响 Wait 节点间隔或指定时间。