True Conversionsby Nexopath

Como enviar conversões do CRM para o Google Ads — RD Station CRM e webhook (passo a passo)

Este guia mostra como levar as conversões do seu CRM até o Google Ads com o True Conversions, por dois caminhos:

  • RD Station CRM, conexão nativa por token (plano Basic ou superior) — logo abaixo. É o caminho recomendado se você usa RD Station CRM.
  • Webhook manual (mais adiante nesta página) — para qualquer origem sem botão de conexão dedicado: seu próprio software (sem CRM), RD Station CRM no plano Free (sem API), ou qualquer outro CRM não listado.

⚠️ RD Station Marketing ≠ RD Station CRM. São dois produtos diferentes da RD. Este guia é sobre o RD Station CRM (o funil de negócios/vendas). Para o RD Station Marketing (leads e "marcado como oportunidade" via OAuth), veja Conectando o RD Station Marketing.

RD Station CRM — conexão nativa

Use esta seção se sua conta RD Station CRM está no plano Basic ou superior (tem acesso à API). Ela conecta o funil completo do negócio até o Fechado-Ganho — necessário para a Otimização de valor.

Pré-requisitos

  • RD Station CRM no plano Basic ou superior.
  • Uma conta já criada no True Conversions.

Passo 1: Conecte com o token da API

  1. No RD Station CRM, vá em Configurações → Integrações → API e copie o token da API.
  2. No painel do True Conversions, abra a conta (cliente) → Integrações de CRM.
  3. No card RD Station CRM, cole o token no campo Token da API.
  4. Clique em Conectar RD Station CRM.

O True Conversions automaticamente:

  • Valida o token.
  • Registra os webhooks de negócio (crm_deal_created e crm_deal_updated) na sua conta RD Station CRM — nenhuma configuração manual é necessária dentro do RD.
  • Carrega a lista de funis (pipelines) e etapas da conta, usada no próximo passo e na Otimização de valor.

Passo 2: Selecione o funil de vendas

O RD Station CRM envia negócios de todos os funis da conta (vendas, pós-venda, churn, prospecção…) — o True Conversions precisa saber qual é o funil de vendas para não misturar tudo.

Depois de conectar, a seção Funil de vendas aparece no mesmo card:

  • Se os funis já carregaram, escolha o funil correto no menu suspenso.
  • Enquanto nenhum funil for escolhido, um aviso âmbar avisa: "Selecione o funil de vendas — enquanto nenhum for escolhido, negócios de todos os funis são recebidos." Negócios de outros funis (pós-venda, churn etc.) chegam junto até você selecionar.
  • Depois de selecionar, só negócios desse funil são recebidos — os demais são descartados antes mesmo de virar um evento (não aparecem em Eventos recentes nem em Tentativas de webhook).

Se a lista de funis aparecer vazia ("Seus funis ainda não foram carregados"), clique em Reautorizar (veja abaixo) para buscá-los.

O que chega para o True Conversions

  • Sem Otimização de valor ativada (padrão): o True Conversions só recebe o evento quando o negócio é marcado como Fechado-Ganho. Um único evento de conversão por negócio.
  • Com Otimização de valor ativada: o True Conversions passa a receber toda mudança de etapa do negócio dentro do funil selecionado — isso é o que permite enviar um valor diferente em cada etapa (Lead → SQL → Fechado-Ganho) em vez de só um valor no fechamento.

As etapas do negócio (nome + ID estável) já chegam prontas — na página de Otimização de valor elas aparecem como um menu suspenso em vez de texto livre, então renomear uma etapa no RD Station não quebra o roteamento. Veja Otimização de valor.

Capturando o código do clique (gclid / fbc)

Com o script de rastreamento instalado no site (com o token da conta), o código do clique é enviado direto ao True Conversions junto com o email com hash e reunido com o lead quando o webhook chega — sem editar formulários. Opcionalmente, para precisão máxima, os campos ocultos (gclid, fbc, wbraid, gbraid, fbp) podem viajar dentro do próprio lead: o RD Station CRM os herda do RD Station Marketing (campos personalizados do contato/negócio).

Reautorizar

O botão Reautorizar no card do RD Station CRM reaproveita o token já salvo — sem precisar colar de novo — e:

  • Re-registra os webhooks de negócio (corrige registros antigos ou apagados no RD).
  • Atualiza a lista de funis e etapas (necessário depois de criar/renomear etapas no RD, ou se os funis nunca chegaram a carregar).

Desconectando

Clique em Desconectar no card do RD Station CRM. Isso remove o registro da integração no True Conversions. Os webhooks continuam cadastrados no RD Station CRM até serem removidos manualmente lá.

Webhook manual

Use esta seção para conectar qualquer origem que não tenha um botão de conexão dedicado no True Conversions.

Quando usar

  • Seu próprio software / app / sistema, sem CRM — você dispara o webhook direto do seu código quando acontece o evento (cadastro, venda, lead qualificado, etc.).
  • RD Station CRM no plano Free (que não tem API para a conexão nativa da Seção A).
  • Qualquer CRM não listado — HubSpot, Salesforce, uma planilha automatizada, etc.

O mecanismo é sempre o mesmo: você envia um POST com um JSON para a URL de webhook da conta, o True Conversions entende os campos automaticamente, e envia a conversão para o Google Ads.

Passo 1: Copie a URL de webhook

  1. No painel do True Conversions, abra a conta (cliente).
  2. Clique em Integrações de CRM.
  3. No cartão URL de webhook manual (POST), copie a URL. Ela tem o formato:
    https://conversions.nexopath.com/api/webhooks/<token-da-conta>

