HubSpot：概要
HubSpot連携がSteveに同期するもの、対象者、セットアップの流れ
Steve Documentation Team
hubspotcrmintegrationdealscompaniesoverviewdocumentationpmmsales-rep
概要
HubSpot連携 は、HubSpot CRMとSteveを接続します。認可が完了すると、Steveは取引（Deals）と会社（Companies）を取り込んで同期し続け、すべての取引を競合インテリジェンスの置き場に変えます — その取引に紐づく競合、競合のバトルカード、関連する通話、チームがアップロードした資料が一箇所に集まります。
これは 双方向 の連携です。SteveはHubSpotから取引と会社を読み取り、HubSpotの取引プロパティ、取引アクティビティタイムライン、通話エンゲージメントへ書き戻します。
対象者: 📣 PMM／管理者が接続と設定を担当 · 🎯 営業担当が取り込まれた取引を活用。
本ページで説明する操作はすべて、Steveアプリ app.hiresteve.ai 上で行います。
ドキュメントの構成
| 目的 | 参照先 |
|---|---|
| アプリを追加する — 前提条件、OAuthの流れ、Steveが要求するスコープ、動作確認 | HubSpotアカウントの要件 → HubSpotを接続する |
| セットアップを完了する — SteveのカスタムプロパティをHubSpotに作成し、マッピングする | カスタム項目の作成手順 → フィールドマッピングとプロパティ選択 |
| 同期を理解する — 何が取り込まれるか、頻度、全件と差分の違い | 取引と会社が同期される仕組み |
| データを扱う — 検索、絞り込み、編集、プロジェクトと競合の割り当て、一括操作 | 取引テーブル · 会社タブ |
| AI機能を使う — プロジェクトと競合のサジェスト、バトルカードリンク、取引チャット、リソースインサイト | 取引サジェスト · バトルカードリンク · 関連通話と取引チャット · 取引リソースとインサイト |
| プレイブックのデータをHubSpotへ送る — AIが抽出した項目を取引プロパティ・通話ログ・会社へ書き込む | CRM項目の自動抽出 |
| 問題を解決する | トラブルシューティング · FAQ |
| 連携を削除する | HubSpot連携を削除する |
| 問い合わせる | サポート |
同期される内容
| HubSpotから | Steveへ |
|---|---|
| 取引 — 名前、ステージ、種別、金額、通貨、クローズ日、パイプライン、説明、作成日時・更新日時 | 取引 テーブルの取引レコード |
| セットアップで選択したすべての取引プロパティ | 取引テーブルの追加列と取引詳細ダイアログ |
| 会社 — 名前、ドメイン、業種、説明、電話、市区町村、都道府県、国、郵便番号、Webサイト、従業員数、年間売上、ライフサイクルステージ、担当者 | 会社 タブの会社レコード |
| — | 新しく取り込まれた取引ごとのAI 取引サジェスト（推奨プロジェクトと推奨競合） |
| Steveから | HubSpotへ |
|---|---|
| 取引に付けた競合アノテーション | マッピングした競合プロパティ |
| その競合の公開バトルカードリンク | steve_connected_battle_cards プロパティ および 取引アクティビティタイムラインのノート |
| Sales OSで取引に紐づけた通話 | steve_connected_calls プロパティと、取引タイムライン上の通話エンゲージメント |
| Steve Channels、Steve Usage、勝因、失注理由の編集 | マッピングした取引プロパティ |
| AIが抽出したプレイブック項目 | マッピングした取引プロパティ、取引の通話ログ、会社プロパティ、会社の通話ログ |
全体の流れ
HubSpot CRM
↓ OAuth認可（Steveの設定画面から開始）
Steveが取引と会社を取り込む（毎日 + 任意のタイミング）
↓
取引テーブル → プロジェクトを割り当てる → 競合をアノテーションする
↓ ↓
AI取引サジェスト バトルカードリンクをHubSpotの
（プロジェクト + 競合） 取引とタイムラインへ書き戻す
↓
取引リソース、関連通話、取引チャット、プレイブックの項目抽出
SteveのどこにHubSpotデータが表示されるか
| ページ | 内容 |
|---|---|
CRM（/crm） | Salesforceの隣のHubSpotタブ。取引と会社、設定の表示切り替え。 |
HubSpot（/hubspot） | 単独のHubSpotダッシュボード。接続状況、アクションボタン、取引／会社タブ。 |
カスタム項目の作成手順（/hubspot/instruction） | SteveのカスタムプロパティをHubSpotに作成する（手動または自動）。 |
フィールドマッピング（/hubspot/setup） | Steveの項目とHubSpot取引プロパティの対応付け、同期するプロパティの選択。 |
取引分析（/hubspot/deal-suggestion） | AIが提案したプロジェクトと競合の確認、編集、承認、却下。 |
設定 → HubSpot（/settings?tab=hubspot） | 接続、再連携、連携の削除。 |
キャプション: HubSpotダッシュボード — 上部に接続状況、下部に取引タブと会社タブ。
4ステップでセットアップ
- HubSpotの要件を確認する — プラン、権限、ロール。
- HubSpotを接続する — Steveの設定画面から始める1回のOAuth認可。
- Steveのプロパティを作成する — 6つのカスタム取引プロパティを、ワンクリックまたは手動で作成。
- 項目をマッピングする — どのHubSpotプロパティがどのSteve項目かを指定し、同期するプロパティを選ぶ。
接続するだけでも取引は取り込まれます。双方向の機能 — 競合アノテーション、バトルカードリンク、勝因・失注理由 — を実際に動かすのがステップ3と4です。
SteveがHubSpotでアクセスする範囲
Steveが要求するOAuthスコープは以下がすべてです。
| スコープ | 用途 |
|---|---|
oauth | HubSpotがすべてのOAuthアプリに要求する必須スコープ。 |
crm.objects.deals.read | 取引とそのプロパティを読み取る。 |
crm.objects.deals.write | 競合アノテーション、バトルカードリンク、関連通話、抽出値を取引へ書き戻す。 |
crm.schemas.deals.read | マッピング用に取引プロパティの一覧を取得する。 |
crm.schemas.deals.write | Steveのカスタム取引プロパティを作成する。 |
crm.objects.companies.read | 会社を取り込む。 |
crm.objects.companies.write | 抽出値を会社レコードへ書き戻す。 |
crm.schemas.companies.read | プレイブックの項目マッピング用に会社プロパティを取得する。 |
crm.schemas.companies.write | プレイブックが必要とする場合にカスタム会社プロパティを作成する。 |
crm.objects.contacts.read | 取引の主担当コンタクトを解決する（勝敗サーベイと会社マッチングで利用）。 |
crm.objects.contacts.write | 取引・会社のアクティビティタイムラインに書き込む ノート と 通話エンゲージメント を作成・更新する。 |
SteveがHubSpotのレコードを削除することはありません。チケット、見積もり、マーケティングオブジェクトには一切触れず、HubSpotのメールやマーケティングコンテンツも読み取りません。
次のステップ
- HubSpotアカウントの要件 — まずはここから。
- HubSpotを接続する — OAuthの流れを手順ごとに。
- カスタム項目の作成手順 — Steveのプロパティを作成する。
- フィールドマッピングとプロパティ選択 — 設定を完了する。