Skip to content

Respond to Webhook 节点#

使用 Respond to Webhook 节点控制对传入 webhook 的响应。此节点与 Webhook 节点配合使用。

为第一个数据项运行一次

Respond to Webhook 节点运行一次，使用第一个传入的数据项。有关更多信息，请参阅返回多个数据项。

如何使用 Respond to Webhook#

要使用 Respond to Webhook 节点：

  1. 添加一个 Webhook 节点作为工作流的触发器节点。
  2. 在 Webhook 节点中，将 Respond 响应 设置为 Using 'Respond to Webhook' node 使用 'Respond to Webhook' 节点。
  3. 在工作流中的任何位置添加 Respond to Webhook 节点。如果您希望它返回来自其他节点的数据，请将其放在这些节点之后。

节点参数#

使用这些参数配置节点行为。

Respond With 响应内容#

选择在 webhook 响应中发送什么数据。

  • All Incoming Items 所有传入项目：使用输入中的所有 JSON 项目进行响应。
  • Binary File 二进制文件：使用在 Response Data Source 响应数据源 中定义的二进制文件进行响应。
  • First Incoming Item 第一个传入项目：使用第一个传入项目的 JSON 进行响应。
  • JSON：使用在 Response Body 响应正文 中定义的 JSON 对象进行响应。
  • JWT Token JWT 令牌：使用 JSON Web Token (JWT) 进行响应。
  • No Data 无数据：无响应载荷。
  • Redirect 重定向：重定向到在 Redirect URL 重定向 URL 中设置的 URL。
  • Text 文本：使用在 Response Body 响应正文 中设置的文本进行响应。

节点选项#

选择 Add Option 添加选项 查看和设置选项。

  • Response Code 响应代码：设置要使用的响应代码。
  • Response Headers 响应标头：定义要发送的响应标头。
  • Put Response in Field 将响应放入字段：当您使用 All Incoming Items 所有传入项目 或 First Incoming Item 第一个传入项目 响应时可用。设置包含响应数据的字段的字段名称。

模板和示例#

Creating an API endpoint

by Jonathan

View template details
Create a Branded AI-Powered Website Chatbot

by Wayne Simpson

View template details
⚡AI-Powered YouTube Video Summarization & Analysis

by Joseph LePage

View template details
Browse 响应 Webhook integration templates, or search all templates

工作流行为#

使用 Respond to Webhook 节点时，工作流的行为如下：

  • 工作流完成而不执行 Respond to Webhook 节点：它返回带有 200 状态的标准消息。
  • 工作流在第一个 Respond to Webhook 节点执行之前出错：工作流返回带有 500 状态的错误消息。
  • 第二个 Respond to Webhook 节点在第一个节点之后执行：工作流忽略它。
  • Respond to Webhook 节点执行但没有 webhook：工作流忽略 Respond to Webhook 节点。

输出发送到 webhook 的响应#

默认情况下，Respond to Webhook 节点有一个包含节点输入数据的单一输出分支。

您可以选择启用包含发送到 webhook 的响应的第二个输出分支。要启用此辅助输出，在画布上打开 Respond to Webhook 节点并选择 Settings 设置 选项卡。激活 Enable Response Output Branch 启用响应输出分支 选项。

节点现在将有两个输出：

  • Input Data 输入数据：原始输出，传递节点的输入。
  • Response 响应：发送到 webhook 的响应对象。

返回多个数据项（已弃用）#

在 1.22.0 中已弃用

n8n 1.22.0 添加了使用 All Incoming Items 所有传入项目 选项返回所有数据项的支持。n8n 建议升级到最新版本的 n8n，而不是使用本节中描述的变通方法。

Respond to Webhook 节点运行一次，使用第一个传入的数据项。这包括使用表达式时。您不能使用 Loop 节点强制循环：工作流将运行，但 webhook 响应仍将只包含第一次执行的结果。

如果您需要返回多个数据项，请选择以下选项之一：

  • 不使用 Respond to Webhook 节点，而在 Webhook 节点的 Respond 响应 中使用 When Last Node Finishes 当最后一个节点完成时 选项。当您想要返回工作流输出的最终数据时使用此选项。
  • 在将数据传递给 Respond to Webhook 节点之前，使用 Aggregate 节点将多个项目转换为单个项目。将 Aggregate 聚合 设置为 All Item Data (Into a Single List) 所有项目数据（到单个列表中）。