Facebook Lead Ads Trigger¶

Overview¶

The Facebook Lead Ads Trigger automatically captures lead submissions directly from your Facebook Lead Ads campaigns in real-time. When someone submits a lead form on Facebook or Instagram, their information is instantly sent to your BaseCloud workflow for processing.

When to use this trigger:

• Capture leads from Facebook and Instagram Lead Ads
• Process leads in real-time (instant follow-up)
• Add leads to CRM automatically
• Send immediate auto-response emails
• Trigger nurture sequences from Facebook leads
• Track and attribute Facebook lead campaigns

Quick Start¶

1. Create a Facebook Lead Ads campaign with a lead form
2. Connect your Facebook account to BaseCloud
3. Create a new workflow
4. Add a Facebook Lead Ads Trigger as the first task
5. Select which Facebook page and lead form to monitor
6. Save and enable the workflow
7. When leads submit the form, the workflow runs automatically

[SCREENSHOT NEEDED: Facebook Lead Ads Trigger task panel showing page and form selection]

Connecting Facebook Account¶

Prerequisites¶

• Facebook Business Page
• Facebook Ads account with Lead Ads enabled
• Admin access to the Facebook page

Connection Steps¶

1. In the Facebook Lead Ads Trigger settings, click "Connect Facebook Account"
2. Log in to Facebook (if not already logged in)
3. Authorize BaseCloud to access:
4. Your pages
5. Lead form data
6. Read leads
7. Select which Facebook pages to connect
8. Complete authorization

Permissions Required: - pages_read_engagement - Read page data - leads_retrieval - Access lead information - pages_manage_ads - Manage lead forms

[SCREENSHOT NEEDED: Facebook OAuth authorization screen showing permissions]

Managing Connected Pages¶

After connecting, you can: - View all connected pages - Add more pages - Disconnect pages - Refresh access tokens

Selecting Lead Forms¶

Choose Page¶

Select which Facebook page's lead forms you want to monitor:

Select Page: Your Business Name (@yourbusiness)

Choose Lead Form¶

Select which specific lead form to monitor:

Select Lead Form: Contact Us Form

Or select "All Forms" to trigger on any lead form from that page.

Best Practice: Create separate workflows for different lead forms to handle them differently (e.g., different follow-up sequences for different offers).

Output Fields¶

The Facebook Lead Ads Trigger outputs comprehensive lead data:

Basic Lead Information¶

Lead Form Fields¶

Dynamic fields based on your form setup. Common examples:

Custom Questions¶

Any custom questions in your form:

Example: - Form question: "What is your budget?" - Output field: task_56123_question_what_is_your_budget

Campaign Attribution (if available)¶

Real-World Examples¶

Example 1: Instant Lead Response¶

Trigger: Any lead from Contact Us form

Workflow: 1. Facebook Lead Ads Trigger - Capture lead 2. Match to Client - Find existing contact in CRM 3. Edit Client - Add "Facebook Lead" and campaign name tags 4. Email - Send instant auto-response:

Hi {{task_56123_first_name}},

Thank you for your interest! We received your inquiry and will get back to you within 1 hour.

Best regards,
Your Team

Example 2: Lead Qualification and Routing¶

Trigger: Lead from any form

Workflow: 1. Facebook Lead Ads Trigger - Capture lead 2. Code Task - Calculate lead score based on: - Budget answer (if asked) - Company size - Job title level - Location 3. Match to Client - Find existing contact 4. Edit Client - Store lead score 5. If Task - Route based on score: - High score (80+): - Email senior sales rep immediately - Add "Hot Lead" tag - Create high-priority task in CRM - Medium score (50-79): - Add to standard follow-up sequence - Assign to available rep - Low score (below 50): - Add to nurture email sequence - No immediate sales contact

Example 3: Multi-Touch Campaign¶

Trigger: Lead from promotional offer form

