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. ワークフローで使います。 1 つの認証情報で、あなたの権限で、すべての店舗にアクセスできます。

「Establishment」と「Accounts」のリストは、店舗と接続済みアカウントから自動で入力されます。「Schedule At」を空にすると、すぐに公開します。日付はワークフローのタイムゾーンで読み取られます。「Draft」は、投稿を公開せずに保存します。整合しない項目（日付つきの下書きや不完全なメディアアドレス）は、投稿が作成される前に拒否されます。

• 1. 投稿を作成します。「Sofia」ノードを追加して「Post › Create」にし、店舗とそのアカウントを選んで本文を書きます。続いて「Additional Fields」で「Media URLs」と「Schedule At」を追加します。
• 2. 状態を読み取ります。 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 を選びます。