Meta Lead Ads
| Status | Kind | How you connect |
|---|---|---|
| Coming soon | Lead source | One click: approve bubbl3 on Meta Lead Ads's own page |
Meta Lead Ads isn't offered yet. This page says what it will do and what you can use meanwhile: a Lead URL, or Zapier, Make or n8n.
What it does
Connecting Meta Lead Ads sends each new lead from your Facebook Pages' lead forms to bubbl3 within seconds. Each lead:
- becomes (or updates) a contact, matched on phone and email, with the lead, ad, ad set, campaign and form ids it came from;
- goes through the Page's own lead source in bubbl3, which sets its labels, owner, consent and workflow;
- can start the lead source's workflow, for example "text new leads within 2 minutes".
Setup
You need full access to integrations in bubbl3, and to manage the Pages and their ads in Meta.
- In bubbl3, open Settings, Integrations, choose Meta Lead Ads, then Connect, and log in with Facebook.
- Pick the Pages whose leads should come to bubbl3. Each Page becomes its own connection with its own lead source.
- On each Page's connection, choose the lead forms (every form's leads come in until you choose).
- Open the Page's lead source and set How did these leads agree to hear from you? "Not sure" records leads' consent as unknown; they can still be texted, because you confirmed when connecting that everyone you send has agreed to receive texts. If your form has a consent checkbox, point the source at it to record it.
- Choose the source's workflow if you want each lead texted.
Disconnect
Disconnect a Page from its connection page in Settings, Integrations.
- Stops at once: new leads from the Page. bubbl3 removes its app from the Page in Meta once no other bubbl3 workspace uses that Page. The Page's lead source is paused.
- Deleted at once: bubbl3's Page access token.
- Kept: contacts made from leads, with their messages, labels, consent evidence and ad ids. The paused lead source and its settings stay, so reconnecting picks up where you left off.
- Deleted later: stored lead deliveries are deleted 30 days after they arrived. A lead bubbl3 couldn't read yet is kept until Meta's own 90 days run out.
Data shared
From Meta to bubbl3: each lead's answers (name, phone, email and your custom questions, including any consent checkbox), the lead's time, and its lead, ad, ad set, campaign and form ids; your Pages' names and lead forms.
From bubbl3 to Meta: nothing but the app's subscription to your Page's leads. bubbl3 never sends messages through Messenger, Instagram or WhatsApp.
Scopes and permissions
| Permission | Why bubbl3 needs it |
|---|---|
pages_show_list | List your Pages so you can pick them |
pages_manage_metadata | Subscribe bubbl3 to a Page's new leads |
pages_read_engagement | Read the Page bubbl3 is subscribed to |
leads_retrieval | Read each lead's answers |
pages_manage_ads | Read the Page's lead forms |
ads_management | Read leads from forms used in your ads |
Events
What bubbl3 receives
| Event in Meta | In bubbl3 |
|---|---|
leadgen | New lead. bubbl3 reads the lead and sends it through the Page's lead source: matched, labelled and, if you chose one, enrolled in its workflow. |
What bubbl3 writes back
Nothing. Meta Lead Ads only sends leads to bubbl3.
Sending rules that still apply
Meta Lead Ads never texts anyone itself. What it sends bubbl3 can start the lead source's workflow, and every workflow text goes through the same checks as a text you send from bubbl3. Nothing in Meta Lead Ads can turn them off.
- Consent. When you connect Meta Lead Ads or create a lead source, you confirm that everyone you send to bubbl3 has agreed to receive texts from you, so its contacts can be texted straight away. bubbl3 never texts a contact who opted out, and a workspace set to text only opted-in contacts texts only them.
- Opt-out. Replying STOP opts a contact out at once.
- Quiet hours. No texts from 8:00 PM to 9:00 AM in the contact's own time zone (from the phone's area code). A text due then waits until the morning.
- Pacing. Each line texts at most 15 new contacts an hour and 50 a day (fewer while a new line warms up), and spaces texts 20 to 90 seconds apart. A big import or batch is queued and sent as the limits allow, never dropped.
- First messages. Until a contact replies, a text can't include links, photos or files, phone numbers or email addresses, must be 300 characters or fewer, and at most 3 texts go out.
What Meta Lead Ads is told when bubbl3 doesn't send
Meta has nothing to write a refusal to. You see it in bubbl3: on the message, or on the workflow run's step.
| Reason | Code | What you see |
|---|---|---|
| A link before the contact replies | pre_reply_link_blocked | Not sent: "Links can't be sent until the contact replies" |
| A photo or file before the contact replies | pre_reply_media_blocked | Not sent: "Photos and files can't be sent until the contact replies" |
| A phone number before the contact replies | pre_reply_phone_blocked | Not sent: "Phone numbers can't be sent until the contact replies" |
| An email address before the contact replies | pre_reply_email_blocked | Not sent: "Email addresses can't be sent until the contact replies" |
| A first message that is too long | pre_reply_too_long | Not sent: "First messages must be 300 characters or fewer" |
| Too many texts without a reply | pre_reply_message_limit | Not sent: "Already sent 3 texts without a reply. Wait for the contact to reply" |
| The same text to too many people today | identical_text_limit | Not sent: "This exact text went to 20 people from this line today" |
| The line is paused after unanswered texts | unanswered_streak_limit | Not sent: "This line is paused after too many unanswered texts" |
| The contact opted out | contact_opted_out | Not sent: "The contact opted out of texts" |
| The workspace texts only opted-in contacts | consent_required | Not sent: "This workspace only texts contacts who opted in" |
| No line can reach the contact | line_unavailable | Not sent: "bubbl3's line for this contact isn't available" |
| Quiet hours | quiet_hours | Held: "Scheduled for 9:00 AM America/Chicago, quiet hours" |
| The line's daily limit | daily_new_contact_cap | Held: "Scheduled for Oct 15, 9:00 AM America/Chicago: today's limit for this line is reached" |
| The line's hourly limit of new contacts | hourly_new_contact_cap | Held: "Scheduled for 2:00 PM America/Chicago: this hour's limit of new contacts for this line is reached" |
The numbers are the default limits; a line's own limits change them. bubbl3's other checks (no phone number, a number that doesn't match) have their own plain reasons.
Limits and known gaps
- If Meta takes back the Page's access, the Page needs attention and its leads wait (up to Meta's 90 days) until you reconnect.
- A form made later is included until you choose specific forms.
- bubbl3 never treats a lead as consenting unless your lead source says how they agreed.
Troubleshooting
- No leads arrive. Check the Page's connection is connected, its forms are chosen (or none chosen), and its lead source isn't paused. Meta's Lead Ads Testing Tool sends a test lead.
- The Page needs attention. Meta refused the Page's token: reconnect, and leads held meanwhile are read.
- Leads arrive but nobody is texted. The person opted out, or the lead source has no workflow chosen.