スコープ付きキーによるZapierとn8n

Zapierとn8nは、開発者APIとWebhookを通じてLabeeqと通信します。それぞれにスコープ付きキーが付与されます。これは、選択した機能のみを実行でき、自分の役割で許可される以上のことは決して実行できないトークンです。

キーを作成する

1. 1 設定 → 統合 を開き、Zapierまたはn8nを選択します。
2. 2 APIキーを生成する を押します。通常、アプリが必要とする連絡先、会話、メッセージ、ディール、タスクが選択されています。ワークフローで使用しないものはオフにしてください。
3. 3 オプションで、キーを自分のサーバーアドレスにピン留めし（n8nを自分で実行している場合に便利）、有効期限を設定します。
4. 4 キーは一度しか表示されないため、すぐにコピーしてください。開発者APIページにも他のトークンと一緒にリストされます。

接続する

• アクション：Zapierでは「Webhooks by Zapier」のカスタムリクエストを追加します。n8nではHTTPリクエストノードを追加します。AuthorizationヘッダーにBearerトークンとしてキーを送信します。
• トリガー：ZapierではCatch Hookを使用します。n8nではWebhookノードを使用します。WebhookページでURLを登録し、必要なイベントを選択し、ペイロードを信頼する前にX-Labeeq-Signatureヘッダーを確認します。

キーのローテーションと古いキー

• 再生成すると新しいキーが生成され、古いキーは選択した期間（すべてのワークフローに貼り付けるのに十分な期間）有効なままになります。取り消しはキーを即座に無効にします。
• スコープ付きキーより前に作成されたキーは、すべての機能を持っており、レガシーとマークされています。「スコープ付きトークンに切り替える」を押すと、ワークフローを壊すことなく置き換えることができます。