---
title: "Integração PipeRun"
description: "Aprenda a conectar o OneClick Tracking ao PipeRun CRM para registrar como conversão as oportunidades que chegam às etapas do funil que você escolher."
---

> Aprenda a configurar o OneClick Tracking no PipeRun CRM.

O **OneClick Tracking** registra como conversão as oportunidades do seu PipeRun que chegam às etapas do funil que você escolher, e liga cada uma 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.

---

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

O PipeRun não tem um campo próprio para UTMs. Para o OneClick saber de qual anúncio veio cada oportunidade, as UTMs precisam estar em **campos customizados da oportunidade**, com estes nomes:

- `utm_source`
- `utm_medium`
- `utm_campaign`
- `utm_content`
- `utm_term`

Crie esses campos no PipeRun e faça o formulário do seu site, ou a ferramenta que cria as oportunidades, preenchê-los. Uma oportunidade sem UTMs continua no seu PipeRun normalmente, mas não vira conversão rastreada, porque não há anúncio ao qual atribuí-la.

---

## Como Plugar o OneClick Tracking no PipeRun

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

6. Cole o **Token da API** do PipeRun e clique em Conectar.
   a. No PipeRun, abra **Meus dados** (ou a tela de **Integrações**) e copie o token que aparece abaixo da sua foto.
   b. Use o token de um **usuário gestor**: só o gestor tem acesso às ações automáticas, que você vai criar no passo 11.

7. Escolha **quais etapas contam como conversão**.
   a. O OneClick lista os funis da sua conta e as etapas de cada um.
   b. Marque as etapas que representam uma conversão real para o seu negócio (por exemplo, "Reunião agendada" ou "Fechamento").

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 PipeRun, a ação automática que envia as oportunidades:

    11.1. Passe o mouse sobre o seu avatar, no canto superior direito, e clique em **Ajustes e configurações**. Na coluna **Ferramentas**, clique em **Ações automáticas** e depois em **+ Adicionar ação**.

    11.2. Dê um nome à ação (por exemplo, "OneClick Tracking"). Em **Qual será o gatilho para ocorrer a ação?**, escolha o gatilho de a oportunidade entrar na etapa. Em **Qual o tipo de ação que deseja realizar?**, escolha **Webhook - Envio de oportunidade para URL**.

    11.3. Em **Neste Funil** e **Nesta etapa do funil**, escolha uma das etapas que você marcou no passo 7. Clique em **Próximo**.

    11.4. No campo **URL**, cole a URL do Webhook do OneClick. Em **Tipo de envio**, deixe **Padrão**. Clique em **Salvar**.

    11.5. Repita os passos 11.1 a 11.4 para **cada etapa** que você marcou no passo 7: no PipeRun, cada ação automática vale para uma etapa.

    :::caution[Mantenha o tipo de envio Padrão]
    O OneClick lê as chaves padrão que o PipeRun envia. No tipo de envio **Avançado**, os nomes das chaves mudam e as oportunidades deixam de ser reconhecidas.
    :::

---

## Notas Importantes

- Cada etapa que você escolheu conta **uma vez por oportunidade**: a mesma oportunidade movida de novo para a mesma etapa não gera conversão duplicada. Se você escolher mais de uma etapa, uma oportunidade que passar por todas conta uma vez em cada.
- Oportunidades **perdidas** ou na lixeira nunca contam como conversão.
- O valor registrado é o valor da oportunidade em produtos e serviços somado a um mês do valor de recorrência (MRR).
- Ações automáticas não são disparadas por importações ou ações em massa no PipeRun: uma oportunidade importada direto na etapa não é enviada.
- Se trocar o token no PipeRun, reconecte a integração no OneClick com o token novo.

---

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