Ads and Meta CAPI

    384 views
    ·
    Updated 11/17/2026

    📈 1. What the Ads section is for

    The Ads section in the side menu shows which Instagram and Facebook ads with a "Send WhatsApp message" button (Click-to-WhatsApp) bring you customers and how much they earn you, and tells Meta which of those customers bought.

    Pick the period at the top: 7, 30 or 90 days, or your own dates in the calendar.

    What you will find in the section

    • CAPI status bar: whether sales are being sent to Meta, when the last event went out and how many events Meta accepted for the period. Event log shows every event with its amount and status, Settings opens the CAPI and lead form setup. If Meta rejects the data, the bar turns red and shows the reason.
    • Key figure tiles: enquiries from ads and the change versus the previous period, how fast you reply, sales and the average order value, how many events were sent to Meta.
    • Cards below the tiles: revenue from ads, reply rate, how many people from ads were left without a reply, sales from customers who wrote to you on their own.
    • Enquiries by day with a dotted line for the previous period of the same length, and the customer journey: came from an ad, we replied, got interested, bought.
    • Ads table: preview, enquiries, replies, sales and revenue for each ad. Filters by format (video, photo, posts) and by channel, labels "Best", "Few sales" and "No sales", and export of the table to Excel.
    • Where customers write from: customer countries based on the phone number.

    Every figure and column has an "i" icon. Hover over it or tap it on your phone to see how the figure is calculated.

    🔗 2. How CAPI works

    Meta sees that a person clicked your ad and wrote to you. Whether they bought, Meta does not know. The Conversions API (CAPI) tells it:

    1. The customer clicks the ad and writes to your official WhatsApp channel.
    2. The ad click ID ctwa_clid arrives with the first message, and WazzaBee stores it.
    3. The outcome of the conversation is marked in the chat, in a CRM or via the API (all options are in section 4).
    4. WazzaBee sends the event to Meta together with the click ID, and for a sale also the amount.
    5. Meta sees what kind of people buy and shows your ads to people like them.

    Only customers who came from a "Send WhatsApp message" ad to an official WhatsApp channel are sent to Meta. Enquiries that did not come from ads are not sent.

    ⚙️ 3. How to connect

    Open the Ads section and click Connect in the CAPI status bar (if CAPI is already connected, click Settings). In the settings that open, click Connect on the Sales in Meta card. The "Connect conversions" window opens with three steps.

    Step 1. Channel and Facebook sign-in

    1. Choose the channel.
    2. Click Connect with Facebook. Facebook will open: choose your business and the WhatsApp account with this channel's number. You do not need to enter any IDs or tokens.

    If the number exists in several WhatsApp accounts, for example after it was migrated, WazzaBee picks the account where the number is currently connected.

    Step 2. Details and what to send

    If you prefer not to sign in with Facebook, click Connect manually with a token and fill in the fields:

    • Dataset ID: optional. Leave it empty and we will get it from Meta using the WhatsApp account.
    • WhatsApp Business account ID: digits only. You will find it in Business Manager, in the WhatsApp accounts section.
    • Access token: a system user token with the whatsapp_business_management and whatsapp_business_manage_events permissions. We store the token separately and never show it in the dashboard.

    The What to send block has two switches:

    • Sales: a Purchase event with the amount and currency.
    • Qualified leads: a QualifiedLead event.

    Click Save.

    Step 3. Check

    • Check access asks Meta whether it can see your dataset and sends nothing.
    • Send a test event works with the test event code from Events Manager, Test Events tab. The event appears in that tab and does not get into your reports.

    Click Done. The Sales in Meta card will show the "Active" status.

    Only outcomes marked after you connect are sent. Pending events go to Meta every five minutes.

    🧭 4. Where sales come from

    You can mark the outcome in any of the ways below. Each event for a conversation goes to Meta once: marking it again will not create a duplicate.

    💬 Marking in the WazzaBee chat

    The agent clicks the button next to the customer's name and chooses how the conversation ended: Sale with the amount, or Qualified lead. "Declined" and "No reply" are not sent to Meta, they are for your own report.

    🤖 WazzaBee CRM

    1. Open the CRM and go to Robots.
    2. Click the column of the final stage, Paid.
    3. Choose or add a robot with the Send the sale to Meta action.
    4. Make sure it is switched on. The robot works only in the Paid stage, fires the moment a deal enters it, and cannot be copied: this keeps purchases in Meta from being doubled.

    🟠 amoCRM

    In the amoCRM connector, open the Sales to Meta tab and the Sales to Meta from amoCRM card. Mark the stages that count as a sale and choose the budget currency. When an agent moves a deal to such a stage, the sale goes to Meta with the deal budget. There is no need to mark the outcome in the chat.

    Conditions: the deal has a budget, and the deal is linked to a contact that has this customer's WazzaBee chat.

    🟦 Bitrix24

    If your agents work in Bitrix24 Open Channels and close deals there, the sale also goes to Meta.

    1. The customer writes to WhatsApp from an ad. WazzaBee stores their ctwa_clid.
    2. The agent chats with the customer in a Bitrix24 Open Channel.
    3. The agent moves the deal to a successful stage (in any pipeline).
    4. WazzaBee takes the amount and currency from the deal, finds the ad conversation by the contact's phone number and sends the sale to Meta with the ctwa_clid.

    How to enable: open the WazzaBee app inside your Bitrix24 at least once. The subscription to deal changes connects by itself, you do not need to reinstall the app.

    Conditions: the deal has an amount, and the deal is linked to a contact with the same phone number the customer used to write on WhatsApp.

    Ad fields in the record. The ctwa_clid click code, the ad ID and link, and the click time are written to the Bitrix24 lead and deal for free, even without a CAPI subscription. The list of fields is in "Connecting Bitrix24".

    🔌 Your own CRM via the API

    If you have your own CRM, it can report the outcome itself with the POST /v1/outcomes method: sale with the amount, or qualified. See "Deal outcomes: sending sales to WazzaBee".

    📝 5. Meta lead forms

    Deal stages from Facebook and Instagram lead forms are set up separately, in the amoCRM or Bitrix24 connector: "Meta lead forms and CRM: deal stages to your pixel".

    💳 6. Pricing

    • $58 per month, no limit on events. One subscription covers all of CAPI: sales from "Send WhatsApp message" ads and lead forms from amoCRM and Bitrix24.
    • 7 days free.
    • 10% off when you pay for six months, 20% off for a year.

    You can pay in the Ads section: click Settings in the CAPI status bar, then click Pay or Pay by invoice in the CAPI: sales from your CRM to Meta block.

    Tokens are stored separately and never shown in the dashboard.


    📊 7. Where to see events and how to use them

    Where to see them. WhatsApp sales go to the dataset of your WhatsApp account. Meta creates it on connection, it is usually called "Business name Event Data". This is not your website pixel.

    1. Marks are sent to Meta every five minutes.
    2. Events Manager → that dataset → Overview tab. The Purchase or QualifiedLead event appears within 30 minutes. Make sure today is included in the date range at the top.
    3. In Ads Manager the purchase and its value appear on the ad the customer came from, usually within a day.

    How to use them.

    • See which ad sells. In Ads Manager add the "Purchases" and "Purchase conversion value" columns and compare ads by revenue, not by cost per conversation.
    • Train ads on buyers. A campaign with the "Sales" objective where conversations happen in WhatsApp and the purchase event comes from this dataset. Meta looks for people similar to those who paid. Mark sales regularly so the algorithm has data to learn from.
    • Audiences. You can build an audience of buyers in Meta and show ads to people like them.

    Meta sometimes renames buttons in Ads Manager and Events Manager. If you cannot find something, contact WazzaBee support.