SalesforceからHubSpotへのデータ移行は標準のインポートだけでは足りなかった。APIを使ってすべてのデータを移行した記録

SalesforceからHubSpotへのデータ移行は標準のインポートだけでは足りなかった。APIを使ってすべてのデータを移行した記録

簡単に見えた移行作業の落とし穴

以前、あるクライアントから「SalesforceからHubSpotへシステムを移行したい」というご相談をいただきました。CRMやSFAの乗り換えは、コスト削減や使い勝手の向上を目指す経営者にとって魅力的な選択肢です。当時の私も「両者のデータ構造は非常に似ているため、それほど難しい作業ではない」と高をくくっていました。

実際に作業を始めてみると、基本データの移行は驚くほどスムーズでした。Salesforceのアカウント(取引先)はHubSpotの「会社」、オポチュニティ(商談)は「取引」、コンタクト(取引先責任者)は「コンタクト」というように、主要なオブジェクトは1対1で綺麗に対応します。データをCSV形式でエクスポートし、HubSpot標準のインポート機能を使えば、主要な情報はあっけないほど簡単に取り込むことができたのです。「これなら予定通り完了する」と、その時は誰もが思っていました。

「標準インポートで十分」という勘違い

しかし、作業を進めるうちに重大な壁にぶつかりました。現場の営業活動を支えてきた「過去の対応履歴(タスク)」や、見積書や提案書といった「添付ファイル」が、標準機能ではどうしてもインポートできないのです。「顧客データや取引履歴が入ったから完了」と考えてしまうのは大きな誤りでした。SFAの真価は、過去にどのようなやり取りがあったかという「文脈」にこそあります。それが欠落してしまえば、営業現場の混乱は避けられません。

市場を見渡すと「標準のCSVインポートで移行可能」と謳う解説や、それを鵜呑みにして移行を諦めてしまう企業が数多く存在します。しかし、「標準機能だけで移行できる」というのは大きな誤解です。名刺情報や案件の数字だけを移しても、真の移行とは呼べません。標準機能の限界に直面したとき、移行を諦めるか、重要な履歴を捨てて妥協するかという二者択一を迫られる企業が絶えないのが実情です。

タスク移行を成功させるDBとAPI活用

そして、取り残されたデータはどのように移行すればよいのでしょうか。私がたどり着いた答えは、HubSpotが提供するAPIを活用することでした。

まず「タスク」の移行です。タスクデータには、担当者の割り当て、優先度、期限に加え、「どの取引や会社に紐付いているか」という複雑なリレーション情報が含まれています。Salesforceから抽出したタスクデータを直接CSVでいじろうとすると、この関連性が壊れてしまいます。

確実な方法は、抽出したデータを一旦リレーショナルデータベース(DB)に格納することです。DB上で各データの関連性を保持したままHubSpot形式のフォーマットへ変換し、HubSpot APIを用いて一括インサートを行います。さらに、API経由で会社や取引レコードとの紐付け処理をプログラムで実行します。この工程を挟むことで、過去の行動履歴を完璧な精度で新しい環境へ再現できるようになります。

添付ファイルを完璧に再現するノウハウ

もう一つの難関である「添付ファイル」も、同様にAPIで解決します。まずSalesforceの標準バックアップ機能を使い、ローカル環境へすべての添付ファイルをダウンロードしておきます。次に、それらのファイルが「どの取引や会社に紐付いているか」を示したCSVデータを手作業およびDB処理で厳密に作成します。

このCSVをもとに、APIを使ってファイルのアップロードとレコードへの紐付けを同時に進めていきます。ここで1点、実務上の非常に重要なノウハウがあります。HubSpotの仕様上、「取引」レコードに対して直接ファイルを添付することはできません。そのため、APIを用いて「メモ(Note)」オブジェクトを生成し、そのメモ内にファイルを添付して取引に関連付けるという手順を踏みます。この工夫により、営業担当者がHubSpotの取引画面を開いた際、タイムライン上に以前と変わらず添付ファイルが表示される状態を作ることができるのです。

妥協のない移行で同等のSFA構築へ

SalesforceからHubSpotへの移行において、「標準インポート機能だけで完了する」という一般論は通用しません。標準機能で移行できるのは骨組みだけに過ぎず、営業活動の血肉であるタスクや添付ファイルを取り込むには、開発を伴うAPI連携が不可欠です。

一見するとハードルが高く思えるかもしれませんが、本論で解説したステップを踏めば確実に解決できます。

  1. タスクデータは一旦DBに蓄積し、リレーションを整理した上でAPIインサートと紐付けを行う。
  2. 添付ファイルはバックアップから抽出し、APIを用いて「メモ」経由で取引や会社へ配置する。

このポイントさえ押さえて取り組めば、移行によって過去の貴重な資産を失うことはありません。HubSpotへ移行した後も、Salesforce時代と遜色のない高度なSFA環境を維持し、より費用対効果の高い営業基盤を構築することができるのです。