Facebook and Instagram Leads ( Meta Ads ) Configuration

Facebook and Instagram Leads ( Meta Ads ) Configuration Wizard

We know “create a Facebook App” sounds scary. It’s not. Our step-by-step wizard walks you through the entire setup in about 10 minutes:

Step 1: Enter your App ID and App Secret (we show you exactly where to find them)
Step 2: Copy your webhook URL and paste it in Facebook (one click to copy)
Step 3: Connect with Facebook and authorize your pages
Step 4: Choose which pages to monitor
Step 5: Set your default lead status, source, and assigned staff

That’s it. You’re done. Leads will start flowing automatically. ⚡

And if you need more help, we have a comprehensive, baby-step online documentation that explains everything – including how to create the Meta App, what each button does, and what to expect at every step. Even if you’ve never touched a developer console before, you’ll be just fine.

Facebook Application Review from Meta is NOT Required #

Here’s something most sellers won’t tell you: you do NOT need to submit your Facebook App for review.

Since you’re creating your own app to access your own Pages, Facebook allows this in Development Mode. You don’t need to go through the lengthy app review process. Just create the app, add yourself as admin, and you’re live. ⚡

Our documentation explains this clearly so you never get confused by Facebook’s developer portal.

Visual Field Mapping – Map Any Field to Any CRM Field #

Your Facebook Lead Form might ask custom questions like “What’s your budget?” or “Preferred contact time”. Our visual field mapping interface lets you map these to any Perfex CRM field – including custom fields you’ve created.

Standard fields (name, email, phone, company, city, etc.) are auto-mapped. You only need to set up mapping for your custom questions. Drag, drop, done.

Sync History – Full Transparency #

See every single lead that came through: when it arrived, which page it came from, whether it was successful, skipped (duplicate), or failed. Filter by status and date. The Sync History Dashboard gives you complete visibility into your lead pipeline.

Never Lose a Lead – Retry Queue #

What if Facebook sends a lead but your server has a hiccup? No problem. The module automatically adds failed leads to a retry queue and processes them again later. Your leads are safe. ⚡

Duplicate Detection #

Running campaigns with frequent leads? Enable duplicate detection and the Integration will check if a lead with the same email or phone already exists in your CRM. No more double entries cluttering your pipeline.

One-Click Test – Verify Everything Works #

Two buttons that save you hours of debugging:

⚡ Test Connection – Instantly verifies your credentials, access token, and permissions with Facebook
⚡ Send Test Lead – Creates a fake test lead to verify the full flow from webhook to CRM entry

Click, confirm, done. No need to create a real ad campaign just to test.

Instagram Lead Ads – Same Setup, Zero Extra Work #

Yes, you read that right. Instagram Lead Ads work out of the box. Facebook and Instagram use the same underlying system (Meta), so when you connect your Facebook Page, Instagram leads flow through the exact same webhook. No separate setup, no extra configuration, no additional apps.

If your Facebook Page is linked to an Instagram Business Account (which it almost certainly is), Instagram leads just work. One setup covers both platforms. ⚡

Per-Page Lead Assignment – The Right Lead to the Right Person #

Managing multiple Facebook Pages? No problem. Our module lets you assign different staff members to different pages.

For example:
⚡ Leads from your Restaurant Page go to Sarah (your hospitality manager)
⚡ Leads from your Real Estate Page go to James (your property agent)
⚡ Leads from your Car Dealership Page go to Emma (your sales rep)

Each page has its own “Assign Leads To” dropdown. Just select and it saves automatically. If you leave it on default, it falls back to your global assigned staff. Simple, powerful, flexible.