メインコンテンツにスキップ

認証トークンとAPIトークンの作成

Finを外部システムと連携するための認証トークンとAPIトークンの設定方法。

Finを外部システム(例:Stripe)と連携するには、Finワークスペースで認証トークンを設定し、正しく構成する必要があります。以下に詳細な手順を示します👇


Finで認証トークンを作成する

  1. 設定 > 認証 に移動します。

  2. 新しいトークンをクリックします。

  3. 以下の値でトークンの項目を入力します:

    1. トークンタイトルを入力します。

    2. 説明を入力します。

    3. タイプを選択します(例:Text、HTTP request、user)。

    4. トークン値の欄にAPIキーを入力します。これは秘密のテストキー(例:sk_test_...)またはライブキー(例:sk_live_...)です。

    5. トークンのプレフィックスをBearerに設定します。

    6. リクエストヘッダーのキーをAuthorizationに設定します。

この手順を完了すると、リクエスト送信時に以下の形式に従った認証トークンが作成されます。例:

Authorization: Bearer <your_stripe_api_key>

データコネクタでトークンを設定する

  1. 設定 > データコネクタに移動します。

  2. 既存のデータコネクタを選択するか、新規作成します。

  3. 認証トークンを選択できるセクションを探します。

  4. 先ほどFinで作成したトークンを選択します。

  5. 設定を保存または確認して連携を完了します。

これでAPIキーがFinサポートに正常にリンクされました。この設定により、外部システムとFin間のシームレスで安全な通信が可能になり、Fin workflows内で外部データに直接アクセスできます。


マルチトークンサポート

1つのデータコネクタに複数のトークンを添付できます。添付する各トークンはユニークなヘッダーキー(例:AuthorizationX-API-Key)で設定する必要があります。すべてのトークンはリクエストと共に送信されます。

この設定により、そのトークンを使ってWorkflowsまたはFin経由でデータコネクタをトリガーできます。トークン値が更新されてもリアルタイムでリフレッシュされるため、認証が途切れることなく動作し続けます。

ユーザーごとのJWTをデータコネクタで使用するには、「User」認証トークンを作成し、Messengerのintercom_user_jwtに頼るのではなく、auth_tokens(例:Intercom('setAuthTokens'))経由で現在の値を提供してください。


FinでAPIトークンを作成する(OAuthトークン)

APIトークンは個々のチームメンバーが作成でき、外部アプリがAPI経由でFinデータにアクセスすることを可能にします。

  1. APIトークンを作成をクリックします。

  2. APIトークンの名前を入力し、作成をクリックします。

OAuthトークンを使ってFin APIに認証できます。例:

GET https://api.intercom.io/conversations/123
Authorization: Bearer <your_oauth_token>

注意:

  • これらのトークンはApp Packagesで作成されたトークンと同様に機能します。Finはワークスペース用にプライベートなApp Packageを自動で作成します。

  • 個人セクションのAPIトークン作成ボタンは、Fin for Platforms(スタンドアロン)ワークスペースのみ対応しています。Intercom SuiteではAPIアクセスはアプリ統合接続で管理されます。

  • 2026年7月以降、OAuthアプリトークンはアプリを承認したチームメンバーの会話アクセス設定に制限されます。APIで全会話にアクセスするには、承認したチームメンバーが「すべての会話」アクセス権を持っている必要があります。この設定を更新した場合、変更を反映するためにトークンを再生成する必要があります。

こちらの回答で解決しましたか?