Leads aus Instant Forms kommen bis zu 15 Minuten verspätet

Bereich: Instant Forms · Stand: 31.10.2026 · In English · Alle Artikel

Symptome

  • Ein Lead aus einem Instant Form ist bei Meta sofort da, in X3 und als Push aber erst bis zu 15 Minuten später.
  • Unter Einstellungen › Instant Forms › So kommen die Leads an steht beim Echtzeit-Webhook „nicht eingerichtet“ und „Bis dahin holt X3 die Leads alle 15 Minuten ab.“
  • An der Seite steht „Webhook nicht abonniert: …“ statt „Echtzeit-Webhook abonniert“.
  • „Letzter Webhook“ an der Seite zeigt „noch nie“.

Ursache

  • Ohne Echtzeit-Webhook holt X3 die Leads per Abgleich alle 15 Minuten bei Meta ab. Das ist kein Fehler, nur langsamer.
  • Seiten, die Du mit „Mit Facebook verbinden“ verbunden hast, melden an die X3-App der Installation. Deren App-Secret und Verify-Token setzt der X3-Betrieb; fehlen sie, steht beim Echtzeit-Webhook „nicht eingerichtet“.
  • Das Webhook-Abo der Seite fehlt oder ist abgelaufen (z. B. fehlte beim Verbinden eine Berechtigung). „Jetzt abgleichen“ abonniert nicht neu, „Webhook neu abonnieren“ schon.
  • Die Seite ist mit einem Token aus Deiner eigenen Meta-App verbunden („Erweitert: Token einfügen“): dann schickt Meta die Echtzeit-Meldung an Deine App. Ohne „Echtzeit mit Deiner eigenen Meta-App“ zeigt Deine App nicht auf X3.

So löst Du das

1. Status ansehen

  • Im Dashboard: Einstellungen › Instant Forms › So kommen die Leads an
  • Mit Claude (MCP): instant_forms_status {"project":"mein-shop"}

webhookConfigured false heißt: die X3-App der Installation hat keinen Echtzeit-Webhook. Das betrifft nur Seiten, die über „Mit Facebook verbinden“ laufen (Schritt 6). Seiten mit eigenem Token richtest Du selbst ein (Schritt 4 und 5).

2. Seite prüfen

  • Im Dashboard: Einstellungen › Instant Forms › Deine Seite › Echtzeit-Webhook abonniert
  • Mit Claude (MCP): instant_forms_pages_list {"project":"mein-shop"}

subscribed false oder ein subscribeError: weiter mit Schritt 3. connectedVia token heißt: die Seite hängt an Deiner eigenen Meta-App (Schritt 4).

3. Webhook neu abonnieren

  • Im Dashboard: Einstellungen › Instant Forms › Deine Seite › Webhook neu abonnieren
  • Mit Claude (MCP): instant_forms_resubscribe {"project":"mein-shop","page_id":"1234567"}
  • Knopf und MCP-Tool gibt es seit dem Update vom 31.10.2026; vorher ging das nur durch Trennen und neu Verbinden.

Erneuert das Abo mit dem gespeicherten Seiten-Token, ohne die Seite zu trennen, und liest zurück, welche Apps Meta als abonniert führt. Meldet Meta eine fehlende Berechtigung (pages_manage_metadata), verbinde die Seite neu: Trennen › Mit Facebook verbinden, im Facebook-Dialog alle Häkchen setzen. Das machst Du selbst im Dashboard; X3 nimmt Tokens nie über Claude an.

4. Echtzeit mit Deiner eigenen Meta-App einrichten

  • Im Dashboard: Einstellungen › Instant Forms › Echtzeit mit Deiner eigenen Meta-App › App-ID und App-Secret › Speichern
  • Mit Claude (MCP): instant_forms_own_app_update {"project":"mein-shop","app_id":"1234567"}
  • Seit dem Update vom 31.10.2026.

Nur für Seiten mit eigenem Token. App-ID und App-Secret stehen in der Meta-App unter Einstellungen › Allgemein. Das App-Secret ist nur schreibbar: X3 speichert es verschlüsselt und zeigt danach nur „gesetzt …“. Gib es selbst im Dashboard ein oder füg es Claude nur ein, wenn Du das willst (app_secret). Danach zeigt X3 die Callback-URL und den Verify-Token dieses Projekts.

5. Callback-URL und Verify-Token in der Meta-App eintragen

  • Im Dashboard: Einstellungen › Instant Forms › Echtzeit mit Deiner eigenen Meta-App › Callback-URL und Verify-Token › Kopieren
  • Mit Claude (MCP): instant_forms_own_app_get {"project":"mein-shop"}

In der Meta-App unter Webhooks › Page › Dieses Objekt abonnieren die Callback-URL und den Verify-Token einfügen und das Feld leadgen abonnieren. Meta prüft die Adresse sofort: danach steht bei „Geprüft von Meta“ eine Zeit (verifiedAt). Dann für jede Seite Schritt 3. Kommt eine Meldung mit falscher Signatur an, steht unter „Fehler“, dass das App-Secret nicht zur App passt.

6. Echtzeit-Webhook der X3-App

  • Im Dashboard: Kein Weg im Dashboard (Seiten über „Mit Facebook verbinden“ melden an die X3-App der Installation, und Meta schickt Echtzeit-Meldungen nur an die Callback-URL dieser App. Deren App-Secret und Verify-Token setzt der X3-Betrieb; steht dort „nicht eingerichtet“, schreib dem X3-Support)
  • Mit Claude (MCP): Kein MCP-Tool (Seiten über „Mit Facebook verbinden“ melden an die X3-App der Installation, und Meta schickt Echtzeit-Meldungen nur an die Callback-URL dieser App. Deren App-Secret und Verify-Token setzt der X3-Betrieb; steht dort „nicht eingerichtet“, schreib dem X3-Support)

Bis dahin kommen die Leads zuverlässig per Abgleich, nur mit bis zu 15 Minuten Verzögerung, verpasste Webhooks holt der Abgleich ebenfalls nach. Willst Du Echtzeit, ohne auf den Betrieb zu warten, verbinde die Seite mit einem Token Deiner eigenen Meta-App und richte Schritt 4 und 5 ein.

7. Sofort abgleichen

  • Im Dashboard: Einstellungen › Instant Forms › Deine Seite › Jetzt abgleichen
  • Mit Claude (MCP): instant_forms_sync {"project":"mein-shop","page_id":"1234567"}

Holt die Leads seit dem letzten Abgleich sofort. page_id steht in instant_forms_pages_list.

8. Mit einem Test-Lead prüfen

  • Im Dashboard: Einstellungen › Instant Forms › Formular › Test-Lead simulieren
  • Mit Claude (MCP): instant_forms_simulate {"project":"mein-shop","form_id":"7654321"}

Woran Du siehst, dass es geklappt hat

  • Mit eigener Meta-App: unter Echtzeit mit Deiner eigenen Meta-App steht bei „Geprüft von Meta“ eine Zeit und „Letzte Meldung“ ist aktuell.
  • Unter So kommen die Leads an steht beim Echtzeit-Webhook „eingerichtet“, an der Seite „Echtzeit-Webhook abonniert“.
  • „Letzter Webhook“ an der Seite zeigt eine Zeit, und ein neuer Lead erscheint in Sekunden in X3.

Verwandte Artikel