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

トラブルシューティング

問題が発生していますか？心配しないでください — ほとんどの問題は簡単に解決できます。以下の問題を見つけて解決策に従ってください。

Webhook検証の失敗​

エラー： 「コールバックURLまたは検証トークンを検証できませんでした。」

考えられる原因と修正：​

#CauseFix
1URLがHTTPSでないサーバーにSSL証明書をインストール
2コールバックURLのタイプミスモジュール設定から直接コピー&ペースト
3検証トークンのタイプミスモジュール設定から直接コピー&ペースト
4サーバーがリクエストをブロックファイアウォール/セキュリティプラグインを確認
5.htaccessリダイレクト問題URLがリダイレクトしないことを確認（wwwと非wwwのリダイレクト問題なし）
6「User」ではなく「Page」を選択Facebookのwebhookでドロップダウンを「Page」に変更

デバッグ方法：​

  1. ブラウザでwebhook URLに直接アクセス： 
    https://yourcrm.com/facebookleadsintegration/webhook?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=test123
  2. 正しく動作している場合、ページにtest123が表示されます
  3. エラーページが表示される場合、問題はサーバー側にあります
ヒント

それでも動作しない場合？ サーバーのエラーログを確認してください：/path/to/your/crm/application/logs/

Facebookログイン時の「Invalid Scopes」エラー​

エラー： 「Invalid Scopes: pages_manage_metadata」

修正：​

これはモジュールが非推奨の権限を要求していることを意味します。最新バージョンのモジュール（v2.0.0以上）を使用していることを確認してください。正しい権限は：

  • pages_show_list
  • pages_read_engagement
  • leads_retrieval
  • pages_manage_ads
  • ads_management

モジュールを最新バージョンに更新して修正してください。

「Error Accessing App」/「App Not Active」​

エラー： Facebookに接続しようとすると*「Error Accessing App」または「The app is not active.」*が表示される

考えられる原因と修正：​

#CauseFix
1モジュール設定のApp IDが間違っているMeta AppとApp IDが一致するか再確認
2アプリが削除または無効化されたdevelopers.facebook.com/appsでアプリを確認
3アプリの管理者/開発者ではないApp Roles → Rolesで自分を追加
4アプリ制限App Settings → Basic → App Restrictionsを確認

テストリードは動作するが実際のリードが届かない​

モジュールの「Send Test Lead」ボタンは動作するが、Facebookからの実際のリードが表示されない。

確認項目：​

#CheckHow
1ページはサブスクライブしていますか？Settings → Connected Pages → 「Monitoring」と表示されている必要あり
2webhookは検証されていますか？Settings → Connection Status → Webhookが緑である必要あり
3「leadgen」はサブスクライブされていますか？Meta App → Webhooks → Page → 「leadgen」にチェックが必要
4広告は正しいページを使用していますか？Ads Manager → Ad Set → サブスクライブしたページを使用しているか確認
5広告は実行中ですか？Ads Manager → キャンペーンステータスが「Active」である必要あり

Facebookのツールでテスト：​

Lead Ads Testing Toolを使用して実際のwebhookテストリードを送信してください。これが動作して実際の広告が動作しない場合、問題は広告キャンペーンの設定にある可能性があります。

モジュールページで500エラー​

症状： モジュールページが空白または「500 Internal Server Error」を表示

修正：​

  1. PHPエラーログを確認：

    /path/to/your/crm/application/logs/log-YYYY-MM-DD.php

  2. 一般的な原因：

    • PHPバージョンが古すぎる（7.4以上が必要）
    • PHP拡張が不足（cURL、JSON）
    • ファイルのパーミッションが不正
    • アップロード中にモジュールファイルが破損

  3. ファイルパーミッションを修正：

    find /path/to/modules/facebookleadsintegration -type f -exec chmod 644 {} \;
    find /path/to/modules/facebookleadsintegration -type d -exec chmod 755 {} \;

  4. ファイルが破損している可能性がある場合はモジュールを再アップロード

コピーボタンが動作しない​

