What you'll need
- A Facebook Business account
- A Facebook Page with Lead Ads enabled
- Admin access to a Meta Developer App
- At least one published Lead Ad form
Step 1 — Create a Meta Developer App
Step 2 — Configure Facebook Login
Step 3 — Get Required Permissions
In App Review → Permissions and Features, ensure these are approved:
pages_manage_metadataleads_retrievalpages_read_engagementpages_manage_ads
During development, you can test with your own Facebook account without App Review approval.
Step 4 — Connect in Telemantix
Step 5 — Set Up Webhook
Fields Reference
Common Issues
Webhook verification fails
Make sure the Verify Token in Telemantix exactly matches what you entered in Meta Developer Portal. It's case-sensitive.
Leads not importing
Check that the leadgen subscription is active on your Page in Webhooks. Also ensure the Page ID matches the page your Lead Ad form belongs to.
OAuth token expired
Telemantix auto-refreshes tokens daily. If it's expired early, disconnect and reconnect via OAuth, or paste a new Page Access Token in the manual override field.
Permissions error
Ensure your Meta App has pages_manage_metadata and leads_retrieval approved. In development, only the app's admins/testers can authorize.
Still stuck?
WhatsApp us on +91 99103 43016 or raise a ticket from Support Tickets inside the app.
Related guides