HubSpotトラブルシューティング

概要

自分の症状を探して読み進めてください。ここで解決しない場合は お問い合わせ ください。エラーの正確な文言と発生時刻を添えてください。

接続の問題

「Authorization code not found」

認可が完了しないままHubSpotから戻ってきています。同意画面を閉じたかキャンセルした場合がほとんどです。

対処: 設定 → HubSpot で Connect to HubSpot をクリックし、別タブを開いたり画面を離れたりせずに完了してください。

「Invalid state parameter」

HubSpotの応答をあなたの組織に紐づけられませんでした。認可にはSteveの組織IDが含まれるため、Steveから開始する必要があります。

対処: app.hiresteve.ai/settings?tab=hubspot を再読み込みし、Steveで正しい組織が選択されていることを確認してから Connect to HubSpot ボタンでやり直してください。HubSpotアプリマーケットプレイスから始めないでください。

「Failed to fetch access token」

認可コードとトークンの交換をHubSpotが拒否しました。コードは一度きりで短命です。

対処: 同意画面を開いたまま放置せず、すぐに再試行してください。繰り返す場合は、ポータルでアプリが承認されていない可能性があります。HubSpotのスーパー管理者にご確認ください。

「Failed to verify HubSpot connection」

トークンは発行されましたが、HubSpotに対して確認できませんでした。

対処: 1回再試行してください。続く場合は、ポータルがアプリのインストールを制限していないか確認し、スーパー管理者に認可を実行してもらってください。

「Internal server error occurred」／「Unknown error occurred」

Steveに個別メッセージのない失敗が発生しました。

対処: HubSpotの通知バーで権限拒否の通知を確認し、1回再試行してから、発生時刻を添えて tech@hiresteve.ai までご連絡ください。

HubSpotページからProjectsへリダイレクトされる

Steveのロールカテゴリが Individual Sales です。CRMページは営業マネジメントとPMMのロールに限定されており、「Integration Not Available」 と表示されます。

対処: 組織マネージャーにロールを変更してもらうか、CRM関連の作業を代行してもらってください。

セットアップと設定の問題

琥珀色の「New Steve fields need to be created」バナー

steve_connected_calls または steve_connected_battle_cards がポータルにありません。接続したHubSpotユーザーが取引プロパティを作成できなかった場合がほとんどです。

対処: バナーの Create missing fields をクリックしてください。それも失敗する場合は、取引情報 グループの複数行テキストプロパティとして、上記の内部名で手動作成してください。

琥珀色の「Re-integrate to enable deal activity notes」バナー

Steveが crm.objects.contacts.write（HubSpotがノート作成に要求するスコープ）を要求するようになる前に認可されています。

対処: 設定カードの Re-integrate をクリックして認可を完了してください。何も削除されず、保存済みスコープが更新されるだけです。

項目の作成が失敗する

接続したHubSpotユーザーにプロパティ管理権限が無いか、同じ内部名のプロパティが別の型で既に存在しています。

対処: HubSpotの 設定 → プロパティ → 取引プロパティ を確認してください。既に存在するなら作成をスキップしてマッピングするだけで構いません。そうでなければ、プロパティを管理できるユーザーで接続し直してください。

HubSpotで作成したばかりのプロパティがドロップダウンに出ない

プロパティ一覧はHubSpotからキャッシュされています。

対処: フィールドマッピング ページで Refresh Properties をクリックしてください。HubSpotが新しいプロパティをAPIに公開するまで少し時間がかかることもあります。30秒ほど待って再度更新してください。

Save Configurationがグレーアウトしている

6つのSteve項目すべてが実在するプロパティにマッピングされ、少なくとも1つのプロパティが選択されている必要があります。

対処: Configuration Status カードを見てください。緑のチェックが付いていない項目が原因です。HubSpot側で削除されたプロパティにマッピングされている項目は「未マッピング」として扱われます。

同期の問題

取引が1件も取り込まれない

一部の取引だけ見つからない

初回以降の同期は 差分 です。前回のインポート以降に更新された取引だけを取得します。

対処: HubSpot側で対象の取引を更新して最終更新日時を進め、Sync HubSpot Data をクリックしてください。

HubSpotには値があるのにSteveでは空

選択済みプロパティに含まれていないため、そもそも取得されていません。

対処: フィールドマッピング ページで追加して保存してください。保存すると新しい選択で同期が走ります。

会社が表示されない

取引テーブルの Sync HubSpot Data は取引のみが対象です。会社は接続時、フィールドマッピングの保存時、毎日の実行時に同期されます。

対処: フィールドマッピングをもう一度保存するか、翌日の定期実行を待ってください。

テーブルに「Failed to load HubSpot deals」と表示される

Steveが自身の取引コピーを読み取れませんでした。多くは一時的なエラーです。

対処: ページを再読み込みしてください。続く場合はメッセージを添えてサポートへご連絡ください。

書き戻しの問題

競合が選択できない（セルが無効）

その取引にプロジェクトが割り当てられていません。競合アノテーションはプロジェクト単位です。

対処: 先に Project 列でプロジェクトを割り当ててください。無効なセルのツールチップにも同じ説明が表示されます。

ある取引で競合一覧が空になる

その取引のプロジェクトに競合が登録されていないか、期待している競合が別のプロジェクトに属しています。

対処: そのプロジェクトに競合を追加するか、取引を正しいプロジェクトへ割り当て直してください。

バトルカードリンクはプロパティに入るがタイムラインに出ない

crm.objects.contacts.write スコープがありません。

対処: 設定画面で Re-integrate をクリックしてください。

Steve Channels／Win Reason／Loss Reasonのセルが読み取り専用

これらはマッピングされている場合のみ編集できます。

対処: フィールドマッピング ページでマッピングしてください。

Steveでは保存されるがHubSpotに反映されない

マッピング先のプロパティが存在しなくなったか、接続ユーザーがそのプロパティへの書き込み権限を失っています。

対処: マッピングを見直し、HubSpot側でそのプロパティが編集可能（読み取り専用や計算項目ではない）かを確認してください。

同期後に取引のプロジェクトが誤っている

マッピングした Steve Project プロパティに、組織内に存在しないプロジェクトIDが入っています。Steveは警告をログに残し、インポートを壊さずに未割り当てのままにします。

対処: HubSpot側で値を修正するか、Steve Projectのマッピングを解除してSteve上でプロジェクトを割り当ててください。

AI機能の問題

取引サジェストが生成されない

抽出したプレイブック項目がHubSpotに届かない

通話が取引にアノテーションされていないか、会社項目についてSteveが通話の参加者から会社を特定できていません。

対処: Sales Callsで通話を取引にアノテーションし、参加者が会社に紐づいたHubSpotコンタクトとして存在するか確認してください。CRM項目の自動抽出 を参照。

HubSpotが抽出したドロップダウンの値を拒否する

プロパティの許可値がSteveに保存される前に、その項目マッピングが作成されています。モデルが値を推測していました。

対処: 抽出項目を削除して追加し直し、プロパティから許可値を取り込ませてください。

それでも解決しない場合

サポート へ、以下を添えてご連絡ください。

• Steveの組織名とHubSpotのポータルID
• エラーメッセージの正確な文言
• 発生時に何をしていたか、およそいつか
• 該当画面のスクリーンショット

次のステップ

• FAQ — よくある質問への短い回答。
• サポート — 連絡方法。
• 概要 — HubSpotセクションの先頭へ。