Fin for SalesはHubSpotアカウントに直接接続し、数分で動作するデータコネクタを構築します。API知識、コード、手動のフィールドマッピングは不要です。

テンプレートを選択し、HubSpotで認証すると、AIジェネレーターがHubSpotのインスタンス（カスタムフィールドを含む）を検査し、完全に構成されたコネクタを作成します。提案されたマッピングを確認し、必要に応じて調整してセットアップに追加します。以降、Finはすべての営業会話にライブの連絡先コンテキストを取り込み、適格な連絡先をHubSpotに同期します。

できること:

📥 連絡先の強化（読み取り）	📤 連絡先の同期（書き込み）
FinはHubSpotからライブの連絡先コンテキストを営業会話に取り込みます。	Finは適格な連絡先をHubSpotに同期します。これはアップサートで、既存の連絡先があれば更新し、なければ新規作成します。

注意：2つのテンプレートがあります：HubSpotから連絡先を強化（読み取り）と会話データをHubSpot連絡先に同期（書き込み）。

重要：連絡先の強化と連絡先の同期を一緒に設定してください

連絡先の同期（書き込み）コネクタはメールアドレスをキーとしたアップサートです。HubSpotはそのメールの連絡先を更新するか、なければ新規作成します。重複は発生しません。
会話開始時、FinはHubSpotの連絡先IDを知りません。連絡先の強化（読み取り）コネクタが既存のHubSpotレコード（連絡先ID）に戻る人を解決します。
強化があるからこそ同期が価値を持ちます。強化なしでは、Finは正しい連絡先に書き込みますが、最初に資格情報がありません。

開始前に

接続されたHubSpotアカウントが必要です（セットアップ中にOAuthで認証します）。

設定方法

「Connected services」セクションのFin AI Agent > Sales > Train > IntegrationsからHubSpotをFin for Salesに接続します。

ステップ1：認証

まだの場合はOAuthでHubSpotに接続してください。

ステップ2：テンプレートを選択

HubSpotから連絡先を強化（読み取り）または会話データをHubSpot連絡先に同期（書き込み）を選択します。連絡先を同期するには両方を設定してください（上記の注意を参照）。

ステップ3：テスト用メールを入力

これはワークスペースのHubSpotアカウントに対して実際の検索を行い、コネクタをライブデータで構築・テストします。メールは既存のHubSpot連絡先のものである必要があります。

ステップ4：AIにコネクタを生成させる

AIがHubSpotスキーマを検査し、テストリクエストを実行し、コネクタを組み立てるのに15〜30秒かかります。

ステップ5：フィールドマッピングを確認

HubSpotプロパティ → Intercom属性の表が表示され、確認前に編集できます。既存のIntercom属性に一致しないHubSpotプロパティは、AIが作成したhs_接頭辞付きの新しい属性に自動マッピングされます。

ステップ6：セットアップに追加

読み取りコネクタ：各会話の開始時に実行される強化に追加します。
書き込みコネクタ：その結果が達成されたときに発火するルーティング結果に添付します。

注意：

同期はアップサートです：同期連絡先はメールをキーにしています。HubSpotはそのメールアドレスの連絡先を更新するか、なければ新規作成します。
自動更新：HubSpotのアクセストークンは定期的に期限切れになります。コネクタは自動で更新されるため、毎回再接続は不要です。
カスタムプロパティも含む：セットアップ中にFinはHubSpotのカスタムプロパティを読み取り、カスタマイズされたデータもマッピング可能です。

トラブルシューティング

もし…	対処法
“メールに該当するHubSpotの連絡先が見つかりません…”というエラーがコネクタ作成時に出る場合	テストメールがHubSpotアカウントの連絡先と一致しません。メールが連絡先として存在するか確認し、再試行してください。
セットアップがHubSpotプロパティの読み取り中に失敗する場合	通常は権限または接続の問題です。設定>統合でHubSpotを再接続し、再度セットアップを実行してください。
同期（書き込み）が「必須フィールドがありません」エラーで失敗する場合	HubSpotアカウントで会話中に収集されなかった必須フィールドが必要です。書き込みコネクタがある結果で必須フィールドがキャプチャされていることを確認してください。
コネクタが約1時間後に動作停止した場合	通常はHubSpot認証の問題です。コネクタは自動更新と再試行を行います。問題が続く場合はHubSpotを再接続してください。
リードが時間枠を確定した直後に一般的な「問題が発生しました」エラーでミーティング予約が失敗し、権限が付与され必要な質問が収集されている場合	HubSpotのミーティングリンクにreCAPTCHAが有効か確認してください。reCAPTCHA保護されたミーティングフォームはFin for Salesでサポートされておらず、予約確認が失敗します。HubSpotのミーティングフォームでreCAPTCHAを無効にしてから再度予約してください。

HubSpotをFin for Salesに接続する