n8n

閱讀約 1 分鐘

使用經 n8n 驗證的 Sofia 節點，你可以在任何一個 n8n 工作流程中發布、排程並追蹤你的帖文：只需要一個個人金鑰就夠了。

Sofia 的 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. 在工作流程中使用。一個憑證即可存取你所有的門市，權限與你相同。

項目	n8n 中的名稱	作用
操作	Sofia › Post › Create	發布、排程或儲存草稿，每個所選帳戶對應一條帖文，媒體透過地址提供
操作	Sofia › Post › Get	讀取一條帖文及其在各網絡上的狀態
觸發條件	Sofia Trigger › Post Published	帖文在至少一個網絡上發布成功時啟動工作流程
觸發條件	Sofia Trigger › Post Failed	有網絡拒絕帖文時啟動工作流程，即使其他網絡已發布成功

「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。

這篇文章有幫助嗎？