---
title: "Integração Bitrix24"
description: "Aprenda a conectar o OneClick Tracking ao Bitrix24 CRM para registrar como conversão os negócios que chegam às etapas do pipeline que você escolher."
---

> Aprenda a configurar o OneClick Tracking no Bitrix24 CRM.

O **OneClick Tracking** registra como conversão os negócios do seu Bitrix24 que chegam às etapas do pipeline que você escolher, e liga cada um ao anúncio da Meta que trouxe o cliente. Assim o CPA e o ROAS das suas campanhas passam a refletir as vendas reais do seu time comercial.

A integração funciona com o **Bitrix24 em nuvem** (endereços `suaempresa.bitrix24.com.br`, `.com` e demais domínios do Bitrix24). Portais em domínio próprio e o Bitrix24 instalado em servidor próprio (on-premise) não são suportados.

---

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

## Antes de começar: as UTMs no Bitrix24

Os negócios do Bitrix24 têm campos próprios para UTMs (`UTM_SOURCE`, `UTM_MEDIUM`, `UTM_CAMPAIGN`, `UTM_CONTENT` e `UTM_TERM`). Os **formulários de CRM** e os **widgets do site** do Bitrix24 preenchem esses campos com as UTMs da visita. O OneClick também lê campos personalizados do negócio com esses nomes (por exemplo, `UF_CRM_UTM_SOURCE`).

Um negócio criado à mão ou por uma conversa do WhatsApp chega sem UTMs: ele continua no seu Bitrix24 normalmente, mas não vira conversão rastreada, porque não há anúncio ao qual atribuí-lo.

---

## Como Plugar o OneClick Tracking no Bitrix24

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 "Bitrix24" e clique em Continuar.

6. Cole a **URL do webhook de entrada** do Bitrix24 e clique em Conectar.
   a. No Bitrix24, abra **Aplicativos** > **Recursos para desenvolvedores** > **Outros** > **Webhook de entrada** (Inbound webhook).
   b. Em **Permissões**, marque **CRM (crm)** e salve.
   c. Copie a URL que o Bitrix24 mostra, no formato `https://suaempresa.bitrix24.com.br/rest/1/abc123.../`. Essa URL funciona como uma senha: não a compartilhe.
   d. Crie o webhook com um usuário que enxerga todos os negócios do pipeline: o OneClick lê os negócios com as permissões desse usuário.

7. Escolha **quais etapas contam como conversão**.
   a. O OneClick lista os pipelines de negócios do seu Bitrix24 e as etapas de cada um.
   b. Marque as etapas que representam uma conversão real para o seu negócio (por exemplo, "Proposta enviada" ou "Negócio fechado").

8. 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)

   8.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)

9. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas automaticamente para dentro do card de leads gerados.
   a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site.

10. 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)

11. 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)

11. Copie a **URL do Webhook** gerada pelo OneClick e crie, no Bitrix24, o webhook que avisa o OneClick quando um negócio muda:

    11.1. No Bitrix24, abra **Aplicativos** > **Recursos para desenvolvedores** > **Outros** > **Webhook de saída** (Outbound webhook).

    11.2. No campo **URL do manipulador** (Handler URL), cole a URL do Webhook do OneClick.

    11.3. Em **Eventos**, marque **Negócio atualizado** (`ONCRMDEALUPDATE`) e **Negócio criado** (`ONCRMDEALADD`), e salve.

    :::note[O aviso traz só o número do negócio]
    O Bitrix24 avisa o OneClick apenas que um negócio mudou. O OneClick então lê o negócio pelo webhook de entrada do passo 6 para saber a etapa, o valor e as UTMs. Por isso os dois webhooks precisam continuar ativos.
    :::

---

## Notas Importantes

- Cada etapa que você escolheu conta **uma vez por negócio**: o mesmo negócio editado de novo na mesma etapa não gera conversão duplicada. Se você escolher mais de uma etapa, um negócio que passar por todas conta uma vez em cada.
- No Bitrix24, "ganho" e "perdido" também são etapas: conta como conversão a etapa que você marcar no passo 7.
- O valor registrado é o **valor do negócio** (campo Oportunidade), na moeda do negócio.
- A data da conversão é o momento em que o negócio entrou na etapa.
- Se apagar ou recriar o webhook de entrada no Bitrix24, reconecte a integração no OneClick com a URL nova.

---

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