PandaChat Integration
OneClick Tracking — PandaChat Integration
What is OneClick Tracking?
Section titled “What is OneClick Tracking?”OneClick Tracking is the OneClick Ads feature that lets you track the real conversions generated by your ads more accurately and reliably.
With PandaChat, the lead arrives through WhatsApp — usually from a Click to WhatsApp ad. When that happens, PandaChat stores with the lead the information about which ad brought it in (the Meta campaign, ad set and ad). That is the data OneClick Tracking uses to link the conversion to the right ad, making your campaigns’ CPA and ROAS much more accurate.
What is a webhook?
Section titled “What is a webhook?”A webhook is a way for one system to automatically send data to another system in real time, whenever a given event happens.
In this integration:
- PandaChat is the one that sends the webhook (with the lead’s data) when the lead moves to a new stage in the funnel.
- OneClick Tracking is the one that receives that data and records the conversion.
How the integration works (overview)
Section titled “How the integration works (overview)”- The lead clicks your Click to WhatsApp ad and starts a conversation.
- PandaChat records the lead and stores the attribution of the ad it came from.
- Inside OneClick Tracking, you connect your PandaChat workspace (with the API key) and choose which funnel stages count as a conversion. This selection happens in OneClick itself, not in PandaChat.
- You send your webhook URL to PandaChat, and they enable delivery for your account (see Step 3 — this step is required).
- When a lead enters one of those stages, PandaChat fires the
lead.stage_changedevent to the OneClick Tracking URL. - OneClick Tracking receives the event, confirms the stage matches what you selected, identifies the ad the lead came from and records the conversion.
The PandaChat funnel
Section titled “The PandaChat funnel”PandaChat uses a fixed funnel of 8 stages, the same for every workspace. The lead moves through them as the conversation progresses:
| # | Stage | Meaning |
|---|---|---|
| 1 | Novo lead (New lead) | Messaged on WhatsApp, not yet qualified |
| 2 | Em atendimento (In service) | AI or an agent is talking to them |
| 3 | Pediu preço (Asked for price) | Reached the price/offer part |
| 4 | Parou após preço (Stopped after price) | Got the price and stopped replying |
| 5 | Interesse alto (High interest) | Asked important details |
| 6 | Dados incompletos (Incomplete details) | Started providing details, something is missing |
| 7 | Aguardando confirmação (Awaiting confirmation) | Provided the details, didn’t confirm |
| 8 | Pedido agendado (Order scheduled) | Order confirmed/scheduled — the conversion |
In most cases the stage that represents the conversion is “Pedido agendado”. You can select more than one stage if it makes sense for your business — for example, also tracking “Interesse alto” as an intermediate signal.
Step 1 — Get the PandaChat API key
Section titled “Step 1 — Get the PandaChat API key”The API key is unique per workspace and is available directly in your PandaChat dashboard — there’s no need to contact support.
- In the PandaChat dashboard, go to the Integração / API (Integration / API) section.
- Under Sua chave de integração (Your integration key), click the eye icon to reveal the key (or use the Copiar (Copy) button to copy it without revealing it).
Keep this key — you’ll paste it into OneClick Tracking in the next step, and it isn’t configured anywhere inside PandaChat.
Step 2 — Connect PandaChat and choose the conversion stages
Section titled “Step 2 — Connect PandaChat and choose the conversion stages”- Open OneClick Tracking inside OneClick Ads.
- Select the corresponding ad account.
- Click New integration (or New tracking).
- Select the “Lead generation” product type and click Continue.
- Select PandaChat as the source platform.
- Paste the API key obtained in Step 1 and click Connect PandaChat.
- Once connected, OneClick Tracking lists your funnel and its 8 stages. Select the stage(s) that represent a real conversion — usually “Pedido agendado”. This selection, made here inside OneClick, is what decides which PandaChat events count as a conversion.
- Click Continue. On the next step, copy the generated webhook URL — you’ll need it in Step 3.
Step 3 — Send your webhook URL to PandaChat
Section titled “Step 3 — Send your webhook URL to PandaChat”This step is required and can’t be done by OneClick. PandaChat has no self-service screen to register webhooks: they enable it themselves, on request, for each workspace.
- Copy the webhook URL generated in Step 2. It is exclusive to your ad account — don’t reuse another account’s URL.
- Send this URL to PandaChat support and ask them to enable delivery of the
lead.stage_changedevent to it. - Wait for confirmation that the webhook has been enabled.
Important Notes
Section titled “Important Notes”- Each ad account has a different webhook URL. If you manage multiple accounts, create a separate integration for each one and send each URL to PandaChat.
- The webhook is fired only when the lead enters a stage, and each lead + stage combination is sent only once. A lead that goes back to an earlier stage and moves forward again does not generate a duplicate conversion.
- A stage you didn’t select in Step 2 is still sent by PandaChat, but OneClick discards it — only the selected stages become conversions.
- For WhatsApp leads, attribution uses PandaChat’s native Click to WhatsApp data, which is more reliable than UTMs. Classic UTMs in PandaChat are only captured on checkout sales, so they may not exist for a lead that came directly through WhatsApp — this is expected and doesn’t prevent tracking.
- A lead that arrived through a channel with no ad attribution at all (for example, someone who saved your number and messaged spontaneously) doesn’t generate a tracked conversion, because there’s no ad to attribute it to.
- After setting up the integration, wait for the next lead to reach the conversion stage to check that the data is arriving correctly in OneClick Tracking.
Expected result
Section titled “Expected result”After setup — and with the webhook enabled by PandaChat — every time a lead advances to the stage you selected, PandaChat will automatically send the data to OneClick Tracking. The system records the conversion and associates it with the Click to WhatsApp ad that brought in that lead, letting you see your campaigns’ real CPA and ROAS directly in OneClick Ads.