Meta Lead Forms Integration

Automatically capture leads from Facebook and Instagram Lead Ads directly into Expedify.

Time to complete: 20-25 minutes

---

What Are Meta Lead Forms?

Meta Lead Forms (formerly Facebook Lead Ads) allow users to:

• Submit their information without leaving Facebook/Instagram
• Pre-fill forms with their profile data
• Convert with minimal friction

Benefits:

• Higher conversion rates (2-3x typical landing pages)
• Mobile-optimized experience
• Automatic data capture
• Instant lead notification

---

Prerequisites

Before connecting Meta Lead Forms:

1. Meta Business Account: Verified business account
2. Facebook Page: Active page linked to ads
3. Ads Manager Access: Admin or advertiser role
4. Lead Forms Created: At least one lead form in Ads Manager

---

Setting Up the Integration

Step 1: Create Meta Integration

1. Go to Settings → Integrations
2. Click + Add Integration
3. Select Meta (Facebook)

Step 2: Authenticate with Meta

1. Click Connect with Facebook

2. Log into your Facebook account

3. Grant permissions:

   • Pages: Manage your pages
   • Leads: Access lead information
   • Ads: View ad accounts

4. Select pages to connect

5. Click Save

Step 3: Configure Webhook

Expedify automatically configures the webhook URL. Verify it's set up:

1. Go to Meta Business Suite
2. Navigate to Integrations → Leads Access
3. Confirm Expedify is listed as connected

---

Creating a Lead Capture Workflow

Step 1: Create New Workflow

1. Go to Automation → Workflows
2. Click + New Workflow
3. Name: "Meta Lead Capture"

Step 2: Add Meta Lead Trigger

1. Add Triggers → Webhook Trigger
2. Configure:

Setting	Value
Name	Meta Leads Webhook
Description	Receives Meta lead form submissions

Step 3: Map Lead Data

The webhook receives lead data in this format:

{
  "leadgen_id": "123456789",
  "page_id": "987654321",
  "form_id": "111222333",
  "created_time": "2024-01-15T10:30:00+0000",
  "field_data": [
    { "name": "email", "values": ["john@example.com"] },
    { "name": "full_name", "values": ["John Smith"] },
    { "name": "phone_number", "values": ["+1234567890"] }
  ]
}

Step 4: Create Contact from Lead

Add CRM → Create Contact node:

Field	Mapping
Email	{{webhook.field_data[0].values[0]}}
Name	{{webhook.field_data[1].values[0]}}
Phone	{{webhook.field_data[2].values[0]}}
Lead Source	"Meta Lead Form"
Tags	"facebook-lead"

Step 5: Add Follow-up Actions

After contact creation:

Option A: Send Welcome Email

Send Email Node
- To: {{contact.email}}
- Template: Welcome Email

Option B: Assign to Sales

Update Contact Node
- Owner: Sales Team
- Status: New Lead

Option C: Send WhatsApp

WhatsApp Send Node
- To: {{contact.phone}}
- Template: Welcome Message

Complete Workflow

Meta Webhook Trigger
    │
    ▼
Transform Data (extract fields)
    │
    ▼
Create Contact
    │
    ▼
Send Welcome Email
    │
    ▼
Notify Sales (Slack/Email)

---

Field Mapping Reference

Standard Meta Lead Fields

Meta Field	CRM Field
email	email
full_name	name
first_name	first_name
last_name	last_name
phone_number	phone
company_name	company
job_title	job_title
city	city
state	state
country	country
zip	postal_code

Custom Fields

If your lead form has custom questions:

Question: "What product are you interested in?"
Field name: "custom_question_123"
Access: {{webhook.field_data[n].values[0]}}

Map to CRM custom fields:

• Create matching custom field in Contacts
• Map in workflow transformation

---

Handling Multiple Forms

Form-Specific Routing

Use conditions to route by form ID:

Webhook Trigger
    │
    ▼
Condition: form_id equals "product_a_form_id"
    │
    ├── True → Product A Lead Flow
    │
    └── False → Check next form
                  │
                  ├── True → Product B Lead Flow
                  │
                  └── Default → General Lead Flow

