Finを外部システム(例:Stripe)と連携するには、Finワークスペースで認証トークンを設定し、正しく構成されていることを確認する必要があります。以下に詳細な手順を示します👇
Finで認証トークンを作成する
設定 > 認証 に移動します。
新しいトークンをクリックします。
以下の値でトークンの各項目を入力します:
トークンタイトルを入力します。
説明を入力します。
タイプを選択します(例:テキスト、HTTPリクエスト、ユーザー)。
トークン値の欄に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を自動的に作成します。


