Zum Hauptinhalt springen

Configure Webhooks

Jetzt teilen wir Facebook mit, wohin die Lead-Daten gesendet werden sollen. Das nennt man „Webhook“ – wie die Postadresse Ihres CRMs für Facebook.

Was ist ein Webhook?​

Einfach erklärt:

Jemand füllt Ihr Lead-Formular auf Facebook/Instagram aus
         ↓
Facebook sagt: „Hey, ich habe einen neuen Lead!“
         ↓
Facebook sendet die Lead-Daten an IHRE Webhook-URL
         ↓
Ihr Modul empfängt sie und erstellt den Lead in Perfex CRM

Ein Webhook ist einfach eine URL auf Ihrem Server, an die Facebook Daten sendet. Das Modul erstellt diese URL automatisch – Sie müssen Facebook nur davon erzählen.

Webhook-Details aus Perfex abrufen​

Bevor Sie zu Facebook gehen, holen wir die Details aus Ihrem Modul:

  1. Melden Sie sich in Perfex CRM an
  2. Gehen Sie zu Meta Leads → Settings in der Sidebar
  3. Geben Sie zuerst Ihre App ID und App Secret (aus Schritt 1) ein und klicken Sie auf Save Settings
  4. Scrollen Sie zum Abschnitt Webhook Settings
  5. Sie sehen zwei Werte:
FeldBeispielWas es ist
Webhook Callback URLhttps://yourcrm.com/facebookleadsintegration/webhookWohin Facebook Daten sendet
Verify Tokena1b2c3d4e5f6g7h8i9j0Ein Geheimcode zur Verifizierung der Verbindung
  1. Klicken Sie auf den Copy-Button neben jedem Wert
warnung

Die Callback-URL MUSS mit https:// beginnen – Facebook verlangt SSL! Wenn Ihre URL mit http:// beginnt, müssen Sie zuerst ein SSL-Zertifikat installieren.

Webhooks zu Ihrer Meta App hinzufügen​

1. Meta App Dashboard öffnen​

Gehen Sie zu Ihrer App unter:

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

Klicken Sie auf Ihre App, um sie zu öffnen.

2. Webhooks-Produkt hinzufügen​

  1. Suchen Sie in der linken Sidebar nach "Add Product" oder scrollen Sie im Dashboard nach unten
  2. Finden Sie "Webhooks" in der Produktliste
  3. Klicken Sie auf "Set Up" oder "Configure"
tipp

Wenn Sie „Webhooks“ bereits in der linken Sidebar sehen, klicken Sie direkt darauf – kein erneutes Hinzufügen nötig.

3. „Page“ als Objekttyp auswählen​

  1. Auf der Webhooks-Seite sehen Sie ein Dropdown mit "User" als Standard
  2. Ändern Sie dieses Dropdown auf "Page"
warnung

Das ist entscheidend! Sie MÜSSEN „Page“ auswählen – nicht „User“, nicht „Application“, nichts anderes. Lead-Daten kommen über Page-Subscriptions.

4. Webhook abonnieren​

  1. Klicken Sie auf den Button "Subscribe to this object" (oder "Edit Subscription" falls bereits konfiguriert)
  2. Ein Dialog erscheint mit zwei Feldern:
FeldEingabe
Callback URLFügen Sie Ihre Webhook-URL aus dem Modul ein (z. B. https://yourcrm.com/facebookleadsintegration/webhook)
Verify TokenFügen Sie Ihren Verify Token aus dem Modul ein
  1. Klicken Sie auf "Verify and Save"

5. Was passiert beim Klick auf „Verify and Save“​

Facebook sendet sofort eine Verifizierungsanfrage an Ihre Webhook-URL:

Facebook: "Hey, ist das wirklich Ihr Server?"
Ihr Modul: "Ja! Hier ist der Verify Token zum Beweis!"
Facebook: "Super, verifiziert!"

Bei Erfolg: Sie sehen eine Erfolgsmeldung und der Dialog schließt sich.

Bei Fehler: Siehe den Abschnitt Troubleshooting für häufige Lösungen.

6. „leadgen“-Events abonnieren​

Nach der Verifizierung müssen Sie Facebook mitteilen, welche Events gesendet werden sollen:

  1. Sie sehen eine Liste von Event-Typen unter „Page“-Subscriptions
  2. Finden Sie "leadgen" in der Liste (evtl. scrollen)
  3. Klicken Sie auf den "Subscribe"-Schalter/Checkbox neben „leadgen“
tipp

"leadgen" ist das EINZIGE Event, das Sie brauchen. Sie müssen keine anderen Events (wie „messages“ oder „feed“) abonnieren. Nur „leadgen“.

Verifizierung erfolgreich!​

Ihre Webhook-Konfiguration sollte nun so aussehen:

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

Im Perfex CRM-Modul sollte der Webhook-Status nun grün/Verifiziert anzeigen!

Webhook testen​

Möchten Sie sicherstellen, dass der Webhook funktioniert?

  1. Gehen Sie zu Perfex CRM → Meta Leads → Settings
  2. Klicken Sie auf den Button "Test Connection"
  3. Sie sollten alle grünen Häkchen sehen

Ausführlichere Tests folgen im Abschnitt Testing Leads.

Häufige Fehler vermeiden​

FehlerLösung
„User“ statt „Page“ gewähltÄndern Sie das Dropdown auf „Page“
„leadgen“ nicht abonniertFinden Sie „leadgen“ in der Liste und abonnieren Sie
HTTP statt HTTPS verwendetSSL-Zertifikat auf Ihrem Server installieren
Tippfehler in der Callback-URLDirekt aus den Moduleinstellungen kopieren
"Callback URL couldn't be validated"Siehe Troubleshooting

Webhook konfiguriert? Connect Your Pages