Fehlerbehebung

Probleme? Keine Sorge – die meisten haben einfache Lösungen! Finden Sie Ihr Problem unten und befolgen Sie die Lösung.

Webhook-Verifizierung schlägt fehl

Fehler: "The callback URL or verify token couldn't be validated."

Mögliche Ursachen & Lösungen:

#	Ursache	Lösung
1	URL ist nicht HTTPS	Installieren Sie ein SSL-Zertifikat auf Ihrem Server
2	Tippfehler in Callback URL	Direkt aus den Moduleinstellungen kopieren
3	Tippfehler im Verify Token	Direkt aus den Moduleinstellungen kopieren
4	Server blockiert Anfragen	Firewall / Sicherheits-Plugins prüfen
5	.htaccess Umleitungsprobleme	Sicherstellen, dass die URL nicht umleitet (keine www ↔ non-www Umleitung)
6	"User" statt "Page" ausgewählt	Dropdown in Facebook Webhooks auf "Page" ändern

Debugging:

1. Öffnen Sie Ihren Browser und rufen Sie Ihre Webhook-URL direkt auf:

   https://yourcrm.com/facebookleadsintegration/webhook?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=test123

2. Bei korrekter Funktion sollte test123 auf der Seite angezeigt werden
3. Bei einer Fehlerseite liegt das Problem serverseitig

tipp

Funktioniert immer noch nicht? Prüfen Sie die Fehlerprotokolle unter /path/to/your/crm/application/logs/

"Invalid Scopes" Fehler bei Facebook-Login

Fehler: "Invalid Scopes: pages_manage_metadata"

Lösung:

Das Modul fordert eine veraltete Berechtigung an. Stellen Sie sicher, dass Sie die neueste Version des Moduls (v2.0.0+) verwenden, die die korrekten Berechtigungen nutzt:

• pages_show_list
• pages_read_engagement
• leads_retrieval
• pages_manage_ads
• ads_management

Aktualisieren Sie Ihr Modul auf die neueste Version.

"Error Accessing App" / "App Not Active"

Fehler: Bei der Verbindung mit Facebook erscheint "Error Accessing App" oder "The app is not active."

Mögliche Ursachen & Lösungen:

#	Ursache	Lösung
1	Falsche App ID in den Moduleinstellungen	App ID mit Ihrer Meta App abgleichen
2	App wurde gelöscht oder deaktiviert	Überprüfen Sie Ihre App unter developers.facebook.com/apps
3	Sie sind kein Admin/Entwickler der App	Sich unter App Roles → Roles hinzufügen
4	App-Einschränkungen	App Settings → Basic → App Restrictions prüfen

Test-Lead funktioniert, aber echte Leads kommen nicht an

Der "Send Test Lead"-Button funktioniert, aber echte Leads von Facebook erscheinen nicht.

Überprüfen:

#	Prüfung	Wie
1	Ist Ihre Page abonniert?	Settings → Connected Pages → Muss "Monitoring" anzeigen
2	Ist der Webhook verifiziert?	Settings → Connection Status → Webhook muss grün sein
3	Ist "leadgen" abonniert?	Meta App → Webhooks → Page → "leadgen" muss aktiviert sein
4	Nutzt die Anzeige die richtige Page?	Ads Manager → Ad Set → Muss die abonnierte Page verwenden
5	Läuft die Anzeige?	Ads Manager → Kampagnenstatus sollte "Active" sein

Mit Facebooks Tool testen:

Verwenden Sie das Lead Ads Testing Tool, um einen echten Webhook-Test-Lead zu senden. Wenn das funktioniert, aber echte Anzeigen nicht, liegt das Problem wahrscheinlich an Ihrer Anzeigen-Kampagnen-Einrichtung.

500 Fehler auf Modul-Seiten

Symptom: Modul-Seiten zeigen eine leere Seite oder "500 Internal Server Error"

Lösungen:

1. PHP-Fehlerprotokolle prüfen:

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

2. Häufige Ursachen:

   • PHP-Version zu alt (7.4+ erforderlich)
   • Fehlende PHP-Erweiterungen (cURL, JSON)
   • Falsche Dateiberechtigungen
   • Modul-Dateien bei Upload beschädigt

3. Dateiberechtigungen korrigieren:

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

4. Modul erneut hochladen, falls Dateien beschädigt sein könnten

Copy-Button funktioniert nicht

Symptom: Klick auf "Copy" neben Webhook-URL oder Verify Token hat keine Wirkung.

Lösung:

