CRMconnect Azuvio · Docs
⌘K

Facebook Leads Integration

Section: Integrations & AI
URL: /admin/facebookleadsintegration
Page title: Facebook Leads Integration

Overview

The Facebook Leads Integration receives leads from Facebook Lead Ads via webhook and automatically creates CRM lead records. When a prospect fills out a Facebook instant form, their data flows directly into your CRM pipeline in real time — no manual export required.

Business value

Closes the gap between paid social advertising and CRM follow-up. Leads arrive in the CRM within seconds of a Facebook form submission, giving sales reps the fastest possible follow-up window.

  • Who uses it: Marketing, sales, SDRs
  • Key benefit: Reduce lead follow-up time from hours (manual CSV export) to seconds (real-time webhook), which directly improves contact rate and conversion.
  • Metrics it influences: Lead response time, lead-to-contact rate, cost per qualified lead from Facebook

Typical use cases:

  • Run a Facebook Lead Ad campaign; every submission creates a CRM lead instantly with source tagged as "Facebook Lead Ad"
  • Map Facebook form fields (name, email, phone, company) to the corresponding CRM lead fields
  • Route Facebook leads to a specific pipeline stage or assigned rep based on the campaign

Accessing this module

From the admin sidebar, navigate to Facebook Leads, or open the URL directly:

/admin/facebookleadsintegration

Setup overview

  1. Configure the integration — enter your Facebook App ID, App Secret, and Page Access Token.
  2. Register the webhook URL — copy the CRM webhook endpoint and add it as a subscribed webhook in your Facebook App settings. The endpoint is excluded from CSRF verification to allow Facebook delivery.
  3. Map form fields — match Facebook Lead Ad form field names to CRM lead fields.
  4. Test with a lead — submit a test lead from Facebook to confirm the CRM record is created correctly.
  5. Monitor incoming leads — new leads appear in the CRM Leads list with source "Facebook Lead Ad".

Field mapping

Facebook form fields are mapped to CRM fields during setup. Common mappings:

Facebook field CRM lead field
full_name Name
email Email
phone_number Phone
company_name Company
Custom fields Mapped to CRM custom fields

Source: crm-connect-main/app/modules/facebookleadsintegration