What it is
What your customers (tenants) do to capture Facebook Lead Ad submissions in Wtflo.
Who does this
Tenant workspace admin or marketing user with Outbound permissions.
Prerequisites
Partner completed Lead Ads partner setup
Tenant has admin on Facebook Page with Lead Ad forms
WABA connected (recommended for WhatsApp follow-up)
Step-by-step — tenant
1. Connect Facebook
Open Outbound → Lead Generation Forms (or Connect Facebook from the module).
Click Connect Facebook.
Meta popup — sign in and grant all requested permissions (including leads_retrieval).
Popup closes — connection status shows connected.
2. Sync lead forms
Select the Facebook Page that owns your Lead Ad forms.
Click Sync forms — Wtflo lists leadgen_forms from Graph API.
Pick the form(s) you want to receive leads from.
3. Map form fields
For each form, map Meta question fields to Wtflo contact fields:
Full name → Name
Email → Email
Phone → Phone
Custom questions → Custom fields
Save mapping.
4. Subscribe page to webhook
Click Subscribe page (or enable toggle) for the selected Page.
Wtflo registers the Page for leadgen events on your platform Meta app.
Success message: page subscribed to leadgen webhook.
5. Follow up
New leads appear in Contact directory and optionally trigger automations.
Reply via WA Chat if phone number was captured.
Verify it works
In Facebook Ads Manager → your Lead form → Create test lead.
Within 1–2 minutes, contact appears in Wtflo with mapped data.
Check lead in contact profile — source tagged as Facebook Lead.
Common mistakes
Mistake Fix
Wrong Page selected Re-sync with correct Page
Field mapping missing Map before expecting contacts
Page not subscribed Click Subscribe after mapping
Permission denied Reconnect Facebook; partner must have Live app + App Review
Related
Facebook lead ads overview
Lead Ads troubleshooting
Broadcast campaigns