Telemantix Docs
Back to Integrations

Connect Meta Facebook Lead Ads

Automatically import leads from Facebook Lead Ads forms into Telemantix CRM in real time.

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

1
Go to developers.facebook.com and sign in with your Business account.
2
Click My Apps → Create App.
3
Select Business as the app type and complete the form.
4
Go to Settings → Basic and copy your App ID and App Secret.

Step 2 — Configure Facebook Login

1
In your app dashboard, click Add Product and add Facebook Login for Business.
2
Go to Facebook Login → Settings.
3
Under Valid OAuth Redirect URIs, add:
https://app.telemantix.com/api/integrations/meta/oauth/callback
4
Save changes.

Step 3 — Get Required Permissions

In App Review → Permissions and Features, ensure these are approved:

  • pages_manage_metadata
  • leads_retrieval
  • pages_read_engagement
  • pages_manage_ads

During development, you can test with your own Facebook account without App Review approval.

Step 4 — Connect in Telemantix

1
Go to Integrations → Meta Facebook Lead Ads → Configure.
2
Enter your App ID, Page ID, and Lead Form ID.
3
Enter App Secret and set a Verify Token (any random string).
4
Click Connect with Meta for one-tap OAuth — this fetches your Page Access Token automatically.
5
Click Sync to import existing leads immediately.

Step 5 — Set Up Webhook

1
In Meta Developer Console, go to Webhooks → Add Callback URL.
2
Set Callback URL to the webhook URL shown in your Telemantix configure modal.
3
Set Verify Token to the same value you entered in Step 4.
4
Under Page subscriptions, add your page and subscribe to the leadgen field.
5
Click Verify and Save. New leads will now flow in automatically.

Fields Reference

App IDYour Meta Developer App ID — found in Settings → Basic.
Page IDNumeric ID of your Facebook Page — visible in Page Settings → About.
Lead Form IDID of the specific Lead Ad form — found in Ads Manager → Lead Gen Forms.
App SecretYour Meta App Secret — found in Settings → Basic. Stored encrypted.
Verify TokenAny random string you choose. Must match what you enter in Meta Webhook settings.
Page Access TokenOptional manual override. Leave blank if you used OAuth — it's fetched automatically.

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.