キャンペーンごとに1つの URL。どの CRM でも使えます。

連携ではなく webhook にしている理由

CRM ごとに別々のコネクターを作ると、その CRM が何かを変えるたびに壊れるものが1つ増えます。JSON を受け付けるウェブアドレスなら、ウェブリクエストを送れるあらゆるツールで使え、それはほぼすべてのツールです。

送るもの

JSON 形式（ Content-Type: application/json）で、次のうちツールで最も扱いやすい形を使ってください：

• 1件のリードを1つのオブジェクトで
• 複数のリードを配列で
• 複数のリードを次の形で包んで {"leads": [ ... ]}

1回のリクエストで最大 500件のリード。それ以上は複数回に分けて送ってください。

各リードに必須なのは 米国の10桁の電話番号だけです。名前、メール、住所などはすべて任意です。フォームで同意を記録しているなら、それも送ってください： consent_date, opt_in_source または tcpa_language などの項目は、同意の記録としてリードとともに保存されます。

当社のではなく、あなたの項目名で

同じ項目名を使う CRM は2つとなく、「phone」ではなく「Phone Number」と書いてあったという理由でリードを拒否するのは、こうした設定が失敗する最もよくある原因です。だからリードの自動取り込みは、実際に送られてくるものを読み取ります。

• 電話番号 phone、phone_number、mobile、cell、telephone、primary_phone など、よくある名前で送れます。
• 名前 first_name または firstname、last_name または surname など、一般的な表記で送れます。
• 入れ子の項目 は1階層までならフラットな項目として読み取ります。HubSpot の properties はこの形で届きます。
• 認識できないものは保持 ：捨てずにリードとともに保存します。誰も想定していなかった項目こそ、エージェントが通話で必要とするものであることが多いからです。

何が起きたか常にわかる

ただの「error 400」では、項目名が間違っていたのか、番号が使えなかったのか、キャンペーンが一時停止中だったのか、送信側には何もわかりません。そこで、すべての応答に次の内容をはっきり示します：

• リードが 受け付けられた件数
• 次の件数： 重複としてスキップ（その番号がすでにキャンペーンにあるか、同じリクエストに2回出てきたため）
• 次の件数： 拒否（理由付き）
• キャンペーンが 稼働中、または 一時停止中 か（一時停止中なら、再びオンにするまで発信されません）

重複は見た目以上に重要です。CRM の自動化は2回動くことがあり、シートは再同期されるので、このチェックがなければ同じ人に2回電話することになります。すべてのリクエストは記録もされるので、後でキャンペーンから確認できます。

URL を非公開に保つ

• アドレスには、DialerSeat が生成する長い秘密の文字列が含まれます。人が選んだ秘密の文字列はたいてい弱いので、自分で選ぶことはできません。
• URL が漏れたら、キャンペーンのページで新しい URL を作成すれば、古いものは使えなくなります。
• 間違ったアドレスと取り消されたアドレスにはまったく同じ応答を返すので、以前使えた URL を探ることはできません。

場所

リードの自動取り込みは、キャンペーンのページでオンにします。場所は チームで、 Manager+に含まれる機能です。オンにしたら、キャンペーンの URL を CRM や自動化ツールにコピーし、テストのリードを送って応答を確認してください。

スプレッドシートのアップロードはすべてのプランで使えます。詳しくは リードのアップロードと管理.