n8n 表单触发节点#

使用 n8n 表单触发节点可在用户提交表单时启动工作流，并获取表单中的输入数据。该节点会生成可供您使用的表单网页。您可以通过 n8n 表单节点添加更多页面来扩展表单功能。

构建和测试工作流#

在构建或测试工作流时，请使用测试 URL。使用测试 URL 可确保您能在编辑器界面中查看传入数据，这对调试非常有用。有两种测试方式：

当工作流准备就绪后，请切换使用生产 URL。随后您可以激活工作流，当用户提交表单时 n8n 将自动运行该工作流。使用生产 URL 时，请确保已保存并激活工作流。通过生产 URL 触发的表单数据不会显示在编辑器界面中。

您可以通过在 n8n 表单触发节点提供的初始 URL 中使用查询参数来设置字段初始值。表单中的每个页面都会接收发送至 n8n 表单触发 URL 的相同查询参数。

仅限生产环境查询参数仅在生产模式下可用。在测试模式下，n8n 不会通过查询参数填充字段值。

使用查询参数时，请对包含特殊字符的字段名或值进行百分比编码。这能确保 n8n 正确使用指定字段的初始值。您可以使用 URL 编码/解码工具对查询参数进行百分比编码处理。

示例：假设您有一个包含以下属性的表单：

通过查询参数和百分比编码，您可以使用以下 URL 将初始字段值设置为上述数据：

https://my-account.n8n.cloud/form/my-form?email=jane.doe%40example.com&name=Jane%20Doe

在此示例中，百分比编码将 at 符号（@）替换为字符串 %40，将空格字符替换为 %20。无论这些字段出现在表单的哪个页面，这都会设置这些字段的初始值。

以下是主要的节点配置字段：

配置此凭据需要提供：

表单触发器节点有两个 URL：测试 URL 和生产 URL。n8n 会在节点面板顶部显示这些 URL。选择 测试 URL 或 生产 URL 可切换 n8n 显示的 URL。表单 URL 截图

测试 URL：当您选择执行节点或执行工作流时（如果工作流未激活），n8n 会注册一个测试 webhook。调用该 URL 时，n8n 会在工作流中显示数据。
生产 URL：当您激活工作流时，n8n 会注册一个生产 webhook。使用生产 URL 时，n8n 不会在工作流中显示数据。您仍可查看生产执行的工作流数据：在工作流中选择执行记录标签页，然后选择要查看的工作流执行记录。

为表单设置自定义别名（slug）。

输入表单标题。n8n 会将表单标题显示为网页标题和表单上的主 h1 标题。

输入表单描述。n8n 会将表单描述显示为表单上主 h1 标题下方的副标题。使用 \n 或 <br> 添加换行。

为表单创建问题字段。选择添加表单元素以添加新字段。每个字段都有以下设置：

字段标签：输入显示在输入框上方的标签。
元素类型：从复选框、自定义 HTML、日期、下拉列表、邮箱、文件、隐藏字段、数字、密码、单选按钮、文本或文本区域中选择。
- 选择复选框可在表单中包含复选框元素。默认情况下，表单用户可以选择任意数量的复选框。您可以通过为限制选择选项指定精确数量、范围或无限制来设置限制。
- 选择自定义 HTML可插入任意 HTML。
  - 可以包含链接、图片、视频等元素。不能包含 <script>、<style> 或 <input> 元素。
  - 默认情况下，自定义 HTML 字段不包含在节点输出中。要将自定义 HTML 内容包含在输出中，请填写关联的元素名称字段。
- 选择日期可在表单中包含日期选择器。有关日期格式的更多信息，请参阅使用 Luxon 处理日期和时间。
- 选择下拉列表 > 添加字段选项以添加多个选项。默认情况下，下拉列表为单选。要使其为多选，请开启多选。
- 选择单选按钮可在表单中包含单选按钮元素。
- 选择隐藏字段可在表单中包含一个不显示的表单元素。您可以使用字段值参数设置默认值，或通过查询参数为该字段传递值。
必填字段：开启此选项要求用户必须填写此字段。

选择 n8n 何时对表单提交发送响应。您可以选择在以下时机响应：

点击 添加选项 可查看更多配置选项：

使用简单向量存储、表单触发器与 OpenAI 的 RAG 入门模板 作者：n8n 团队查看模板详情

将多个触发器统一至单个工作流 作者：Guillaume Duvernay 查看模板详情

通过 n8n API 和表单触发器实现工作流备份与删除至 Google Drive 作者：Arlin Perez 查看模板详情

浏览 n8n 表单触发器集成模板，或搜索全部模板