症状： webhook URLや検証トークンの横の「Copy」ボタンをクリックしても何も起こらない。

修正：​

  • CRMがHTTPS経由でアクセスされていることを確認 — クリップボードAPIはセキュアコンテキストが必要
  • テキストを手動で選択してCtrl+Cを試す
  • JavaScriptエラーを確認（F12 → Consoleタブ）

リードが「Pending Retry」で止まっている​

症状： Sync Historyで「Pending」ステータスのリードが処理されていない。

修正：​

  1. 手動で処理： Sync History → **「Process Retry Queue」**をクリック
  2. cronを確認： リトライキューはPerfex CRMのcronジョブで自動処理されます
    • cronジョブが実行されていることを確認：Setup → Settings → Cron Job
    • cron URLは5分ごとに呼び出される必要があります
  3. Sync Historyでエラーメッセージを確認 — リードが最初に失敗した理由

アクセストークンの期限切れ​

症状： 接続テストが「Token expired」で失敗するか、リードの到着が止まる。

修正：​

モジュールは短期トークンを長期トークン（約60日間有効）に交換します。更新するには：

  1. Meta Leads → Settingsに移動
  2. Connected Pagesまでスクロール
  3. 再度**「Connect with Facebook」**をクリック
  4. ログインして権限を付与
  5. トークンは自動的に更新されます
ヒント

トークンを新鮮に保つため、50日ごとに再接続するリマインダーを設定してください！

フィールドが正しくマッピングされない​

症状： リードデータが間違ったフィールドに表示されるか、欠落している。

デバッグ手順：​

  1. Sync History → リードエントリをクリックして生データを確認
  2. Facebookが送信しているフィールド名を確認
  3. Field Mapping → Facebookのフィールド名が一致しているか確認
  4. 覚えておく：標準フィールド（email、full_name、phone_number）は自動マッピングされます

一般的なフィールド名の問題：​

What You ExpectWhat Facebook SendsSolution
namefull_nameすでに自動マッピング済み
phonephone_numberすでに自動マッピング済み
companycompany_nameすでに自動マッピング済み
budgetcustom_question_1カスタムマッピングを作成

インストール後にモジュールが表示されない​

修正：​

  1. ファイルの場所を確認： モジュールフォルダはmodules/facebookleadsintegration/にある必要あり
  2. ファイル名を確認： メインファイルはfacebookleadsintegration.php（すべて小文字）である必要あり
  3. モジュールを有効化： Setup → Modules → Activateをクリック
  4. パーミッションを確認： ファイルがWebサーバーから読み取り可能であること（ファイル644、ディレクトリ755）

サーバー固有の問題​

Cloudflareユーザー​

Cloudflareを使用している場合、Facebookのwebhook IPをホワイトリストに追加：

  1. Cloudflare → WAF（Web Application Firewall）
  2. FacebookからのリクエストをAllowするルールを作成
  3. またはファイアウォールのホワイトリストに追加：
    • Facebookのwebhook IPは以下で確認：https://developers.facebook.com/docs/sharing/webmasters/getting-started/webhooks/

Nginxユーザー​

Nginx設定でwebhook URLへのPOSTリクエストが許可され、FacebookのUser-Agentがブロックされていないことを確認してください。

共有ホスティング​

ほとんどの共有ホスティングで問題なく動作します。問題がある場合：

  • PHPでallow_url_fopenが有効か確認
  • cURL拡張がインストールされているか確認
  • ホストが受信webhookをブロックしていないか確認（セキュリティ重視のホストではブロックする場合あり）

まだ助けが必要ですか？​

上記のいずれでも解決しない場合：

  1. Perfex CRMのエラーログを確認
  2. モジュールのSync Historyでエラーメッセージを確認
  3. エラーメッセージのスクリーンショットを撮る
  4. 以下を含めて[email protected]に連絡：
    • Perfex CRMバージョン
    • PHPバージョン
    • エラーメッセージ
    • 問題を再現する手順

さらに回答はFAQで確認 FAQ