メインコンテンツまでスキップ

リードソース — 設定ガイド

LeadHub は 19種類のソース からリードを受信できます。ほとんどのソースはwebhook経由で動作します — LeadHub が生成したURLを外部プラットフォームに貼り付けると、リードが自動的に流れ込みます。

Webhookベースのすべてのソースの仕組み​

  1. インテグレーション → リードソース に移動して新しい接続を作成します。
  2. ソースタイプを選択してフィールドマッピングを設定します。
  3. 生成された インバウンドWebhook URL をコピーします。
  4. そのURLを外部プラットフォームに貼り付けます。
  5. テストリードを送信してテストします — ワークスペースに数秒以内に表示されます。

Facebook Lead Ads (Meta)​

Facebook Lead Ads では、ユーザーがアプリを離れることなく Facebook/Instagram 内でフォームを送信できます。

Meta は「その他 (Other)」CRM オプションを廃止しました

Meta はリードフォームの CRMインテグレーション に その他 (Other) オプションを提供しなくなったため、フォームレベルで webhook URL を貼り付けることはできなくなりました。代わりに、以下で説明するように OAuth とアプリレベルの webhook で接続してください。

ステップ 1 — Meta アプリを設定する​

developers.facebook.com で ビジネス タイプのアプリを作成（または既存のアプリを開き）ます:

  1. Facebook Login プロダクトを追加します。

  2. アプリ設定 → ベーシック → アプリドメイン: LeadHub のドメイン（例: crm.example.com）を追加します。

  3. Facebook Login → 設定 → 有効な OAuth リダイレクト URI: 以下を追加します

    https://YOUR-DOMAIN/oauth/meta/callback

    これはインストール環境の APP_URL と（https を含めて）完全に一致している必要があります。

ヒント

ドメインとリダイレクト URI を追加すると、エラー "Can't load URL. The domain of this URL isn't included in the app's domains." も解消されます。

ステップ 2 — LeadHub で接続する​

  1. リードソース接続 に移動して Meta 接続を追加します。
  2. App ID と App Secret を入力します。
  3. Connect via OAuth をクリックし、要求された権限を承認して、ページを選択します。
  4. LeadHub が ページアクセストークン を接続に自動的に保存します。

ステップ 3 — Leadgen Webhook を設定する（Meta アプリレベル）​

これは、廃止されたフォームレベルの「その他 (Other)」オプションの代替となる手順です:

  1. アプリダッシュボード → Webhooks で Page オブジェクトを選択します。
  2. leadgen フィールドをサブスクライブします。
  3. Callback URL と Verify Token: 両方とも LeadHub の Meta 接続画面からコピーします。
  4. ページをサブスクライブします。

これで新しいリードが自動的に流れ込みます — Meta が各リードを webhook に送信し、LeadHub がページアクセストークンを使用して Graph API から完全なリード詳細を取得します。

権限とアプリレビュー​

OAuth 接続は次のスコープを要求します: leads_retrieval、pages_show_list、pages_read_engagement、pages_manage_ads。

これらの権限は、アプリ自身の管理者・開発者・テスター以外のアカウントで機能させるために、事前に Meta アプリレビュー + ビジネス認証 が必要です。

承認前にテストするには、次のいずれかを行います:

  • Meta アプリに自分自身を 管理者 / 開発者 / テスター として追加する、または
  • （Meta の Graph API Explorer で leads_retrieval を付与して生成した）Page Access Token を接続の Page Access Token フィールドに貼り付けます — LeadHub はそのトークンで直接リードを読み取ります。

フィールドマッピングの例​

Facebook フィールドLeadHub フィールド
full_namefirst_name
emailemail
phone_numberphone

ペイロードをより細かく制御したい場合は、代わりに Zapier または n8n をブリッジとして使用することもできます。

Instagram リード​

Instagram Lead Ads は Facebook Lead Ads と同じ手順に従います。

TikTok リードジェネレーション​

  1. リードソース接続を作成します: タイプ → TikTok リードジェネレーション。
  2. TikTok Ads Manager → リードジェネレーション → Webhook で Webhook URL を貼り付けます。

LinkedIn リードジェネフォーム​

  1. リードソース接続を作成します: タイプ → LinkedIn リードジェネフォーム。
  2. LinkedIn Campaign Manager → リードジェネフォーム → インテグレーション で Webhook URL を貼り付けます。

WhatsApp Business​

  1. リードソース接続を作成します: タイプ → WhatsApp Business。
  2. Meta Business → WhatsApp → 設定 → Webhooks でコールバック URL を設定します。

Telegram​

  1. @BotFather 経由でボットを作成してボットトークンを取得します。
  2. LeadHub で接続を作成します: タイプ → Telegram。
  3. ボットトークンを入力します — LeadHub が自動的に webhook を登録します。

Viber​

  1. partners.viber.com で Viber Business アカウントを作成します。
  2. LeadHub で接続を作成します: タイプ → Viber。
  3. ボットトークンを入力します。

Typeform​

  1. リードソース接続を作成します: タイプ → Typeform。
  2. Typeform → フォーム → 接続 → Webhooks で Webhook URL を貼り付けます。

JotForm​

  1. リードソース接続を作成します: タイプ → JotForm。
  2. JotForm → フォーム → 設定 → インテグレーション → Webhooks で Webhook URL を貼り付けます。

Calendly​

  1. リードソース接続を作成します: タイプ → Calendly。
  2. Calendly → インテグレーション → Webhooks で Webhook URL を貼り付けて invitee.created イベントを選択します。
  1. リードソース接続を作成します: タイプ → Google Ads リードフォーム。
  2. Google Ads → リードフォームエクステンション → Webhookインテグレーション で Webhook URL を貼り付けます。

メール (IMAP)​

  1. リードキャプチャ専用のメールアドレスを作成します。
  2. インテグレーション → リードソース で新しい接続を作成します: タイプ → メール (IMAP)。
  3. IMAPホスト、ポート、ユーザー名、パスワード、フォルダーを入力します。
  4. LeadHub は5分ごとにインボックスをポーリングします（cronジョブ経由）。

Generic Webhook（任意のプラットフォーム）​

上記にないプラットフォームには Generic Webhook を使用します。

curl -X POST https://yourdomain.com/inbound/YOURTOKEN \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","first_name":"Test","last_name":"Lead","phone":"+1555000000"}'