You connect your CRM to Meta's Conversions API for CRM. Every time a lead from a Facebook or Instagram form moves to a new stage in your pipeline, such as Potential, Meeting Scheduled or Done Deal, the CRM sends that stage back to Meta with the lead's ID. Meta then learns which kind of person actually becomes a buyer, and with the Conversion Leads goal it shows your ads to more people like them. In Whispyr AI, a real estate CRM, this is called Conversion Reporting. You paste two values from Meta, confirm, and every stage of your pipeline is sent from then on.
This page covers why it matters, what Meta asks for, how to set it up in Whispyr, and what to expect in the first month. Checked on 3 November 2026.
Why form leads get worse over time
Meta's lead ads learn from what you tell them. If the only thing Meta ever hears is "someone filled the form", it gets very good at finding people who fill forms. That can mean people who tap on every ad, and wrong numbers. Your cost per lead looks great, and your agents spend the day on calls that go nowhere.
Sending the status back changes the signal. Meta stops hearing "a form was filled" and starts hearing "this one became a meeting" and "this one became a deal".
What Meta asks for
Meta's own guide to the Conversions API for CRM (updated 27 October 2026) lists the conditions for the optimization to work well:
- You use Facebook or Instagram lead ads (Instant Forms).
- Your CRM stores Meta's lead ID for each lead.
- You generate at least 200 leads a month.
- You can upload data at least once a day.
- The stage you want to optimize for happens within 28 days of the lead arriving.
- That stage converts between 1% and 40% of leads.
Meta estimates about 3 to 4 weeks from setup to full results, most of it a learning period that Meta runs on its side.
For a brokerage, the last two points decide which stage to optimize for. Check your own numbers. If fewer than 1% of your form leads reach "Done Deal", or deals take longer than 28 days, choose an earlier stage such as "Potential" or "Meeting Scheduled".
How it works in Whispyr
Whispyr already pulls your Meta form leads in with Meta's lead ID on each one. Conversion Reporting sends the other direction:
- Every stage, automatically. Each time a lead enters a stage, Meta receives an event named after that stage in English. There are no events to map.
- Your stage names. Every company starts with these stages: New Lead, Potential, Meeting Scheduled, Meeting Completed, Expression of Interest (EOI), Reserved, Done Deal, Lost Lead, Unreachable, Unqualified and Future Contact. A stage you add sends its own name.
- Deal value. When a deal is closed with a value, the value and currency go to Meta too.
- Private details protected. Phone numbers and emails are scrambled (hashed) before they leave Whispyr. Only Meta's own lead ID goes as it is, because Meta needs it to match the lead.
- Sent as it happens. Each stage change is sent when it happens, which covers Meta's "at least once a day".
Set it up in six steps
You need to be a Whispyr admin, with Meta lead ads already connected and receiving leads, and access to the Meta Business account.
- In Meta Business Settings, open Data sources, then Datasets and pixels. Create a dataset for Whispyr, or pick one you have.
- Copy the dataset ID from the dataset's Settings tab in Events Manager.
- Generate an access token on the same Settings tab, and copy it.
- In Whispyr, go to Settings, Integrations, Meta, Conversion Reporting. Paste the dataset ID and the token, and save.
- Review and activate. Confirm that your company has the rights and consents to share these outcomes with Meta. The card then shows Active.
- Optional test. In Events Manager, open Test events, copy the test code, paste it in Whispyr and send. Whispyr uses one of your real Meta leads for the test, because Meta rejects made-up lead IDs.
It does not need Meta App Review.
Then choose the goal in Ads Manager
Sending events is half the job. In your next lead campaign, choose the Conversion Leads performance goal and pick the stage you want more of, such as Potential or Meeting Scheduled. Meta's guide notes this goal works with Instant Forms only.
Keep the signal clean
What you send is only as good as how your agents use the stages:
- Move leads honestly. If agents mark everyone "Potential" to look busy, Meta learns to find more of the wrong people.
- Use Lost Lead and Unqualified. They tell Meta what to avoid.
- Don't rename stages casually. Renaming a stage renames its event from then on, and campaigns optimizing for the old name stop receiving it. Whispyr warns you on the Pipeline page before you save.
Watch what was sent
The same card has a Recent emissions list:
- Sent: Meta accepted it.
- Skipped, no lead ID: the lead did not come from a Meta form, so there was nothing to match.
- Skipped, duplicate: that stage was already sent for that lead.
- Failed: Meta refused it or the request failed. Some rows have a Retry button.
If Meta stops accepting the token, the card shows Needs reconnect. Generate a new token in Meta and save it in Whispyr.
What it costs
Conversion Reporting needs Meta lead ads connected in Whispyr, which is on Growth and Intelligence. Prices from Whispyr's live price list, checked 3 November 2026:
- Growth: EGP 80 a seat a month. 15 agents: EGP 1,200 a month.
- Intelligence: EGP 250 a seat a month, EGP 235 from 10 seats. 15 agents: EGP 3,525 a month.
What it does not do
Conversion Reporting does not run your ads or change your budget. It does not help leads from Google, Property Finder or a Google Sheet, because Meta can only match leads that came from its own forms. And the results take weeks, not days: Meta needs volume and time to learn.
Connect Meta lead ads first, then switch Conversion Reporting on the same day, so every new lead starts teaching Meta from its first stage.