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

HubSpotをFin for Salesに接続する

Fin for Salesを有効にしてHubSpotアカウントに直接接続し、データコネクタを構築します。

対応者:Beth-Ann Sher

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接続時に「認証に失敗しました」:"このアプリはアカウントの必要なスコープ[crm.schemas.contacts.read]へのアクセス承認を得ていません。"

このエラーはHubSpotアカウントがアプリガバナンスを使用しており、Intercomアプリが権限の一部なしで承認されたことを意味します。HubSpotのスーパ管理者が以下で修正する必要があります:設定 > 統合 > 接続済みアプリ > 承認済みアプリでIntercom Auth Onlyの横のアクセス管理をクリックし、データ権限を開き、連絡先のプロパティの詳細を表示設定をオンにしてください。
その後、Intercomで接続を再試行してください。

権限をオンにした後、IntercomのFin AI Agent > Sales > Train > Integrationsに戻り、HubSpot接続を再試行してください。

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