---
title: "Integração LíderHub"
description: "Aprenda a conectar o OneClick Tracking à LíderHub com uma Custom Tool para atribuir os leads das suas campanhas de clique para o WhatsApp às suas campanhas Meta Ads."
---

> Aprenda a configurar o OneClick Tracking na LíderHub.

O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que atendem leads pelo WhatsApp com os agentes de IA da **LíderHub**. Ele conecta cada lead à campanha, ao conjunto e ao anúncio que o originou, entregando um rastreamento de conversões imediato e preciso.

Essa solução **corrige atribuições erradas feitas pela Meta**, entregando **dados reais** e permitindo decisões de escala mais seguras.

A LíderHub sabe de qual anúncio de clique para o WhatsApp veio cada conversa. Com uma **Custom Tool**, o agente de IA envia essa informação ao OneClick Tracking no momento que você definir no prompt (por exemplo, quando o lead é qualificado).

---

:::tip[Você pode conectar várias plataformas ao mesmo tempo]
O OneClick Tracking permite conectar **mais de uma plataforma na mesma conta de anúncios** ao mesmo tempo (por exemplo, Hotmart e Eduzz juntas). Cada plataforma tem a sua própria integração — com o seu próprio link de Webhook ou credencial de acesso — e elas convivem sem competir entre si; basta repetir o passo a passo de **"Nova Integração"** para cada uma que você quiser conectar.

A atribuição de cada venda à campanha certa é feita pela **UTM**, e não pela plataforma. Por isso, se uma campanha vende por uma plataforma e outras campanhas vendem por outra, cada conversão é ligada automaticamente à campanha de origem, independentemente de qual plataforma originou a venda. O cenário recomendado é **cada campanha atender a uma única plataforma** — evite uma mesma campanha vendendo em duas plataformas ao mesmo tempo.
:::

## Como Plugar o OneClick Tracking na LíderHub

1. Acesse sua conta OneClick Ads.
2. Vá até a aba "OneClick Tracking", conforme disponível no menu lateral esquerdo do [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking).

   ![Aba OneClick Tracking no menu lateral do OneClick Ads, com o cartão Nova Integração](../../../../../public/oneclick-tracking/common/image-1.png)

3. Clique em "Nova Integração".

4. Selecione o tipo de produto "Geração de Leads" e clique em Continuar.

5. Selecione a plataforma "LíderHub" e clique em Continuar.

6. Copie a URL do Webhook gerada pelo OneClick e cadastre-a na LíderHub como uma Custom Tool seguindo o passo-a-passo abaixo:
   a. Cada conta de anúncios terá um link único gerado automaticamente.
   b. Esse link é o que conecta sua conta de anúncios à LíderHub.

   6.1. Na LíderHub, acesse **Configurações → Integrações → Custom Tool** e clique em **Nova Chamada Personalizada**.

   6.2. Em **Nome da chamada**, use um nome curto, como `registrar_conversao_oneclick`. É por esse nome que o agente aciona a ferramenta (`@ação`).

   6.3. Em **URL do endpoint**, cole a URL de rastreamento fornecida pelo OneClick.

   6.4. Em **Tipo de requisição**, escolha **POST**.

   6.5. Ative o **Body da requisição** e, no **JSON Schema**, peça apenas o que descreve a conversão, por exemplo um campo `etapa` com a descrição "Etapa do atendimento em que o lead está". Não é preciso pedir nome, telefone ou CPF: a LíderHub já envia, em toda chamada, a identificação do anúncio de origem.

   6.6. Clique em **Criar Chamada**.

   6.7. No prompt do agente de IA, diga quando acionar a ferramenta com a `@ação`, por exemplo: "Quando o lead estiver qualificado, acione @registrar_conversao_oneclick". Cada lead é contado uma única vez, então não há problema se o agente acionar a ferramenta mais de uma vez na mesma conversa.

   :::caution[Plano SCALE]
   A Custom Tool está disponível nos planos **SCALE** da LíderHub.
   :::

7. Copie o Script de UTM gerado dentro do OneClick Tracking.

   ![Etapa de parâmetros UTM do OneClick Tracking, com o parâmetro para copiar](../../../../../public/oneclick-tracking/common/image-2.png)

   7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo:

   ![Campo Parâmetros de URL de um anúncio no gerenciador de anúncios da Meta](../../../../../public/oneclick-tracking/common/image-3.png)

:::note[Campanhas de clique para o WhatsApp]
Em anúncios que levam direto ao WhatsApp, a LíderHub já informa de qual anúncio veio cada conversa, então o **Script de Passagem de UTMs** não é necessário.
:::

8. Defina o Modo de Atribuição.
   - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo.
   - Clique em Continuar.

   ![Etapa de Modo de Atribuição do OneClick Tracking](../../../../../public/oneclick-tracking/common/image-4.png)

9. Defina a Nomenclatura que suas campanhas, conjuntos de anúncios e anúncios receberão dentro do seu gerenciador de anúncios e clique em avançar.

:::caution[A renomeação da campanha depende de conversões processadas]
A nomenclatura configurada aqui **somente será aplicada ao nome da campanha no gerenciador de anúncios quando houver pelo menos 1 conversão processada**. Receber dados brutos do webhook da plataforma integrada não é suficiente — o sistema precisa ter estruturado e atribuído a conversão a uma campanha. Se o webhook está chegando mas o nome da campanha ainda não foi alterado, aguarde a primeira conversão ser registrada.
:::

![Etapa de Nomenclatura de Campanha do OneClick Tracking](../../../../../public/oneclick-tracking/common/image-5.png)
![Períodos de análise e prévia da Nomenclatura](../../../../../public/oneclick-tracking/common/image-6.png)

---

## Pronto!

Aguarde pelo menos 24 horas para que a configuração esteja vigente e todas as suas campanhas (as que receberem conversões) passarão a registrar as conversões dentro do próprio gerenciador de anúncios.

![Campanhas com o prefixo do OneClick Tracking no gerenciador de anúncios](../../../../../public/oneclick-tracking/common/image-7.png)

---

## Notas Importantes

- **Integração em fase de testes.** A LíderHub ainda não publicou um exemplo completo do envio da Custom Tool. O OneClick lê os dados de atribuição que a LíderHub documenta e a nossa equipe confere os primeiros envios recebidos. Os envios ficam guardados desde o primeiro minuto, então nenhum lead se perde enquanto o mapeamento é ajustado.
- Um lead é registrado como **conversão sem valor**: o OneClick Tracking conta o volume de leads, na data em que o agente acionou a ferramenta.
- **O momento da conversão é o que o prompt define.** O OneClick registra o lead quando o agente aciona a Custom Tool; se o prompt não pedir o acionamento, nada é enviado.
- Um lead só é atribuído quando a conversa começou por um **anúncio de clique para o WhatsApp**. Um contato que chegou por outro caminho não pode ser ligado a nenhuma campanha.
- Só campanhas criadas após a configuração terão acesso ao dado de "Período Máximo". Isso **não prejudica** de nenhum modo a otimização do OneClick Ads em campanhas mais antigas.

---

## Referências

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