n8n 工作流程文檔

完整的 n8n 自動化工作流程設定指南

系統整合說明

本系統透過 n8n 工作流程引擎實現電商廣告的完整自動化閉環。以下是五大核心工作流程的詳細說明。

Webhook 端點

系統提供以下 API 端點供 n8n 呼叫:

  • /api/trpc/webhooks.productListing - 產品刊登回調
  • /api/trpc/webhooks.syncPerformance - 數據同步回調
  • /api/trpc/automationLogs.create - 記錄執行日誌
  • /api/trpc/optimizationActions.create - 記錄優化動作
產品自動上架流程
將測試產品自動上架到電商平台的完整流程

流程步驟:

  1. 1Webhook 接收產品資料
  2. 2驗證產品資料完整性
  3. 3呼叫電商平台 API 建立產品
  4. 4上傳產品圖片
  5. 5設定產品價格和庫存
  6. 6發布產品並更新系統狀態
廣告自動投放流程
根據產品資訊自動建立和啟動廣告活動

流程步驟:

  1. 1Webhook 接收產品和廣告策略
  2. 2根據策略選擇廣告平台
  3. 3生成廣告素材(文案、圖片)
  4. 4呼叫廣告平台 API 建立活動
  5. 5設定目標受眾和預算
  6. 6啟動廣告並記錄到系統
數據同步與分析流程
定時從各平台同步數據並計算關鍵指標

流程步驟:

  1. 1Cron 定時觸發(每小時)
  2. 2從電商平台獲取銷售數據
  3. 3從廣告平台獲取廣告數據
  4. 4計算 ROI、ROAS、轉換率等指標
  5. 5儲存數據到資料庫
  6. 6觸發數據分析流程
智能廣告優化流程
根據數據分析自動調整廣告策略

流程步驟:

  1. 1讀取最新數據分析結果
  2. 2識別表現不佳的廣告
  3. 3根據規則決定優化動作
  4. 4呼叫廣告平台 API 執行優化
  5. 5記錄優化動作
  6. 6發送優化報告
異常警報流程
監控關鍵指標並發送異常通知

流程步驟:

  1. 1監控關鍵指標(預算、轉換率等)
  2. 2檢測異常條件
  3. 3生成警報訊息
  4. 4發送通知(Email、Slack、SMS)
  5. 5記錄異常事件
實作建議
設定 n8n 工作流程的最佳實踐

1. 安全性設定

  • 使用環境變數儲存 API 金鑰和敏感資訊
  • 為 Webhook 端點設定驗證機制
  • 定期輪換 API 憑證

2. 錯誤處理

  • 在每個關鍵步驟添加錯誤處理節點
  • 設定重試機制以應對暫時性失敗
  • 記錄詳細的錯誤訊息到系統日誌

3. 監控與通知

  • 設定關鍵指標的監控閾值
  • 配置多種通知渠道(Email、Slack、SMS)
  • 定期檢查自動化日誌以確保系統正常運行