Talkif Docs
Integrations

Meta Lead Ads

Auto-call Facebook and Instagram leads the moment they submit, and feed call outcomes back to Meta to sharpen ad targeting.

Connect a Facebook Page and Talkif places an AI phone call to every Lead Ads submission within seconds — running the flow you choose, from the caller ID you choose. As each call plays out, Talkif reports funnel-stage events back to Meta's Conversions API so Meta can optimize ad delivery toward leads that actually convert on the phone.

Configure it in the dashboard under Developer → Integrations.

Before you start, you need a published flow to run the calls, an active phone number to use as caller ID, and a Facebook Page you manage. To send conversion feedback, you also need a Meta dataset (pixel) ID from Events Manager.

Connect a Facebook Page

  1. In Developer → Integrations, start the Meta connection. You'll be redirected to Facebook to authorize Talkif.
  2. After authorizing, pick which Page to connect. Talkif subscribes that Page's leadgen webhook so new leads are delivered automatically.
  3. Optionally provide a dataset (pixel) ID to enable Conversions API feedback. You can add or change this later.

One account can connect multiple Pages. Access tokens are encrypted at rest and never leave the backend; lead webhooks are signature-verified.

Map lead forms to flows

A connected Page does nothing until you map its lead forms. Each mapping ties one Meta lead form to the flow, caller ID, and calling behavior used for leads from that form.

SettingDefaultRangeDescription
FlowThe published flow run when calling these leads.
Caller IDThe active phone number the call is placed from.
EnabledOnWhether new leads from this form trigger calls.
Call delay0s0–86400sHow long to wait after a lead arrives before calling.
Max attempts11–10Call attempts per lead, retrying on no-answer.
Retry delay30 min1–1440 minWait between retry attempts.

Leads from a form with no mapping are recorded but not called.

What happens when a lead comes in

  1. The lead submits your Facebook or Instagram Lead Ad. Meta delivers a leadgen webhook to Talkif.
  2. Talkif fetches the full lead, then creates or matches a contact from its fields.
  3. If the form is mapped and enabled, Talkif places the call with the mapped flow and caller ID, honoring the call delay and retry settings.
  4. Call and post-call analysis outcomes advance the lead through your funnel and are reported back to Meta.

You can review every ingested lead and its status in the dashboard.

Conversion feedback (Conversions API)

When a dataset is configured, Talkif sends a funnel-stage event to Meta's Conversions API each time a lead advances. This is what lets Meta's "Conversion Leads" optimization learn which ads produce leads that convert on the phone — not just leads that submit a form.

StageSent whenDefault event name
Lead receivedThe lead is ingested and a contact is createdlead_received
ContactedA person answers and the call completescontacted
QualifiedPost-call analysis marks the lead qualifiedqualified
ConvertedPost-call analysis marks a conversionconverted

Post-call analysis outcomes map to stages. By default:

Analysis outcomeAdvances to
lead_qualifiedQualified
appointment_setConverted
sale_completedConverted

Customizing the mapping

Both mappings are configurable per integration:

  • Event names — rename a stage's event (for example, send Qualified as sales_qualified) so it matches the events you defined in Meta Events Manager. Set an event name to empty to stop sending that stage.
  • Outcomes — remap which post-call analysis outcomes advance a lead to which stage.

Dataset and token settings

SettingDescription
Dataset (pixel) IDThe Events Manager dataset that receives the events. Clearing it disables feedback.
CAPI access tokenA dataset-scoped Conversions API token. Preferred over the connection's user token because dataset tokens don't expire. Stored encrypted; never returned.
Test event codeAn Events Manager Test Events code. While set, events route to the Test Events tab so you can verify the setup before going live.
CRM nameThe source name shown in Events Manager for these events. Defaults to Talkif.

Events are deduplicated by lead and stage, so a retried or re-reported stage is never double-counted in Meta.

On this page