---
title: "LíderHub Integration"
description: "Learn how to connect OneClick Tracking to LíderHub with a Custom Tool to attribute the leads from your click-to-WhatsApp campaigns to your Meta Ads campaigns."
---

> Learn how to set up OneClick Tracking in LíderHub.

**OneClick Tracking** is a feature for Meta Ads advertisers who handle WhatsApp leads with **LíderHub**'s AI agents. It links each lead to the campaign, ad set and ad that generated it, delivering immediate and accurate conversion tracking.

This solution **corrects wrong attributions made by Meta**, delivering **real data** and enabling safer scaling decisions.

LíderHub knows which click-to-WhatsApp ad each conversation came from. With a **Custom Tool**, the AI agent sends that information to OneClick Tracking at the moment you define in the prompt (for example, when the lead is qualified).

---

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

## How to Plug OneClick Tracking into LíderHub

1. Log in to your OneClick Ads account.
2. Go to the "OneClick Tracking" tab, available in the left sidebar of [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking).

   ![The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card](../../../../../public/oneclick-tracking/common/image-1.png)

3. Click "New Integration".

4. Select the "Lead Generation" product type and click Continue.

5. Select the "LíderHub" platform and click Continue.

6. Copy the Webhook URL generated by OneClick and register it in LíderHub as a Custom Tool following the steps below:
   a. Each ad account gets a unique link, generated automatically.
   b. This link is what connects your ad account to LíderHub.

   6.1. In LíderHub, go to **Configurações → Integrações → Custom Tool** (Settings → Integrations → Custom Tool) and click **Nova Chamada Personalizada** (New Custom Call).

   6.2. In **Nome da chamada** (Call name), use a short name such as `registrar_conversao_oneclick`. The agent triggers the tool by this name (`@ação`).

   6.3. In **URL do endpoint** (Endpoint URL), paste the tracking URL provided by OneClick.

   6.4. In **Tipo de requisição** (Request type), choose **POST**.

   6.5. Turn on **Body da requisição** (Request body) and, in the **JSON Schema**, ask only for what describes the conversion, for example a field `etapa` described as "The stage the lead is at". There is no need to ask for name, phone or document: LíderHub already sends, on every call, the identification of the ad the conversation came from.

   6.6. Click **Criar Chamada** (Create Call).

   6.7. In the AI agent's prompt, say when to trigger the tool with the `@ação`, for example: "When the lead is qualified, trigger @registrar_conversao_oneclick". Each lead is counted only once, so it is fine if the agent triggers the tool more than once in the same conversation.

   :::caution[SCALE plan]
   Custom Tools are available on LíderHub's **SCALE** plans.
   :::

7. Copy the UTM Script generated in OneClick Tracking.

   ![The UTM parameters step of OneClick Tracking, with the parameter to copy](../../../../../public/oneclick-tracking/common/image-2.png)

   7.1. Paste it into the "URL parameters" field in ALL of your ads in Ads Manager, as shown below:

   ![The URL parameters field of an ad in Meta Ads Manager](../../../../../public/oneclick-tracking/common/image-3.png)

:::note[Click-to-WhatsApp campaigns]
On ads that lead straight to WhatsApp, LíderHub already reports which ad each conversation came from, so the **UTM Passthrough Script** is not needed.
:::

8. Set the Attribution Mode.
   - [Watch this video](https://www.youtube.com/watch?v=JgWkvv4ZNLY) to understand each model.
   - Click Continue.

   ![The Attribution Mode step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-4.png)

9. Set the Naming Convention that your campaigns, ad sets and ads will receive in your Ads Manager and click next.

:::caution[Campaign renaming depends on processed conversions]
The naming set here **will only be applied to the campaign name in Ads Manager once there is at least 1 processed conversion**. Receiving raw webhook data from the integrated platform is not enough — the system must have structured the conversion and attributed it to a campaign. If the webhook is arriving but the campaign name hasn't changed yet, wait for the first conversion to be recorded.
:::

![The Campaign Naming step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-5.png)
![Analysis periods and the Naming Convention preview](../../../../../public/oneclick-tracking/common/image-6.png)

---

## Done!

Wait at least 24 hours for the setup to take effect, and all your campaigns (those that receive conversions) will start recording conversions right inside Ads Manager.

![Campaigns with the OneClick Tracking prefix in Ads Manager](../../../../../public/oneclick-tracking/common/image-7.png)

---

## Important Notes

- **Integration in testing.** LíderHub has not published a complete example of a Custom Tool delivery yet. OneClick reads the attribution data LíderHub documents, and our team checks the first deliveries received. Deliveries are stored from the very first minute, so no lead is lost while the mapping is adjusted.
- A lead is recorded as a **conversion with no value**: OneClick Tracking counts the volume of leads, on the date the agent triggered the tool.
- **The conversion moment is what the prompt defines.** OneClick records the lead when the agent triggers the Custom Tool; if the prompt does not ask for it, nothing is sent.
- A lead is attributed only when the conversation started from a **click-to-WhatsApp ad**. A contact that arrived another way cannot be linked to any campaign.
- Only campaigns created after the setup will have access to the "Maximum Period" data. This does **not** affect OneClick Ads optimization of older campaigns in any way.

---

## References

- [LíderHub Custom Tools](https://docs.liderhub.ai/integracoes/personalizada)
- [CTWA Clid in LíderHub](https://docs.liderhub.ai/integracoes/ctwa-clid)