Workflow: 1. Facebook Lead Ads Trigger - Capture lead 2. Match to Client - Find existing contact 3. Edit Client - Add campaign tags 4. Email - Day 0: Send offer details immediately 5. Delay - Wait 2 days 6. Email - Day 2: Send educational content 7. Delay - Wait 3 days 8. Email - Day 5: Send customer testimonials 9. Delay - Wait 2 days 10. If Task - Check if converted - Not converted: Send final offer with urgency - Converted: Send thank you and onboarding

Example 4: Event Registration¶

Trigger: Lead from webinar registration form

Workflow: 1. Facebook Lead Ads Trigger - Capture registration 2. Match to Client - Find existing attendee record 3. Edit Client - Add "Webinar Feb 2024" tag 4. Email - Send confirmation with calendar invite 5. Google Sheets - Add to attendee list 6. Delay - Wait until 24 hours before event 7. Email - Send reminder with webinar link 8. Delay - Wait until 1 hour before event 9. Email - Send final reminder 10. [After event] Delay - Wait 2 hours after event 11. Email - Send recording and thank you

Example 5: Lead Enrichment and CRM Sync¶

Trigger: Lead from any form

Workflow: 1. Facebook Lead Ads Trigger - Capture basic lead info 2. Webhook Out - Call enrichment API (Clearbit, etc.) 3. Code Task - Merge Facebook data with enrichment data 4. Match to Client - Find existing contact record 5. Edit Client - Add all enriched data: - Social profiles - Company info - Industry - Company size 6. Webhook Out - Sync to external CRM if needed 7. Email - Send personalized email using enriched data

Facebook Lead Form Best Practices¶

Form Design Tips¶

Keep forms short: - Ask only essential questions - More fields = lower completion rate - Start with: Name, Email, Phone (optional)

Use pre-filled information: - Facebook auto-fills from user's profile - Reduces friction significantly

Mobile-first: - Most leads will be on mobile - Test form on mobile devices

Clear privacy policy: - Required by Facebook - Build trust with leads

Custom Questions Strategy¶

Use multiple choice when possible: - Easier for users than typing - Cleaner data for you - Examples: Budget ranges, services of interest, timeline

Conditional questions: - Show questions based on previous answers - Keeps form relevant and shorter

Qualification questions: - Ask budget, timeline, decision-maker status - Helps with lead scoring

Handling Lead Data¶

Data Validation¶

Always validate Facebook lead data:

const email = results['task_56123_email'];
const phone = results['task_56123_phone_number'];
const name = results['task_56123_full_name'] || 
             `${results['task_56123_first_name']} ${results['task_56123_last_name']}`;

// Validate email format
const isValidEmail = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);

// Check required fields
const hasRequiredData = !!(name && email);

return {
  is_valid: isValidEmail && hasRequiredData,
  lead_name: name
};

Phone Number Formatting¶

Facebook provides phone numbers in various formats. Normalize them:

1. Facebook Lead Ads Trigger
2. Phone Formatter - Normalize to E.164 format (+27123456789)
3. Continue with processing

Duplicate Prevention¶

Check for existing contacts:

1. Facebook Lead Ads Trigger
2. Match to Client with update mode
3. If Task - Check if existing contact
4. Existing: Update notes with new submission, don't send duplicate welcome
5. New: Send full onboarding sequence

Campaign Tracking¶

Attribution¶

Tag leads with campaign information:

Tag: "FB Lead - {{task_56123_campaign_name}}"
Tag: "Ad - {{task_56123_ad_name}}"
Tag: "Form - {{task_56123_form_name}}"

ROI Tracking¶

1. Track leads by campaign
2. Track which leads convert to customers
3. Calculate cost per lead from Facebook
4. Calculate customer acquisition cost
5. Measure ROI per campaign

Best Practices¶

✅ Do's¶

• Respond immediately: Speed matters for lead conversion
• Thank leads instantly: Send auto-response within seconds
• Qualify leads: Use form questions and lead scoring
• Track campaign attribution: Always tag with source campaign
• Test your workflow: Submit test leads before launching campaigns
• Follow up multiple times: Don't give up after one email
• Monitor lead quality: Track conversion rates by campaign
• Sync to CRM: Keep all systems updated

