Docs
EN日本語

プラットフォーム · CRM 連携

HubSpot

リードは HubSpot のコンタクトとして、予約されたミーティングは HubSpot のミーティングエンゲージメントとして記録されます。メールアクティビティも記録でき、ライフサイクルステージ、リードステータス、取引、履歴を読み戻します。このページでは、「CRM 同期」の HubSpot カードを上から順に説明し、アプリが表示する HubSpot 設定ガイドも掲載しています。

ステップ 1 · 接続

  1. 連携を開く

    設定 → ワークスペース → 外部連携で HubSpot のタイルを開き、「HubSpot を接続」をクリックします。ダイアログに、Meeton がコンタクト・取引・リードアクティビティを HubSpot と同期することが説明されます。「メール履歴も取り込む」をオンにすると、営業メールを読むための追加権限を HubSpot に求めます。これは HubSpot のスーパー管理者しか承認できないので、オフのままにして後で追加しても構いません。

  2. HubSpot で承認する

    対象ポータルのコンタクト、会社、取引、担当者、フォーム、リストに権限のあるユーザーでサインインします。Meeton はコンタクトの読み書き、会社の書き込み、取引と担当者の読み取り、フォームとリストへのアクセス権限を要求します。

  3. Meeton に戻る

    タイルには「接続済み・設定が必要」と表示されます。まだ何も送られていません。設定 → Meeton ai → データとトラッキング → CRM 同期に進みます。

ステップ 2 · 初期設定(ユニーク ID プロパティ)

Meeton は同じ人を再び見つけられるよう、コンタクトのカスタムプロパティに自身のコンタクト ID を保存します。「カスタムプロパティを設定」を押すと、このプロパティ(使用する場合はアトリビューション用プロパティも)を1クリックで作成し、フィールドごとに「作成しました」「既に存在します」「失敗しました」を表示します。HubSpot ユーザーがプロパティを作成できない場合は、スーパー管理者に権限付与を依頼するか、アプリが表示する手動の手順に従います。

HubSpot 設定ガイド(手動)
  1. HubSpot でメインナビゲーションの設定アイコン(⚙️)をクリックします。
  2. 左サイドバーで「プロパティ」に進みます。
  3. 「プロパティを作成」ボタンをクリックします。
  4. オブジェクトタイプを「コンタクト」にします。
  5. ラベルに「DynaMeet Contact ID」のような名前を入力します。
  6. 「次へ」をクリックします。
  7. フィールドタイプで「1行テキスト」を選びます。
  8. HubSpot が内部名(例:dynameet_contact_id)を表示します。
  9. 重要:「ルール」画面の「一意の値を必須にする」にはチェックを入れないでください。
  10. 「作成」をクリックします。
  11. 作成した内部名をコピーし、Meeton の「ユニークIDフィールド」欄に貼り付けます。

フィールドを設定するまでコンタクト同期とアクティビティ同期はグレーアウトのままです。欄を空のまま送信をオンにすると、Meeton は dynameet_contact_id を使います。

ステップ 3 · コンタクト同期

コンタクトをプッシュ
訪問者がフォームを送信したら、新しいコンタクトを HubSpot に同期します。メールアドレスで照合し、存在しない場合だけ新規作成します。いずれの場合もフォーム送信の内容がノートとして追加されます。
書かれるフィールド
名、姓、会社、電話、役職、そして HubSpot プロパティに紐付けたリードフォームのカスタムフィールド(「リードフォーム」→「HubSpot からインポート」、カスタムフィールドは20個まで)。
マージ戦略
既定は「空欄のみ入力」です。詳しくは概要を参照してください。
言語
Meeton が書き込むアクティビティの件名とノートの言語を、日本語と英語から選びます。
ファーストタッチアトリビューション(初回訪問の流入元)
UTM パラメータと広告クリック ID を、指定したコンタクトプロパティが空の間だけ書き込みます。表には各パラメータと対応する HubSpot プロパティが表示され、存在の確認や作成もできます。

ステップ 4 · アクティビティ同期

設定方向内容既定
ミーティング同期HubSpot へ商談予約が入ると、HubSpot のミーティングエンゲージメント「Meeting booked via Meeton AI」を作成します。担当者はホストのメールアドレスと一致する HubSpot ユーザーです。オン
Meeton Email アクティビティHubSpot へAI メールのイベント(送信、開封、リンク URL 付きのクリック)をコンタクトのメールエンゲージメントとして記録します。ご利用のプランに含まれない場合は「現在のプラン対象外」と表示されます。オフ
メモとミーティングを取り込むHubSpot からコンタクトの HubSpot のノートとミーティングを読み取り専用の履歴として Meeton に取り込み、チャットエージェントと Meeton Email が、チームのこれまでの対応を踏まえて応答できるようにします。オフ
メールを取り込むHubSpot からコンタクトの HubSpot メール履歴を読み取り専用で取り込みます。営業メールを読むため、HubSpot は明示的な許可を求めます。「メール権限を付与」を押すと、機密データに言及する HubSpot の同意画面に進みます。すでに同期しているコンタクトのメールだけが取り込まれ、編集や返信はされず、HubSpot を切断せずにオフにできます。権限が失効すると、再接続するまでこの設定は「一時停止」になります。オフ
取引金額を取り込むHubSpot から同期済みコンタクトに紐付く取引の金額を読み取り、ROI ダッシュボードで「影響したパイプライン」を算出します。通貨を持たない取引のために既定の通貨を選びます。オン

