n8n

• 1. 開啟節點面板。在工作流程中點選「+」，搜尋「Sofia」。
• 2. 安裝節點。選擇 Sofia，然後點選「Install node」。執行個體擁有者安裝一次，所有成員即可使用。
• 3. 或者安裝套件。在自架執行個體上，開啟「Settings › Community nodes › Install」，輸入套件名稱 n8n-nodes-sofia-post。

• 1. 建立個人金鑰。在設定的「Sofia API」頁面，「個人存取」標籤頁，點選「新增金鑰」。它只顯示一次。
• 2. 在 n8n 中建立憑證。新增一個「Sofia API」憑證，把金鑰貼上到「Personal Key」欄位（sofia_pk_live_…）。「API URL」保持不變；n8n 會用 GET /v1/me 測試金鑰。
• 3. 在工作流程中使用。一個憑證即可存取你所有的門市，權限與你相同。

「Establishment」和「Accounts」清單來自你的門市和已連接帳號。「Schedule At」留空即立即發布；日期按工作流程的時區讀取。「Draft」會儲存貼文而不發布。欄位不一致（帶日期的草稿、不完整的媒體地址）會在貼文建立之前就被拒絕。

• 1. 建立貼文。新增一個「Sofia」節點，選擇「Post › Create」，選好門市及其帳號，寫好文字，然後在「Additional Fields」下新增「Media URLs」和「Schedule At」。
• 2. 讀取狀態。再新增一個「Sofia」節點，選擇「Post › Get」，把上一步傳回的 id 交給它。貼文送出後，它的 status 會是 published、partial 或 failed，並附帶各網路的連結和回應。
• 3. 處理失敗。用一個「Sofia Trigger」節點選擇「Post Failed」來啟動另一個工作流程，並把它連接到 Slack 或電子郵件節點，附上下面的訊息。

{{ $json.platforms }}: {{ $json.errors }}

觸發條件會輪詢 Sofia。它從工作流程啟用之後出現的貼文開始：更早的貼文不會重放。「Fetch Test Event」會顯示最新的一條貼文，方便你對應欄位；選擇某個門市後，只監看該門市。

• 401：金鑰已失效，請新增一個金鑰並貼上到同一個憑證中。
• 429：呼叫過多；錯誤訊息會說明需要等待多少秒後再重試。
• 其他拒絕情況：Sofia 的錯誤及其程式碼會顯示在 n8n 中。啟用「Continue On Fail」後，被拒絕的項目會變成一個 error 項目，而不會中斷工作流程。

如果你的自動化已經在 n8n 裡，就用 n8n。如果你的工具能接入 Zapier，優先用 Zapier；需要寫程式碼時，請使用 Webhook 或 Sofia API。