Tagging by Campaign

Add campaign-specific tags:

Tags based on form_id:
- form_123 → "spring-sale"
- form_456 → "product-demo"
- form_789 → "newsletter"

---

Testing the Integration

Test Method 1: Meta Lead Ads Testing Tool

1. Go to Meta Ads Manager
2. Navigate to Lead Forms
3. Click on your form
4. Use Test Lead feature
5. Verify lead appears in Expedify

Test Method 2: Preview Lead Form

1. Preview your ad in Ads Manager
2. Submit test lead
3. Check workflow execution

Test Method 3: Manual Webhook Test

1. Copy the webhook URL from your workflow
2. Send test POST request with sample data
3. Verify workflow triggers

---

Best Practices

Lead Form Design

Optimize for Conversion:
- Keep fields minimal (3-5 fields)
- Use pre-filled fields when possible
- Clear value proposition
- Strong call-to-action

Avoid:
- Too many required fields
- Complicated custom questions
- Missing privacy policy

Lead Quality

Improve Lead Quality:
- Use higher intent placements
- Add qualifying questions
- Target specific audiences
- Use lookalike audiences

Filter Low Quality:
- Validate email format
- Check phone format
- Score by engagement

Response Time

Speed to Lead:
- Respond within 5 minutes
- Automated welcome message
- Immediate follow-up workflow
- Sales notification

Studies show:
- 5 min response = 9x conversion
- 30 min response = 21x lower conversion

Data Privacy

Compliance:
- Include privacy policy link
- Honor opt-out requests
- Store data securely
- Follow GDPR/CCPA rules

---

Troubleshooting

Leads Not Arriving

1. Check webhook URL - Correct in Meta?
2. Verify permissions - Lead access granted?
3. Check workflow - Trigger active?
4. Review Meta webhook - Status healthy?

Missing Fields

1. Check field mapping - Correct index?
2. Verify form fields - All fields in form?
3. Test with actual lead - Not test lead?
4. Review raw payload - What's being sent?

Duplicate Contacts

1. Check deduplication - Email matching?
2. Review workflow logic - Create vs update?
3. Implement upsert - Use Create or Update node

Delayed Leads

Meta may batch leads. Check:

1. Webhook timing - When received vs created
2. Queue processing - Any delays?
3. Meta delivery - Check lead access

---

Advanced Configurations

Real-Time Webhooks

Ensure fastest delivery:

1. In Meta Business Suite
2. Go to Integrations → Leads
3. Enable Real-time Updates
4. Verify webhook endpoint responds 200 OK quickly

Lead Scoring

Score leads automatically:

Lead Score Calculation:
- Has company: +20
- Has phone: +10
- Enterprise question: +30
- Demo request: +25
- Newsletter only: +5

Multi-Page Setup

Connect multiple Facebook pages:

1. Add each page in integration
2. Create page-specific workflows
3. Route by page_id in conditions

---

Workflow Templates

Simple Lead Capture

Webhook → Create Contact → Email Welcome

Sales Qualified Lead

Webhook → Create Contact → Score Lead →
├── Score > 50 → Assign Sales → Slack Alert
└── Score < 50 → Add to Nurture

Multi-Channel Follow-up

Webhook → Create Contact →
├── Send Email
├── Send WhatsApp (if phone)
└── Create Task for Sales

---

Next Steps

With Meta Lead Forms connected:

1. Creating Segments - Segment your leads
2. Launching Campaigns - Nurture leads
3. Creating Your First Workflow - Automate more

---

Quick Reference

Meta Lead Form Payload

{
  "leadgen_id": "string",
  "page_id": "string",
  "form_id": "string",
  "created_time": "ISO timestamp",
  "field_data": [
    {
      "name": "field_name",
      "values": ["value"]
    }
  ]
}

Common Field Indices

Index	Typical Field
0	email
1	full_name
2	phone_number
3+	Custom fields

Response Time Goals

Timing	Conversion Impact
Under 5 min	Optimal
5-30 min	Good
30-60 min	Fair
Over 1 hour	Poor