Skip to main content

Connect Your Pages

Almost there! Now we need to tell your Meta App which Facebook Pages to monitor for leads.

Why Do I Need to Connect a Page?โ€‹

Lead Ads run on Facebook Pages (and linked Instagram accounts). Your Meta App needs permission to access a specific Page's lead data.

Think of it this way:

Your Meta App:  "Facebook, can I have the leads from Page XYZ?"
Facebook: "Sure, let me check... โœ… You're the admin. Here you go!"

Connect Your Facebook Accountโ€‹

1. Go to Module Settingsโ€‹

  1. In Perfex CRM, go to Meta Leads โ†’ Settings
  2. Scroll down to the "Connected Pages" section
  3. Click the "Connect with Facebook" button

2. Log In & Grant Permissionsโ€‹

A Facebook popup window will appear:

  1. Log in with the Facebook account that manages your Page
  2. You'll see a list of permissions the app is requesting:
PermissionWhat It MeansWhy We Need It
Pages: Show listSee your list of PagesTo know which Pages you manage
Pages: Read engagementRead Page dataTo access Page information
Leads retrievalAccess lead form dataThis is the main one! Retrieves submitted leads
Page ads managementManage Page adsTo subscribe to lead notifications
Ads managementManage ad campaignsTo interact with Lead Ad campaigns
  1. Click "Continue" or "Allow"
warning

Grant ALL permissions! If you skip any, the module won't work correctly. You can always change permissions later in Facebook Settings โ†’ Apps and Websites.

3. Select Pages (if prompted)โ€‹

Facebook might ask you which Pages to grant access to:

  • Select all Pages you want to monitor for leads
  • Or at minimum, select the Page(s) you'll run Lead Ads on

Click Done

Subscribe to Your Pageโ€‹

After connecting, you'll see a table with your Facebook Pages:

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Page Name โ”‚ Status โ”‚ Leads Received โ”‚ Action โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ My Business Page โ”‚ Not Active โ”‚ 0 โ”‚[Subscribe]โ”‚
โ”‚ Test Page โ”‚ Not Active โ”‚ 0 โ”‚[Subscribe]โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

For Each Page You Want to Monitor:โ€‹

  1. Click the green "Subscribe" button (or "Monitor")
  2. Wait a moment
  3. The status should change to "Monitoring"

That's it! This Page is now connected. Any Lead Ads running on this Page will automatically send leads to your Perfex CRM.

What About Instagram?โ€‹

Great news - Instagram is automatic!

If your Facebook Page is linked to an Instagram Business account (which is required for Instagram ads anyway), lead data from Instagram Lead Ads will flow through the same Page webhook.

You don't need to do anything extra for Instagram. Same setup, both platforms.

How to check if Instagram is linked to your Page:โ€‹

  1. Go to your Facebook Page
  2. Click Settings
  3. Click Linked Accounts or Instagram
  4. If you see your Instagram account linked, you're good to go!

Multiple Pagesโ€‹

You can subscribe to multiple Pages at once! Just click "Subscribe" on each Page you want to monitor.

Each Page operates independently - you can subscribe/unsubscribe at any time.

Refreshing the Page Listโ€‹

If you create a new Facebook Page after the initial setup:

  1. Go to Meta Leads โ†’ Settings
  2. Click "Connect with Facebook" again
  3. Grant access to the new Page
  4. Subscribe to it

Connection Complete!โ€‹

At this point, your setup looks like this:

โœ… Meta App created
โœ… App ID & Secret configured
โœ… Webhook verified
โœ… Page(s) subscribed and monitoring

๐ŸŽ‰ You're ready to receive leads!

Quick Testโ€‹

Before moving on, let's verify everything works:

  1. Go to Meta Leads โ†’ Settings
  2. Click "Test Connection"
  3. You should see:
    • App Credentials: Valid
    • Access Token: Valid
    • Permissions: All granted
  4. Click "Send Test Lead"
  5. Check if a test lead appears in Perfex CRM โ†’ Leads
tip

Test lead not appearing? Check the Troubleshooting page.

Pages connected! App Review & Permissions or Settings Page