Dedup

HubSpot を運用していると必ず直面するのが重複リード（コンタクト）の問題です。同じ人がフォーム経由とインポート経由で別レコードになっている、表記揺れで名寄せされていない——こうした重複を放置するとメール配信もスコアリングも狂います。 結論から言うと、API を使って 2 つのコンタクトをマージすることは可能です。HubSpot の API にはコンタクトのマージ用エンドポイントが用意されており、マージ機能自体は Starter プランでも利用できます（API 実行には Private App の作成権限 = Super Admin が必要）。 ただし、「AI エージェントだけで全自動で重複を検知・マージまで完結させる」のは、安全性の観点から少しハードルが高いです。マージは一発勝負でやり直しが効かないからです。 現実的かつ賢いやり方は、「AI に重複を見つけさせてリスト化させ、マージ自体は API で行う（または人間が承認する）」というシステムを組むことです。本記事では具体的な仕組みと API の実装方法を解説します。 AI × API で実現する「自動重複マージ」の設計図 全自動で裏でマージしてしまうと、同姓同名の別人（例:「佐藤一郎」さんという別の会社の人）をマージしてしまうリスクがあります。そのため、以下のような 3 ステップの仕組みを作るのが一般的です。 Step 1: AI が検知 — AI（またはスクリプト）が「名前が一致、かつ会社名や電話番号が類似」しているリードを抽出 Step 2: 人間が確認 — Slack や社内ツール、Google スプレッドシート等に「この 2 人、マージして大丈夫ですか?」と AI が通知 Step 3: API で実行 — 人間が「承認（OK）」ボタンを押したら、システムが HubSpot API を叩いて安全にマージを実行 Step 1「AI が検知」を分解する 「AI が検知」は実際には 4 つの工程に分かれます。すべてを LLM にやらせるのではなく、機械的に絞り込めるところはスクリプトで処理し、あいまいな判断だけを LLM に渡すのがコストと精度のバランスを取るコツです。 ...