透過 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} 變數。*