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

Webhookの設定

ここでFacebookにリードデータの送信先を伝えます。これを「webhook」と呼びます — CRMのメールアドレスのようなものです。

Webhookとは？​

シンプルに説明すると：

誰かがFacebook/Instagramでリードフォームに記入
         ↓
Facebook：「新しいリードが届いた！」
         ↓
FacebookがリードデータをあなたのWebhook URLに送信
         ↓
モジュールが受信してPerfex CRMにリードを作成

Webhookは、Facebookがデータを送信するサーバー上のURLです。モジュールがこのURLを自動生成します — Facebookに伝えるだけです。

PerfexからWebhook詳細を取得​

Facebookに行く前に、モジュールから詳細を取得します：

  1. Perfex CRMにログイン
  2. サイドバーでMeta Leads → Settingsに移動
  3. まずApp IDとApp Secret（ステップ1のもの）を入力してSave Settingsをクリック
  4. Webhook Settingsセクションまでスクロール
  5. 次の2つの値が表示されます：
フィールド例説明
Webhook Callback URLhttps://yourcrm.com/facebookleadsintegration/webhookFacebookがデータを送信する先
Verify Tokena1b2c3d4e5f6g7h8i9j0接続を検証する秘密コード
  1. 各値の横のCopyボタンをクリック
警告

Callback URLはhttps://で始まる必要があります — FacebookはSSLを要求します！URLがhttp://で始まる場合は、まずSSL証明書をインストールしてください。

Meta AppにWebhookを追加​

1. Meta Appダッシュボードを開く​

アプリにアクセス：

👉 https://developers.facebook.com/apps/

アプリをクリックして開きます。

2. Webhooksプロダクトを追加​

  1. 左サイドバーで**「Add Product」**を探すか、ダッシュボードを下にスクロール
  2. プロダクト一覧で**「Webhooks」**を探す
  3. **「Set Up」または「Configure」**をクリック
ヒント

左サイドバーにすでに「Webhooks」が表示されている場合は、直接クリック — 再度追加する必要はありません。

3. オブジェクトタイプで「Page」を選択​

  1. Webhooksページで、デフォルトで**「User」**と表示されているドロップダウンを確認
  2. このドロップダウンを**「Page」**に変更
警告

重要！ 「Page」を選択する必要があります — 「User」でも「Application」でもなく、他でもありません。リードデータはPage購読を通じて届きます。

4. Webhookを購読​

  1. 「Subscribe to this object」ボタン（すでに設定済みの場合は「Edit Subscription」）をクリック
  2. 2つの値を入力するダイアログが表示されます：
フィールド入力内容
Callback URLモジュールのWebhook URLを貼り付け（例：https://yourcrm.com/facebookleadsintegration/webhook）
Verify TokenモジュールのVerify Tokenを貼り付け
  1. **「Verify and Save」**をクリック

5. 「Verify and Save」をクリックすると​

Facebookがすぐに検証リクエストをWebhook URLに送信します：

Facebook: 「本当にあなたのサーバーですか？」
モジュール: 「はい！検証のためのverify tokenです！」
Facebook: 「確認しました！」

成功した場合： 成功メッセージが表示され、ダイアログが閉じます。

失敗した場合： Troubleshootingセクションで一般的な修正を確認してください。

6. 「leadgen」イベントを購読​

検証後、Facebookにどのイベントを送信するか伝える必要があります：

  1. 「Page」購読の下にイベントタイプの一覧が表示されます
  2. 一覧で**「leadgen」**を探す（スクロールが必要な場合があります）
  3. 「leadgen」の横の**「Subscribe」**トグル/チェックボックスをクリック
ヒント

「leadgen」は必要な唯一のイベントです。 他のイベント（「messages」や「feed」など）の購読は不要です。「leadgen」のみです。

検証成功！​

Webhook設定は次のようになっているはずです：

Webhooks
├── Object: Page
├── Callback URL: https://yourcrm.com/facebookleadsintegration/webhook ✅
├── Verify Token: ✅ Verified
└── Subscriptions:
    └── ✅ leadgen (subscribed)

Perfex CRMモジュールに戻ると、Webhookステータスインジケーターが緑/Verifiedになっているはずです！

Webhookのテスト方法​

Webhookが動作しているか確認したい場合：

  1. Perfex CRM → Meta Leads → Settingsに移動
  2. **「Test Connection」**ボタンをクリック
  3. すべて緑のチェックマークが表示されるはずです

より詳細なテストは、Testing Leadsセクションで行います。

避けるべきよくある間違い​

間違い修正
「User」を選択して「Page」を選択していないドロップダウンを「Page」に変更
「leadgen」の購読を忘れた一覧で「leadgen」を探して購読
HTTP instead of HTTPSを使用サーバーにSSL証明書をインストール
Callback URLのタイプミスモジュール設定から直接コピー＆ペースト
「Callback URL couldn't be validated」Troubleshootingを確認

Webhook設定完了？ Connect Your Pages