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）
  • 定期檢查自動化日誌以確保系統正常運行