HubSpotアカウントの要件
HubSpot連携を接続し同期を開始する前に、HubSpot側とSteve側で満たしておくべき条件
概要
HubSpotのセットアップが失敗する原因のほとんどは、設定ではなく権限です。HubSpotに接続 を押す前に、このチェックリストを確認してください。2分で終わり、問い合わせを1件減らせます。
対象者: 📣 PMM／管理者。
Steve側の要件
| 要件 | 内容 |
|---|---|
| Steveアカウント | app.hiresteve.ai でサインアップしてサインインします。 |
| 組織（Organization） | CRM連携はユーザー単位ではなく組織単位で設定されます。認可には組織IDが含まれます。 |
| 組織マネージャー権限 | 連携の接続・設定・削除ができるのは組織マネージャーだけです。 |
| Individual Sales以外のロール | HubSpotのページは制限されています。ロールカテゴリが Individual Sales の場合、Projectsへリダイレクトされ 「Integration Not Available — HubSpot integration is only available for sales management and PMM teams.」 と表示されます。 |
| プロジェクトが1つ以上あること | 取引サジェストと競合アノテーションはプロジェクト単位です。プロジェクトが無い場合、取引は取り込まれますがサジェスト生成はスキップされます。 |
プロジェクトが1つだけの場合のショートカット。 組織にプロジェクトが 1つだけ の場合、取り込まれた取引はすべて自動的にそのプロジェクトへ割り当てられます。2つ以上ある場合は未割り当てで取り込まれるため、自分で割り当てるか、取引サジェスト に提案させます。
HubSpot側の要件
| 要件 | 内容 |
|---|---|
| CRMを持つHubSpotアカウント | 取引（Deals）が使えるプランであれば構いません。基本的な取引同期はFree CRMでも動作します。 |
| アプリをインストールする権限 | HubSpotユーザーにアプリのインストール権限が必要です。スーパー管理者がマーケットプレイスを制限している場合は、認可を代行してもらうか、Steveアプリを事前承認してもらってください。 |
| 対象の取引へのアクセス権 | 認可はサインインしたHubSpotアカウントにスコープされます。アクセス権のないポータルの取引は取り込まれません。 |
| 取引プロパティの編集権限 | Steveは代わりにカスタム取引プロパティを作成します。権限がないユーザーでも認可は通りますが、自動作成が失敗するため 手動での作成 が必要になります。 |
| 正しいポータルの選択 | 複数のHubSpotアカウントに所属している場合、認可時にどれを使うか選択します。Steveに取り込みたい取引があるポータルを選んでください。 |
承認を求められるスコープ
同意画面には以下が表示されます。各スコープの用途は HubSpotを接続する を参照してください。
oauth
crm.objects.deals.read crm.objects.deals.write
crm.schemas.deals.read crm.schemas.deals.write
crm.objects.companies.read crm.objects.companies.write
crm.schemas.companies.read crm.schemas.companies.write
crm.objects.contacts.read crm.objects.contacts.write
ノートを書き込むのは
crm.objects.contacts.writeです。 Steveが取引タイムラインに作成するノートと通話エンゲージメントのために、HubSpotが要求するスコープです。このスコープより前に接続した場合、設定画面に 「Re-integrate to enable deal activity notes」 バナーが表示されます。クリック1回で解決し、データは失われません。
Steveが必要とするカスタム取引プロパティ
認可時に2つが自動作成されます。
| 内部名 | ラベル | 種類 | グループ |
|---|---|---|---|
steve_connected_calls | Steve Connected Calls | 複数行テキスト | 取引情報 |
steve_connected_battle_cards | Steve Connected Battle Cards | 複数行テキスト | 取引情報 |
残り6つは自分で用意します（Steveから自動作成、またはHubSpotで手動作成）。既定値は以下のとおりです。
| 内部名 | ラベル | 用途 |
|---|---|---|
steve_channels | Steve Channels | Steveが使われているチャネル |
steve_usage | Steve Usage | この取引でSteveがどう使われているか |
loss_reason | Loss Reason | 失注の理由 |
win_reason | Win Reason | 受注の理由 |
project_competitor | Project Competitor | この取引にアノテーションされた競合 |
steve_project | Steve Project | この取引が属するSteveのプロジェクト |
新規作成せず、既存のHubSpotプロパティを指定することもできます — フィールドマッピング を参照してください。上記はあくまでSteveが提示する既定値です。
1つのHubSpotアカウントにつき1つのSteve組織
HubSpotポータルは単一のSteve組織に紐づけて保存されます。同じポータルを2つ目の組織から接続すると、最初の組織のトークンが上書きされます。2つのチームで同じポータルを使う必要がある場合は、事前に tech@hiresteve.ai までご相談ください。
事前チェック
- 組織マネージャー としてSteveにサインインしている
- Steveの組織に競合を含む プロジェクトが1つ以上 ある
- 接続したいHubSpotポータルでアプリをインストールできる
- そのポータルで 取引プロパティ を作成・編集できる
- Steveに取り込みたい取引があるポータルがどれか分かっている
次のステップ
- HubSpotを接続する — OAuthの流れと保存されるデータ。
- カスタム項目の作成手順 — 6つのSteveプロパティを作成する。
- トラブルシューティング — 要件を満たしているのに失敗する場合。