HubSpotへのCRM項目自動抽出
営業通話から抽出した値を、HubSpotの取引プロパティ・会社プロパティ・通話ログへ書き込むプレイブック項目を設定する
概要
Steveは営業通話を聞き取り、CRMが必要とする値 — 予算、チーム規模、契約満了日、意思決定基準 — を取り出して、そのままHubSpotへ書き込めます。抽出内容はプレイブック上で一度設定すれば、そのプレイブックで実行されるすべての通話に適用されます。
対象者: 📣 プレイブックを設定するPMM／営業マネジメント · 🎯 CRMが自動で埋まる恩恵を受ける営業担当。
場所: プレイブックの作成・編集時の Field Extraction and CRM Mapping ステップ — 「Configure custom fields to extract from conversations and map to your CRM」。
先にHubSpotの接続が必要です。 未接続の場合、項目エディタに 「Please connect your HubSpot account first.」 と表示されます。HubSpotを接続する から始めてください。
4つの書き込み先
抽出項目にはそれぞれ 送信先（destination） があり、値がHubSpotのどこへ入るかを決めます。
| 送信先 | 値の書き込み先 |
|---|---|
| Deal Property | 通話がアノテーションされた取引の、特定のHubSpot取引プロパティ。 |
| Call Log | 他のcall log項目とまとめて、取引タイムライン上の単一の通話エンゲージメントに。 |
| Company Property | 通話の参加者から特定された会社の、HubSpot会社プロパティ。 |
| Company Call Log | 会社タイムライン上の通話エンゲージメント。 |
取引系の送信先には、通話が取引にアノテーションされている必要があります。会社系の送信先には、Steveが通話のコンタクトから会社を解決できる必要があります — 参加者のメールアドレスをHubSpotで検索し、そこから会社をたどります。
項目を追加する
ダイアログは Add Extraction Field — Configure a field to extract from sales calls and map it to your CRM です。
- CRM — HubSpot を選びます。バッジに Connected または Not Connected が表示されます。
- Entity Type — Deals か Companies。Steveが取引プロパティと会社プロパティのどちらを提示するかが決まります。
- Field Destination — Deal Property、Call Log、Company Property、Company Call Log。
- HubSpot Field — ポータル内の全プロパティを検索できる一覧。Select a CRM property to auto-fill field details。
- Name と Data Type が選んだプロパティから自動入力され、Auto-filled from CRM property と表示されます。名前は編集できます。
- Extract Instructions — 必須。通話中のどこからこれを見つけるかを指示します（例: 「買い手がこのプロジェクトの年間予算として述べた金額を、相手の通貨のまま」）。
- Add Field。
Refresh Fields はHubSpotからプロパティ一覧を再取得します。別タブでプロパティを作成した直後に使ってください。トーストで 「HubSpot fields refreshed successfully」 と表示されます。
プロパティを先に選ぶのは意図的な設計です。 名前と型より先にHubSpotプロパティを選ぶことで、HubSpotが拒否する型の項目を作ってしまうことがなくなります。
データ型
| 型 | 用途 |
|---|---|
| Short Answer | 氏名、役職、会社名 |
| Long Answer | 課題、説明、詳細な回答 |
| Person Count | 従業員数、チーム規模 |
| Person Name | 個人名 |
| Person Role | 職務・役割 |
| Money | 売上、予算額、取引額 |
| Date | 契約満了日、意思決定期限 |
| Boolean | はい／いいえの質問、機能の要否 |
| Enum | 固定の選択肢 — 業種、企業タイプ、技術スタック |
列挙型プロパティと許可値
マッピング先のHubSpotプロパティがドロップダウンの場合、Steveはその選択肢を読み取り、Allowed Values として表示します: 「These are the valid values accepted by your CRM. The AI will only extract values from this list.」
これらの選択肢はマッピングとともに保存され、抽出時にモデルへ渡されます。そのためモデルはHubSpotの正確な値を返します — New Business ではなく newbusiness です。プロパティの選択肢と一致しない値で発生する INVALID_OPTION エラーを防ぐ仕組みです。
AIによるマッピング支援
プレイブックのメソドロジーから項目セットが自明な場合、SteveがHubSpotプロパティへのマッピングを代行できます — 処理中はエディタに 「AI is mapping fields to your HubSpot properties…」 と表示されます。結果は必ず確認してください。どのマッピングも手動で変更できます。
抽出が実行されるタイミング
- 通話が録音され、プレイブックに沿って処理されます。
- 設定されたすべての項目について、値と確信度をSteveが抽出します。
- 通話がCRMの取引にアノテーションされます — 参加者の照合による自動、またはSales Callsでの手動。
- 抽出値が送信先ごとにHubSpotへ同期されます。取引プロパティは更新され、call log項目はまとめて取引上の通話エンゲージメントになり、会社項目は特定された会社に書き込まれ、company call log項目は会社上のエンゲージメントになります。
手動アノテーションでも同じ同期が走ります。ダイアログで通話を取引にアノテーションすると、抽出値がすぐに送られます。
アノテーションの切り替え・解除では後片付けが行われます。 旧取引や旧会社へ書き込んだ値は、新しい値を適用する前に型に応じた既定値へリセットされるため、古い取引が別の通話のデータを持ち続けることはありません。
同期の失敗がアノテーション自体を妨げることはありません。紐づけはどちらにせよ保存され、失敗は別途報告されます。
抽出結果を確認する
通話のポストコール分析を開き、CRM Data タブへ進みます。各項目に Extracted Value、Type、confidence スコア、Mapped to CRM かどうかが表示されます。モデルが見つけられなかった項目は Not extracted と表示されます。
何も設定されていない場合、タブには No CRM fields configured for this playbook と表示されます。
複数の通話を横断して、CRM Dataダッシュボードが項目ごとの抽出率とカバレッジを集計します。どの指示がうまく機能し、どれを書き直すべきかが分かります。
トラブルシューティング
| 症状 | 原因 | 対処 |
|---|---|---|
| ドロップダウンにHubSpotプロパティが出ない | HubSpotが未接続、または一覧が古い | HubSpotを接続してから Refresh Fields をクリック。 |
| 値は抽出されるがHubSpotに届かない | 通話が取引にアノテーションされていない | Sales Callsでアノテーションするか、参加者の照合を確認。 |
| 会社項目が空のまま | 通話のコンタクトから会社を特定できなかった | 参加者が会社に紐づいたHubSpotコンタクトとして存在するか確認。 |
| HubSpotが列挙値を拒否する | 選択肢が保存される前に作成されたマッピング | 項目を削除して追加し直し、許可値を取り込ませる。 |
| いつも Not extracted になる | 抽出指示が曖昧すぎる | 通話で実際に語られる内容を具体的に記述し直す。 |
次のステップ
- 関連通話と取引チャット — 通話が取引に紐づく仕組み。
- 会社タブ — 項目が書き込まれる会社レコード。
- フィールドマッピング — 取引テーブルが使う、別のよりシンプルなマッピング。