Essa URL é única por conta — qualquer requisição POST com um corpo JSON enviada para ela vira um evento de conversão. Ela é apenas para ingestão de eventos e tem limite de requisições, então pode ser usada com tranquilidade.

Passo 2: Envie o POST (JSON)

Não existe formato obrigatório — o True Conversions armazena o corpo bruto que você enviar e entende os campos no Passo 3. Dica: dispare um evento de teste primeiro para capturar um payload real.

Exemplo mínimo de payload:

{
  "email": "cliente@exemplo.com",
  "gclid": "Cj0KCQ...",
  "event_name": "cadastro",
  "value": 100,
  "currency": "BRL"
}

Exemplo com curl (para você ou seu desenvolvedor testar):

curl -X POST https://conversions.nexopath.com/api/webhooks/<token-da-conta> \
  -H "Content-Type: application/json" \
  -d '{"email":"cliente@exemplo.com","gclid":"Cj0KCQ...","event_name":"cadastro","value":100,"currency":"BRL"}'

Uma resposta {"received": true} (HTTP 200) confirma que o evento foi recebido.

Como disparar o POST

A) Do seu próprio software (código). Faça uma requisição HTTP POST a partir do seu backend no momento em que o evento acontece (cadastro, venda, lead). Recomendamos disparar pelo servidor (não pelo navegador), para não expor a URL e garantir a entrega.

B) De um CRM. Crie um webhook nas configurações de integração do CRM apontando para a URL do Passo 1, disparando nas mudanças de negócio que você quer rastrear (criação, mudança de etapa, ganho, perdido).

⚠️ Não use duas integrações de RD ao mesmo tempo para o mesmo funil. Se você também tiver o RD Station Marketing conectado por OAuth enviando as mesmas etapas do mesmo negócio, o True Conversions registra as duas fontes como conversões separadas — não há deduplicação entre elas. Ao usar o webhook como fonte do funil, desative os webhooks de Marketing (ou marque as etapas correspondentes como Ignorar na Otimização de valor).

Passo 3: Campos que o True Conversions entende (mapeamento automático)

Se você nomear as chaves do JSON como abaixo, o True Conversions mapeia tudo automaticamente — sem nenhuma configuração manual. Aceita nomes em inglês e português:

Chave (exemplos aceitos) O que é Obrigatório?
email Identificador principal de correspondência Email ou telefone
phone · telefone · celular Identificador de correspondência Email ou telefone
gclid Código do clique do Google Ads — melhora muito a correspondência Fortemente recomendado
value · valor · amount Valor da conversão/negócio Recomendado
currency · moeda Moeda (ex.: BRL) Opcional
event_name · evento Nome do evento/etapa (ex.: "cadastro") Recomendado
deal_id · negociacao_id · opportunity_id ID permanente do negócio — necessário para Otimização de valor Se usar funil
company_name · empresa · razao_social Nome da empresa — ajuda o Enriquecimento de leads Opcional
first_name · nome / last_name · sobrenome Melhoram a correspondência Opcional

Regra: email OU telefone é obrigatório — são os identificadores que as plataformas de anúncios usam para correspondência. Um evento sem nenhum deles (e sem gclid) é recusado pelo Google.

Se suas chaves têm outros nomes ou estão aninhadas (ex.: dados.email), envie um evento de teste e faça o mapeamento manual em Mapeamento de campos. Veja a lista completa de campos em Mapeamento de campos.

Passo 4: Conecte o Google Ads (pré-requisitos)

Para as conversões realmente subirem, siga o guia completo em Conectando o Google Ads — resumo:

  1. Crie uma ação de conversão do tipo Importação, exclusiva para o True Conversions.
  2. Conecte o Google Ads na conta e selecione o Customer ID e a ação de conversão.
  3. Ative "Conversões otimizadas para leads" no Google Ads e aceite os termos de dados do cliente — sem isso, todo envio falha.

O gclid melhora muito a correspondência. Capture-o com o script de rastreamento e envie no payload.

Passo 5 (opcional): Otimização de valor por etapa do funil

Só se a sua origem tem etapas de funil (um negócio que avança: criado → qualificado → … → Fechado-Ganho). Nesse caso, envie um campo de etapa e o deal_id em cada evento, e configure em Otimização de valor: as etapas com seus multiplicadores (%), a etapa de disparo e as etapas de reafirmação até o Fechado-Ganho (100%). Veja Otimização de valor.

Para um evento único e simples (um cadastro, uma venda avulsa, sem funil), pule este passo — o evento é enviado normalmente com o valor que você mandou.

Sem deal_id, as regras de valor não são aplicadas — os eventos continuam sendo enviados, só que sem os multiplicadores por etapa.

Verificando

Depois de configurar, dispare um evento de teste e acompanhe em Eventos recentes (na página da conta) — cada evento mostra o status, o valor enviado e o resultado da entrega ao Google Ads. Para consultar o histórico com filtro por data e exportar em CSV, use o botão Ver todos.

Clique em uma linha para expandir e ver a seção Dados recebidos — todos os campos que chegaram no webhook, campo a campo. É a forma mais rápida de confirmar que o mapeamento automático pegou os campos certos.

Eventos recentes e Ver todos só mostram entregas reais (enviadas ou com falha) — um evento ignorado pela Otimização de valor (etapa não configurada, ou sem deal_id) não aparece em nenhuma das duas listas. Veja Otimização de valor.

Se o webhook não estiver chegando, a seção Tentativas de webhook recentes na página de Integrações de CRM mostra as últimas requisições recebidas — inclusive as rejeitadas — o que ajuda a diferenciar "o software não está enviando" de "está enviando, mas algo está sendo rejeitado". Veja Como verificar para o passo a passo completo.