Instant Form leads arrive up to 15 minutes late

Area: Instant Forms · Updated: 31 Oct 2026 · Auf Deutsch · All articles

Symptoms

  • A lead from an Instant Form is in Meta right away, but in X3 and as a push up to 15 minutes later.
  • Einstellungen › Instant Forms › So kommen die Leads an shows „nicht eingerichtet“ for the Echtzeit-Webhook and „Bis dahin holt X3 die Leads alle 15 Minuten ab.“
  • The page reads „Webhook nicht abonniert: …“ instead of „Echtzeit-Webhook abonniert“.
  • „Letzter Webhook“ on the page shows „noch nie“.

Cause

  • Without the real-time webhook X3 fetches the leads from Meta every 15 minutes. That is no error, only slower.
  • Pages you connected with „Mit Facebook verbinden“ report to the installation's X3 app. Its app secret and verify token are set by the X3 operator; without them the real-time webhook shows „nicht eingerichtet“.
  • The page's webhook subscription is missing or gone (e.g. a permission was missing when connecting). „Jetzt abgleichen“ does not subscribe again, „Webhook neu abonnieren“ does.
  • The page is connected with a token of your own Meta app („Erweitert: Token einfügen“): then Meta sends the real-time message to your app. Without „Echtzeit mit Deiner eigenen Meta-App“ your app does not point at X3.

How to fix it

1. Check the status

  • In the dashboard: Einstellungen › Instant Forms › So kommen die Leads an
  • With Claude (MCP): instant_forms_status {"project":"my-shop"}

webhookConfigured false means the installation's X3 app has no real-time webhook. That only affects pages that use „Mit Facebook verbinden“ (step 6). Pages with your own token you set up yourself (steps 4 and 5).

2. Check the page

  • In the dashboard: Einstellungen › Instant Forms › your page › Echtzeit-Webhook abonniert
  • With Claude (MCP): instant_forms_pages_list {"project":"my-shop"}

subscribed false or a subscribeError: go on with step 3. connectedVia token means the page hangs on your own Meta app (step 4).

3. Renew the webhook subscription

  • In the dashboard: Einstellungen › Instant Forms › your page › Webhook neu abonnieren
  • With Claude (MCP): instant_forms_resubscribe {"project":"my-shop","page_id":"1234567"}
  • Button and MCP tool exist since the update of 31 Oct 2026; before, only disconnecting and connecting again did it.

Renews the subscription with the stored page token without disconnecting the page, and reads back which apps Meta lists as subscribed. If Meta reports a missing permission (pages_manage_metadata), connect the page again: Trennen › Mit Facebook verbinden, tick every box in the Facebook dialog. You do that yourself in the dashboard; X3 never takes tokens through Claude.

4. Set up real time with your own Meta app

  • In the dashboard: Einstellungen › Instant Forms › Echtzeit mit Deiner eigenen Meta-App › App-ID and App-Secret › Speichern
  • With Claude (MCP): instant_forms_own_app_update {"project":"my-shop","app_id":"1234567"}
  • Since the update of 31 Oct 2026.

Only for pages with your own token. App id and app secret are in the Meta app under Settings › Basic. The app secret is write-only: X3 stores it encrypted and afterwards only shows „gesetzt …“. Enter it yourself in the dashboard, or paste it to Claude only if you want to (app_secret). Then X3 shows this project's callback URL and verify token.

5. Enter callback URL and verify token in the Meta app

  • In the dashboard: Einstellungen › Instant Forms › Echtzeit mit Deiner eigenen Meta-App › Callback-URL and Verify-Token › Kopieren
  • With Claude (MCP): instant_forms_own_app_get {"project":"my-shop"}

In the Meta app under Webhooks › Page › Subscribe to this object paste the callback URL and the verify token and subscribe to the field leadgen. Meta checks the address right away: then „Geprüft von Meta“ shows a time (verifiedAt). Then step 3 for every page. If a message with a wrong signature arrives, „Fehler“ says the app secret does not belong to the app.

6. Real-time webhook of the X3 app

  • In the dashboard: No dashboard way (Pages using „Mit Facebook verbinden“ report to the installation's X3 app, and Meta sends real-time messages only to that app's callback URL. Its app secret and verify token are set by the X3 operator; if it says „nicht eingerichtet“, write to X3 support)
  • With Claude (MCP): No MCP tool (Pages using „Mit Facebook verbinden“ report to the installation's X3 app, and Meta sends real-time messages only to that app's callback URL. Its app secret and verify token are set by the X3 operator; if it says „nicht eingerichtet“, write to X3 support)

Until then the leads arrive reliably through the sync, only up to 15 minutes late; missed webhooks are caught up by the sync too. If you want real time without waiting for the operator, connect the page with a token of your own Meta app and set up steps 4 and 5.

7. Sync right away

  • In the dashboard: Einstellungen › Instant Forms › your page › Jetzt abgleichen
  • With Claude (MCP): instant_forms_sync {"project":"my-shop","page_id":"1234567"}

Fetches the leads since the last sync right away. page_id is in instant_forms_pages_list.

8. Check with a test lead

  • In the dashboard: Einstellungen › Instant Forms › Formular › Test-Lead simulieren
  • With Claude (MCP): instant_forms_simulate {"project":"my-shop","form_id":"7654321"}

How to tell it worked

  • With your own Meta app: under Echtzeit mit Deiner eigenen Meta-App „Geprüft von Meta“ shows a time and „Letzte Meldung“ is recent.
  • So kommen die Leads an shows „eingerichtet“ for the Echtzeit-Webhook, the page „Echtzeit-Webhook abonniert“.
  • „Letzter Webhook“ on the page shows a time, and a new lead appears in X3 within seconds.