HubSpot FAQ

概要

よくいただく質問への短い回答です。ここに無い場合は トラブルシューティング または お問い合わせ をご覧ください。

接続について

インストールはSteveとHubSpotマーケットプレイスのどちらから？ Steveからです。設定 → HubSpot で Connect to HubSpot をクリックします。認可にはSteveの組織情報が含まれるため、他の場所から始めると 「Invalid state parameter」 で失敗します。

セットアップにどれくらいかかりますか？ 認可は約1分、プロパティの作成と項目のマッピングにさらに5分ほどです。初回インポートは自動的に始まります。

APIキーの入力は必要ですか？ 不要です。標準的なOAuth認可です — HubSpotにサインインし、スコープを確認して Connect app をクリックするだけです。

HubSpotの管理者である必要はありますか？ 必須ではありませんが、接続するユーザーにはアプリのインストール権限と取引プロパティの管理権限が必要です。プロパティ権限が無い場合、認可自体は成功しますがSteveの自動プロパティ作成が失敗し、手動作成が必要になります。

Steveの管理者である必要はありますか？ はい。連携の接続・設定・削除ができるのは組織マネージャーだけです。

どのHubSpotプランで使えますか？ CRMがあればFreeを含めどのプランでも使えます。Steveが利用するのは取引、会社、コンタクト、プロパティ、ノート、通話エンゲージメントです。

複数のHubSpotポータルを接続できますか？ Steveの組織1つにつきポータル1つです。2つ目を接続すると最初のものが上書きされます。

2つのSteve組織で1つのポータルを共有できますか？ 設計上できません — トークンは組織単位で保存され、新しい接続が優先されます。必要な場合はご相談ください。

同期されるもの

Steveには何が取り込まれますか？ 取引と会社です。取引は名前、ステージ、種別、金額、通貨、クローズ日、パイプライン、説明、日時、およびセットアップで選択したすべてのプロパティ。会社は名前、ドメイン、業種、説明、電話、所在地、Webサイト、従業員数、年間売上、ライフサイクルステージ、担当者です。

同期の頻度は？ 毎日UTC 00:00に自動実行されるほか、接続時、フィールドマッピングの保存時、Sync HubSpot Data をクリックしたときに走ります。

初回は全件同期ですか？ はい。前回の同期記録が無い場合、ポータル全体を走査します。以降は差分同期で、前回のインポート以降に更新された取引だけを取得します。

古い取引が表示されないのはなぜ？ 差分同期は前回実行以降に更新された取引だけを取得するためです。HubSpotで取引を更新してから同期してください。

同じ取引が二重に取り込まれることはありますか？ ありません。取引はHubSpotの取引IDで照合され、その場で更新されます。

コンタクトも取り込まれますか？ 閲覧できるレコードとしては取り込まれません。取引の主担当の解決と、通話を正しい会社に紐づけるためにコンタクトを読み取りますが、コンタクトのタブはありません。

チケット、見積もり、マーケティングデータは取り込まれますか？ いいえ。それらのスコープを要求することはありません。

Steveが書き戻すもの

SteveはHubSpotの何を変更しますか？ 競合アノテーションをマッピング先プロパティへ。バトルカードリンクを steve_connected_battle_cards と取引タイムラインのノートへ。関連通話を steve_connected_calls と通話エンゲージメントへ。勝因・失注理由、Steve Channels、Steve Usageをマッピング先プロパティへ。AI抽出したプレイブックの値を、マッピングした取引・会社プロパティと通話ログへ書き込みます。

SteveがHubSpotのレコードを削除することはありますか？ ありません。削除スコープを持っていません。削除するのは自分が作成したバトルカードのノートだけで、それも作成元の競合が解除されたときのみです。

営業担当が手入力したプロパティが上書きされることはありますか？ Steveは明示的にマッピングしたプロパティにのみ、対応する操作がSteve上で行われたときだけ書き込みます。重複を完全に避けたい場合は、Steve専用のプロパティにマッピングしてください。

バトルカードにプロパティとタイムラインノートの両方があるのはなぜ？ プロパティは取引サイドバーに、ノートは取引プレビューにも出るアクティビティタイムラインにリンクを置きます。営業担当が普段見ている場所のどちらでも見つけられるようにするためです。

データを扱う

取引で競合が選択できないのはなぜ？ その取引にプロジェクトが割り当てられていないためです。競合アノテーションはプロジェクト単位で、ツールチップにも 「Assign a project first to annotate competitors.」 と表示されます。

Win ReasonとLoss Reasonが読み取り専用なのはなぜ？ フィールドマッピング ページでHubSpotプロパティにマッピングされている場合のみ編集できます。

取引はどうやってプロジェクトに割り当てられますか？ 3通りです — 組織にプロジェクトが1つだけなら自動、マッピングした Steve Project プロパティに有効なプロジェクトIDがあればそこから、または取引テーブルで個別／一括に手動で。

Sync HubSpot DataとRefetchの違いは？ Sync HubSpot Data はHubSpotを呼び出して最新の取引を取得します。Refetch はSteve自身のデータベースを読み直すだけです。HubSpotが変わったときは同期、Steveで編集したときは再取得です。

Sync HubSpot Dataは会社も同期しますか？ いいえ、取引のみです。会社は接続時、フィールドマッピングの保存時、毎日の実行時に同期されます。

取引サジェストを承認すると取引に割り当てられますか？ いいえ。承認は判断の記録です。プロジェクトと競合は取引テーブルで適用してください。そこでHubSpotへの書き戻しとバトルカードリンクの生成も行われます。

取引にはどんなファイルをアップロードできますか？ PDF、TXT、MDに加えて、URLと貼り付けテキストです。

プライバシーとデータ

HubSpotのデータはどこに保存されますか？ Steveのデータベースに、取り込んだ組織のスコープで保存され、その組織の内部からのみ参照できます。アップロードしたファイルは暗号化オブジェクトストレージに保存されます。

トークンはどのように扱われますか？ アクセストークンとリフレッシュトークンは組織に紐づけて保存され、付与されたスコープの範囲でHubSpot APIを呼び出すためだけに使われます。HubSpotのアクセストークンは30分で失効し、Steveが自動的に更新します。

連携を削除するとデータはどうなりますか？ トークン、設定、マッピング、同期済みの取引と会社がSteveから削除されます。SteveがHubSpotへ書き込んだ内容はHubSpotに残ります。HubSpot連携を削除する を参照してください。

すべてを完全に消去してもらえますか？ はい。組織マネージャーのアドレスから件名 「HubSpot data deletion request」 で tech@hiresteve.ai までご連絡ください。30日以内に処理します。

削除と再接続

どうやって連携を削除しますか？ 設定 → HubSpot → Delete Account で、delete hubspot と入力して確定します。

Re-integrateとDeleteの違いは？ Re-integrate は認可を再実行してトークンとスコープを更新し、データはすべて保持します。Delete は連携と同期済みデータを削除します。

再接続すればすべて戻りますか？ 取引は全件同期で戻ります。フィールドマッピングとプロパティ選択は空の状態から設定し直す必要があります。取引サジェストは、取引が再挿入されるのに伴って再生成されます。

削除するとHubSpotのカスタムプロパティも消えますか？ いいえ。ポータルに残ります。不要であれば 設定 → プロパティ → 取引プロパティ から削除してください。

次のステップ

• トラブルシューティング — 症状別の解決方法。
• サポート — チームへの連絡方法。
• 概要 — HubSpotセクションの先頭へ。