透过 n8n 集成

什么是 n8n

n8n 是一款具高度扩大性的工作流程自动化工具。透过图形化接口，用户可以以“节点”（Node）为单元，将各种应用程序、API 或数据库串连起来，轻松地设计数据抽取、处理与传送的自动化程序。n8n 支持自托管，意味着您可以将它部署在自己的服务器或云环境，并完全掌控数据安全与隐私。

核心特色

• 直觉式工作画面
  拖放式节点编辑器，无须编写程序代码即可建构复杂流程；也可透过程序代码节点加入自订逻辑。
• 丰富的集成支持
  内置的上百种常用服务节点（如 HTTP Request、Slack、Google Sheets、MySQL 等），并可轻松开发自订社群节点或第三方节点套件。
• 事件与触发机制
  支持定时触发、Webhook、Polling 等多种触发方式，灵活因应各种自动化需求。
• 可扩大与社群生态
  拥有活跃的社群与节点市场，开发者可分享自订节点套件，也能方便地安装他人开发的功能。

如何串接

1. 架设自托管 (Self-Hosted) 版 n8n

   由于目前 Ragic Node 是属于社群节点（Community Node），因此无法直接在 n8n Cloud 平台上下载与使用。若要使用该节点，您需要自行部署 自托管 (Self-Hosted) 版 n8n，并手动安装此节点以进行集成。

2. 安装 Ragic Node

   1. 进入 n8n 接口，点击左下角菜单 →“Settings”→“Community nodes”。

   2. 画面中会是所有已下载的 Community nodes。点击 Install a community node。

   3. 在弹出的窗口中，npm Package Name 字段输入 n8n-nodes-ragic，下方勾选“了解且接受使用 Community node 的风险”，点击Install。

   

   4. 完成安装后，即可在 Workflow 中搜索并找到 Ragic node（同名节点有两种：右侧带灰色箭头为 Trigger Node，不带箭头为 Action Node）。

   

3. Trigger Node (触发节点)

   功能：透过 Webhook 技术，在目标表单变更时触发工作流程。

   

   初次使用需要先新增 Credential，在 Credential to connect with 字段的菜单中点选 Create new Credential，并在弹出的窗口中设置 API Key 和 Sheet Url (由 http 开始，到 ? 的前一个字符) 后保存。

   

   在 Event 字段中设置要监听的表单事件，分别为：新增数据(Create Records)、修改数据(Update Records)、新增 & 修改数据(Create & Update Records)。

   设置完成后，单击下右上角的 Test step，此时 node 会暂时打开接收 Webhook，请根据您的设置，对目标表单进行变更，确认触发节点运作正常。(若在这步无法收到 Webhook，请参阅其他注意事项)

   

4. Action Node (动作节点)

   功能：新增/修改 数据。

   

   初次使用需要先新增 Credential，在 Credential to connect with 字段的菜单中点选 Create new Credential，并在弹出的窗口中设置 API Key 和 Server Name (e.g. www.ragic.com, ap12.ragic.com) 后保存。

   

   在 Action 字段中设置此节点的行为：新增数据(Create New Data) 或 修改数据(Update Existed Data)。

   在 Form 字段的下拉菜单中选择目标表单。若下拉菜单中找不到目标表单，又或是出现错误，请重新选择 Credential 后再试一次。

   若您将节点设置为 修改数据(Update Existed Data)，会额外显示“Record Index”字段，请输入欲更新纪录的 Node ID。

   依照 Ragic HTTP API 格式，在“JSON Body”设置要新增/修改的字段内容。

   最后，单击下右上角的Test step，确认动作节点运行正常。

   

5. 保存并启动 Workflow

   设计完成后，单击右上角“Save”，并将 Workflow 状态切换为“Active”。

其他注意事项

• 若您参照 n8n 官方文檔，使用 Docker 架设 Self-Hosted n8n，可能会遇到以下问题：
  1. Trigger Node 完全无法接收webhook请求 - 在启动 n8n 容器或节点时，加入环境变量NODEJS_PREFER_IPV4=true，以强制 Node.js 使用 IPv4 协议。*
  2. Trigger Node 偶尔无法接收webhook请求 - 内置的 tunnel 在 Windows 或某些环境下可能不稳定，建议改用更可靠的对外方案，例如：ngrok。并请在启动时设置 WEBHOOK_URL={YOUR_WEBHOOK_URL} 变量。*