---
title: "PandaChat Integration"
description: "Learn how to connect OneClick Tracking to PandaChat to accurately track WhatsApp lead conversions in your Meta Ads campaigns."
---

OneClick Tracking — PandaChat Integration

:::tip[You can connect several platforms at the same time]
OneClick Tracking lets you connect **more than one platform to the same ad account** at the same time (for example, Hotmart and Eduzz together). Each platform has its own integration — with its own Webhook link or access credential — and they coexist without competing with each other; just repeat the **"New Integration"** steps for each one you want to connect.

Each sale is attributed to the right campaign by its **UTM**, not by the platform. So if one campaign sells through one platform and other campaigns sell through another, each conversion is automatically linked to the campaign it came from, regardless of which platform generated the sale. The recommended setup is **each campaign serving a single platform** — avoid having the same campaign sell on two platforms at once.
:::

## 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?

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)

1. The lead clicks your Click to WhatsApp ad and starts a conversation.
2. PandaChat records the lead and stores the attribution of the ad it came from.
3. 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.
4. You send your webhook URL to PandaChat, and they enable delivery for your account (see Step 3 — **this step is required**).
5. When a lead enters one of those stages, PandaChat fires the `lead.stage_changed` event to the OneClick Tracking URL.
6. 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

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

The API key is **unique per workspace** and is available directly in your PandaChat dashboard — there's no need to contact support.

1. In the PandaChat dashboard, go to the **Integração / API** (Integration / API) section.
2. 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.

:::tip[The key is yours alone and read-only]
According to PandaChat itself, this key grants **read-only** access to your funnels and stages — it doesn't allow changing anything in your account. Don't share it publicly. If you suspect someone has had access to it, generate a new key on the same PandaChat screen and reconnect the integration in OneClick with the new key.
:::

---

## Step 2 — Connect PandaChat and choose the conversion stages

1. Open **OneClick Tracking** inside OneClick Ads.
2. Select the corresponding ad account.
3. Click **New integration** (or **New tracking**).
4. Select the **"Lead generation"** product type and click Continue.
5. Select **PandaChat** as the source platform.
6. Paste the **API key** obtained in Step 1 and click **Connect PandaChat**.
7. 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.
8. Click Continue. On the next step, copy the generated **webhook URL** — you'll need it in Step 3.

:::caution[The key is validated immediately]
If the key is wrong or is no longer accepted by PandaChat, the connection fails right away and nothing is saved. Check the key with their support and try again.
:::

---

## 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.

1. Copy the **webhook URL** generated in Step 2. It is **exclusive to your ad account** — don't reuse another account's URL.
2. Send this URL to PandaChat support and ask them to enable delivery of the **`lead.stage_changed`** event to it.
3. Wait for confirmation that the webhook has been enabled.

:::danger[Without this step, no conversion is recorded]
Until PandaChat enables delivery to your URL, the integration shows as configured in OneClick but **receives nothing** — and OneClick has no way of detecting this on its own. If after a few days you don't see conversions coming in, check with PandaChat support that the webhook was actually enabled for your URL.
:::

---

## 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

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.