• Sicherstellen, dass das CRM per HTTPS aufgerufen wird – die Clipboard API benötigt einen sicheren Kontext
• Manuell den Text auswählen und Strg+C drücken
• Browser-Konsole auf JavaScript-Fehler prüfen (F12 → Console-Tab)

Leads bleiben in "Pending Retry"

Symptom: Sync History zeigt Leads mit "Pending"-Status, die nicht verarbeitet werden.

Lösungen:

1. Manuell verarbeiten: Sync History → Klicken Sie auf "Process Retry Queue"
2. Cron prüfen: Die Retry Queue wird automatisch über den Perfex CRM Cron-Job verarbeitet
   • Sicherstellen, dass der Cron läuft: Setup → Settings → Cron Job
   • Die Cron-URL sollte alle 5 Minuten aufgerufen werden
3. Fehlermeldung in Sync History prüfen, warum der Lead ursprünglich fehlgeschlagen ist

Access Token abgelaufen

Symptom: Verbindungstest schlägt mit "Token expired" fehl oder Leads kommen nicht mehr an.

Lösung:

Das Modul tauscht kurzlebige Tokens gegen langlebige Tokens (ca. 60 Tage gültig) aus. Zur Aktualisierung:

1. Gehen Sie zu Meta Leads → Settings
2. Scrollen Sie zu Connected Pages
3. Klicken Sie erneut auf "Connect with Facebook"
4. Melden Sie sich an und erteilen Sie Berechtigungen
5. Der Token wird automatisch aktualisiert

tipp

Erinnerung setzen, alle 50 Tage neu zu verbinden, um den Token aktuell zu halten!

Felder werden nicht korrekt zugeordnet

Symptom: Lead-Daten erscheinen in falschen Feldern oder fehlen.

Debug-Schritte:

1. Gehen Sie zu Sync History → Klicken Sie auf einen Lead-Eintrag für die Rohdaten
2. Prüfen Sie, welche Feldnamen Facebook sendet
3. Gehen Sie zu Field Mapping → Sicherstellen, dass der Facebook-Feldname übereinstimmt
4. Hinweis: Standardfelder (email, full_name, phone_number) werden automatisch zugeordnet

Häufige Feldnamen-Probleme:

Erwartet	Facebook sendet	Lösung
name	full_name	Bereits automatisch zugeordnet
phone	phone_number	Bereits automatisch zugeordnet
company	company_name	Bereits automatisch zugeordnet
budget	custom_question_1	Benutzerdefinierte Zuordnung erstellen

Modul erscheint nicht nach Installation

Lösungen:

1. Dateispeicherort prüfen: Modul-Ordner muss unter modules/facebookleadsintegration/ liegen
2. Dateiname prüfen: Hauptdatei muss facebookleadsintegration.php heißen (alles Kleinbuchstaben)
3. Modul aktivieren: Setup → Modules → Auf Activate klicken
4. Berechtigungen prüfen: Dateien müssen vom Webserver lesbar sein (644 für Dateien, 755 für Verzeichnisse)

Server-spezifische Probleme

Cloudflare-Nutzer

Bei Cloudflare Facebooks Webhook-IPs freischalten:

1. Cloudflare → WAF (Web Application Firewall)
2. Regel erstellen zum Erlauben von Anfragen von Facebook
3. Oder Firewall-Whitelist: https://developers.facebook.com/docs/sharing/webmasters/getting-started/webhooks/

Nginx-Nutzer

Sicherstellen, dass die Nginx-Konfiguration POST-Anfragen an die Webhook-URL erlaubt und Facebooks User-Agent nicht blockiert.

Shared Hosting

Die meisten Shared-Hosting-Anbieter funktionieren einwandfrei. Bei Problemen:

• Prüfen Sie ob allow_url_fopen in PHP aktiviert ist
• Prüfen Sie ob die cURL-Erweiterung installiert ist
• Prüfen Sie ob Ihr Host eingehende Webhooks blockiert (manche Sicherheits-Hosts tun das)

Noch Hilfe nötig?

Wenn keine der obigen Lösungen hilft:

1. Perfex CRM Fehlerprotokolle prüfen
2. Sync History des Moduls auf Fehlermeldungen prüfen
3. Screenshot aller Fehlermeldungen erstellen
4. Kontakt unter [email protected] mit:
   • Ihrer Perfex CRM Version
   • PHP-Version
   • Der Fehlermeldung
   • Schritten zur Reproduktion

Weitere Antworten in der FAQ FAQ