取引と会社が同期される仕組み

概要

Steveは、HubSpotの取引と会社のコピーをバックグラウンドで最新に保ちます。このページでは、それがいつ起こり、各実行が何をし、どうすれば手動で走らせられるかを説明します。

対象者: 📣 PMM／管理者、および 🎯 取引がまだ表示されない営業担当。

同期が実行されるタイミング

毎日の実行は、HubSpot接続が有効なすべての組織を対象とします。スケジュール設定は不要です。

各実行の処理内容

1. アクセストークンを更新する。 HubSpotのアクセストークンは30分で失効するため、毎回リフレッシュトークンで新しいものを取得します。
2. 対象期間を決める。 その組織について取り込み済みの最新 hs_lastmodifieddate を確認します。
   • 前回の同期がない → 全件同期。ポータル内の全取引を走査します。
   • 前回の同期がある → 差分同期。そのタイムスタンプ以降に更新された取引だけを取得します。
3. プロパティ一覧を組み立てる。 基本の取引プロパティ、マッピングした6つ、フィールドマッピング で選択したものを、重複を除いて結合します。
4. HubSpotをページングする。 100件ずつ取得し、Steveの形式に変換します。
5. アップサートする。 新しい取引は挿入し、既存の取引はその場で更新します。取引はHubSpotの取引IDで照合されるため、同期を再実行しても重複は生まれません。
6. 新規取引だけ分析キューへ。 新しく挿入された 取引だけがAI分析へ送られ、取引サジェスト が生成されます。再同期された取引は再分析されません。
7. 勝敗トリガーを確認する。 取引同期のあと、受注・失注に移った取引を探し、設定済みの勝敗サーベイをスケジュールします。

会社も同じ流れで、各会社の最終同期日時を差分の基準に使います。

取引で取り込まれる内容

HubSpotの生データも解析済みの項目と並べて保存されます。これが Expand deal details ダイアログと追加列の元になります。

会社で取り込まれる内容

名前、ドメイン、業種、説明、電話、市区町村、都道府県、国、郵便番号、Webサイト、従業員数、年間売上、ライフサイクルステージ、HubSpotの担当者ID — に加えて作成・更新日時と生データです。

プロジェクトの自動割り当て

• 組織にプロジェクトが1つ → 取り込まれた取引はすべて自動的にそこへ割り当てられます。
• 2つ以上 → マッピングした Steve Project プロパティに有効なプロジェクトIDが入っていればそこへ割り当てます。組織内のプロジェクトと一致しない場合は警告をログに残し、インポートを失敗させずに未割り当てのままにします。
• どちらにも当てはまらない → 未割り当てで取り込まれます。取引テーブル または 取引サジェスト から割り当ててください。

任意のタイミングで同期する

取引 テーブルのヘッダーには2つのアイコンボタンがあります。

HubSpot側で何かが変わったときは Sync HubSpot Data、Steve側で編集した内容を反映したいときは Refetch を使ってください。

同期は非同期です。トーストは「開始した」ことを示すもので、「完了した」ことではありません。大きなポータルでは数分待ってから Refetch してください。

取引が見つからない理由

次のステップ

• 取引テーブル — 取り込んだデータを扱う。
• 会社タブ — 会社側の情報。
• 取引サジェスト — 新しく取り込まれた取引に起こること。
• トラブルシューティング — 同期がうまく動かないとき。