読み戻されるもの

  • ライフサイクルステージとリードステータス。リードステータスが unqualified、またはライフサイクルステージが unqualified か other のコンタクトは Meeton で失格扱いになり、追客メールもリード通知も止まります。
  • 取引。最初に紐付いた取引の金額とステージを、ROI ダッシュボード用に読み取ります。Meeton が取引を作成・編集することはありません。
  • 担当者。ミーティングを正しい HubSpot ユーザーに割り当てるために使います。

サイト上の HubSpot フォーム

タグはマッピング設定なしで HubSpot フォームを認識します。レガシーのインライン埋め込みと v4 のフォーム埋め込みの両方が検出され、送信が成功すると訪問者が識別されます。ページに「このページでフォーム送信」のルールが設定されていれば、HubSpot が送信を確認した瞬間に予約カレンダーが開きます。ページに HubSpot のトラッキングスクリプトがあれば、識別情報はそのキュー(_hsq)にも渡され、最初の同期より前に HubSpot のコンタクトと Meeton の訪問者が紐付きます。

テスト

カード末尾の「テストコンタクトを送信」を押すと、入力したメールアドレス宛てに、現在の設定でテスト用の訪問者イベントを送信します。オンにした同期のみが実行されるため、コンタクト、そのノート、アトリビューション用プロパティが HubSpot に反映されるかを確認する最速の方法です。プロパティ不足でテストが失敗した場合は、そのプロパティ名と対処方法(「カスタムプロパティを設定」)が表示されます。

トラブルシューティング

症状考えられる原因対処
タイルが「接続済み・設定が必要」「コンタクトをプッシュ」がオフ、またはユニーク ID プロパティが未設定「CRM 同期」ページでステップ2と3を完了してください。
「HubSpot ユーザーにカスタムプロパティを作成する権限がないため、一部のフィールドの作成に失敗しました。」HubSpot ユーザーにカスタムプロパティを作成する権限がないHubSpot のスーパー管理者に権限付与を依頼するか、手動でプロパティを作成して内部名を貼り付けてください。
テスト失敗「テスト失敗: カスタムプロパティ「…」が HubSpot に存在しません。」HubSpot でプロパティが改名または削除された作り直すか、Meeton 側の名前を更新してください。
ミーティングが担当者なしで同期されるホストの Meeton のメールアドレスが HubSpot ユーザーのメールアドレスと一致しない両方で同じアドレスを使うか、担当者なしのまま運用してください。
「メールを取り込む」が「一時停止」メール読み取り権限が取り消されたか期限切れ「再接続して権限を付与」を押してください。その間もノートとミーティングは取り込まれます。
HubSpot のコンタクトと Meeton の訪問者が別人訪問者がチャットで HubSpot フォームとは別のメールアドレスを入力した想定どおりの動作です。メールアドレスが一致した時点で統合されます。
HubSpot フォームが送信されなくなったレガシーのフォーム経路はまず Meeton にデータを送る。そのリクエストが遮断されると送信が保留されるページから api.dynameet.ai に到達できるか確認してください。デバッグログに「HubSpot submission prevented」と出力されます。

よくある質問

どの HubSpot プランで使えますか?

カスタムコンタクトプロパティと OAuth アプリのあるプランなら使えます。無料 CRM も含まれます。一部のアクティビティインポートは HubSpot ではなく Meeton のプランに依存します。

メール権限の付与時に、HubSpot で機密データに関する警告が表示されるのはなぜですか?

その権限が営業メールの内容を読むためです。Meeton はすでに同期しているコンタクトのメールだけを取り込み、編集も送信もしません。不要な場合は「メールを取り込む」をオフのままにしてください。

フォームのフィールドを受け取る HubSpot プロパティを選べますか?

標準フィールドは名前で対応付けられます。独自のフィールドは、HubSpot プロパティをリードフォームのカスタムフィールドとしてインポートすると、紐付いたままそのプロパティに書き込まれます。

会社レコードは作られますか?

Meeton はコンタクトの会社フィールドを埋めます。会社レコードの作成や関連付けは行いません。