外部システム(例:Stripe)とFinを統合するには、Finワークスペースで認証トークンを設定し、正しく構成されていることを確認する必要があります。以下は詳細な手順です👇
Finで認証トークンを作成する
設定 > 認証 に移動します。
New token をクリックします。
トークンの項目に次の値を入力します:
token title を入力します。
説明を入力します。
タイプを選択します(例:Text、HTTP request、user)。
トークンの値の欄にAPIキーを入力します。これはテスト用のシークレットキー(例:
sk_test_...)または本番用キー(例:sk_live_...)のいずれかです。トークンのプレフィックスを Bearer に設定します。
リクエストヘッダーのキーを Authorization に設定します。
この手順を完了すると、リクエストで送信されるときに次の形式に従う認可トークンが作成されます。例えば:
Authorization: Bearer <your_stripe_api_key>
データコネクタでトークンを構成する
設定 > Data connectors に移動します。
既存のデータコネクタを選択するか、新しいものを作成します。
認証トークンを選択できるセクションを探します。
先ほどFinで作成したトークンを選択します。
設定を保存または確認して統合を完了します。
これでAPIキーはFinサポートに正常にリンクされます。この設定により、外部システムとFin間の通信がシームレスかつ安全になり、Fin内で外部データに直接アクセスできるようになります。
複数トークンのサポート
複数のトークンを単一のData connectorに添付できます。添付される各トークンはunique header key(例:Authorization、X-API-Key)で構成する必要があります。添付されたすべてのトークンはリクエストと共に送信されます。
この設定により、そのトークンを使用してData connectorをトリガーできます — WorkflowsまたはFinを通じて。トークン値が更新されてもData connectorは動作し続け、認証が途切れないようリアルタイムで更新されます。
Data connectorでユーザーごとのJWTを使用するには、’User’認証トークンを作成し、その現在の値をMessengerのintercom_user_jwtに頼るのではなく、auth_tokens(例:Intercom('setAuthTokens'))経由で提供してください。
FinでAPIトークンを作成する(OAuthトークン)
APIトークンは、個々のチームメンバーがFinのデータにAPI経由でアクセスできるように作成できます。
設定 > Personal > API tokens に移動します。
Create API token. をクリックします。
APIトークンのnameを入力し、Create. をクリックします。
OAuthトークンを使用してFin APIに対して認証することができます。例:
GET https://api.intercom.io/conversations/123
Authorization: Bearer <your_oauth_token>
Note:
これらのトークンは、App Packagesを通じて作成されたトークンと同様に機能します。Finはワークスペース用にプライベートなApp Packageを自動的に作成します。
PersonalセクションのCreate API tokenボタンは、Fin for Platforms(Standalone)ワークスペースでのみサポートされています。Intercom Suiteでは、APIアクセスは代わりにアプリ統合接続を介して管理されます。


