Finを外部システム(例:Stripe)と連携するには、Finワークスペースで認証トークンを設定し、正しく構成する必要があります。以下に詳細な手順を示します👇
Finで認証トークンを作成する
設定 > 認証 に移動します。
新しいトークンをクリックします。
以下の値でトークンの項目を入力します:
トークンタイトルを入力します。
説明を入力します。
タイプを選択します(例:Text、HTTP request、user)。
トークン値の欄にAPIキーを入力します。これは秘密のテストキー(例:
sk_test_...)またはライブキー(例:sk_live_...)です。トークンのプレフィックスをBearerに設定します。
リクエストヘッダーのキーをAuthorizationに設定します。
この手順を完了すると、リクエスト送信時に以下の形式に従った認証トークンが作成されます。例:
Authorization: Bearer <your_stripe_api_key>
データコネクタでトークンを設定する
設定 > データコネクタに移動します。
既存のデータコネクタを選択するか、新規作成します。
認証トークンを選択できるセクションを探します。
先ほどFinで作成したトークンを選択します。
設定を保存または確認して連携を完了します。
これでAPIキーがFinサポートに正常にリンクされました。この設定により、外部システムとFin間のシームレスで安全な通信が可能になり、Fin workflows内で外部データに直接アクセスできます。
マルチトークンサポート
1つのデータコネクタに複数のトークンを添付できます。添付する各トークンはユニークなヘッダーキー(例:Authorization、X-API-Key)で設定する必要があります。すべてのトークンはリクエストと共に送信されます。
この設定により、そのトークンを使ってWorkflowsまたはFin経由でデータコネクタをトリガーできます。トークン値が更新されてもリアルタイムでリフレッシュされるため、認証が途切れることなく動作し続けます。
ユーザーごとのJWTをデータコネクタで使用するには、「User」認証トークンを作成し、Messengerのintercom_user_jwtに頼るのではなく、auth_tokens(例:Intercom('setAuthTokens'))経由で現在の値を提供してください。
FinでAPIトークンを作成する(OAuthトークン)
APIトークンは個々のチームメンバーが作成でき、外部アプリがAPI経由でFinデータにアクセスすることを可能にします。
設定 > 個人 > APIトークンに移動します。
APIトークンを作成をクリックします。
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で全会話にアクセスするには、承認したチームメンバーが「すべての会話」アクセス権を持っている必要があります。この設定を更新した場合、変更を反映するためにトークンを再生成する必要があります。