❌ Don'ts¶

• Don't wait to respond: Leads go cold quickly
• Don't ignore low-quality leads: Nurture them differently
• Don't forget privacy compliance: Handle data per GDPR/POPIA
• Don't lose attribution: Always track which campaign generated lead
• Don't send generic responses: Personalize with lead's information
• Don't skip validation: Check data quality before processing

Troubleshooting¶

Leads Not Triggering Workflow¶

Possible Causes: - Facebook account not connected or token expired - Workflow disabled - Wrong page or form selected - Facebook webhook not configured (auto-configured, but can fail)

Solutions: 1. Check Facebook account connection status 2. Reconnect Facebook account 3. Verify workflow toggle is ON 4. Check page and form selection 5. Submit test lead through Facebook form

Missing Field Data¶

Possible Causes: - User skipped optional field - Field not included in current form version - Form questions changed

Solutions: 1. Handle optional fields gracefully with If tasks 2. Check form configuration in Facebook 3. Use default values for missing data

Delayed Lead Delivery¶

Cause: Facebook sometimes batches lead delivery (rare)

Solution: Facebook usually delivers instantly, but can take up to 5 minutes. If consistently delayed, check Facebook webhook status.

Duplicate Leads¶

Possible Causes: - User submitted form multiple times - Facebook webhook retry

Solutions: 1. Use Match to Client with update mode 2. Add deduplication using lead_id:

// Store processed lead IDs to avoid reprocessing

Advanced Features¶

Multi-Page Lead Capture¶

If running campaigns on multiple Facebook pages:

Create separate workflows per page, or: 1. Create one workflow with "All Pages" selected 2. Use If task to route based on page_id or page_name

A/B Testing Forms¶

Test different lead form variations:

Form A Workflow: - Trigger: Form A leads - Tag: "Form A Test" - Send version A email

Form B Workflow: - Trigger: Form B leads - Tag: "Form B Test" - Send version B email

Track conversion rates to determine winner.

Lead Scoring with Machine Learning¶

1. Collect lead data over time
2. Track which leads convert
3. Use AI Prompt or external ML model to predict conversion probability
4. Score new leads automatically
5. Route based on predicted likelihood

Cross-Platform Lead Management¶

Combine with other lead sources:

• Facebook Lead Ads Trigger → Tag "Facebook"
• Form Submission Trigger → Tag "Website"
• Leads Mail Trigger → Tag "Email"

All feed into centralized lead processing workflow.

Frequently Asked Questions¶

Do I need a Facebook Ads account?¶

Yes, Facebook Lead Ads is an advertising feature requiring an active Ads account.

Can I capture leads from Instagram?¶

Yes! Instagram Lead Ads (run through Facebook Ads Manager) work the same way. The trigger captures both Facebook and Instagram leads.

How quickly are leads delivered?¶

Usually within 10-30 seconds of submission. Facebook webhooks are real-time.

Can I test without running real ads?¶

Yes, use Facebook's "Test" button on your lead form to submit test leads without spending on ads.

What if I change my lead form?¶

Update your workflow if you added/removed questions. Existing workflows continue working but new fields won't be captured unless mapped.

Can I download historical leads?¶

The trigger only captures new leads going forward. For historical leads, download CSV from Facebook Ads Manager and import to CRM.

Does this work with Facebook's CRM integrations?¶

This is an alternative to Facebook's native CRM integrations. Use BaseCloud for more flexibility and custom workflows.

What if my Facebook token expires?¶

You'll receive an alert. Simply reconnect your Facebook account to refresh the token.

Can I use multiple forms in one workflow?¶

Yes, select "All Forms" or use If task to check form_name and route accordingly.

Next Steps: - Form Submission Trigger - Website form leads - Leads Mail Trigger - Email-based leads - Match to Client Task - Find/update contact records