Como funciona
O problema do WhatsApp é que ele é uma caixa preta: a pessoa sai do anúncio e cai numa conversa que o Google não enxerga. A solução é passar o clique por um endereço nosso antes, guardar quem era, e devolver essa informação depois que a conversa virar negócio.
Clique no anúncio
O Google acrescenta o GCLID à URL e envia a pessoa para um endereço do Dialogy.
Registro do clique
O Dialogy grava GCLID, campanha, grupo, criativo e palavra-chave, e gera um código único.
Redirecionamento
A pessoa cai no WhatsApp com a mensagem já preenchida, contendo o código.
Casamento
Quando a mensagem chega, o Dialogy liga aquela conversa ao clique que a originou.
Conversão de volta
A conversa, o lead qualificado e a venda voltam ao Google com o GCLID e o valor real.
Por que isso é melhor que um pixel: o GCLID é capturado no servidor, no instante do clique. Não depende de cookie, não é bloqueado por extensão e não some quando a pessoa troca de aparelho. A ligação entre anúncio e venda é registrada, não estimada.
O que quebra em silêncio
Leia esta seção antes de configurar qualquer coisa. São quatro pontos que, se estiverem errados, fazem a integração parecer funcionar enquanto nenhuma conversão chega ao Google.
Codificação automática (auto-tagging) desligada
Sintoma: Nenhum GCLID é capturado. O rastreio fica cego mesmo com tudo o mais correto.
Correção: No Google Ads: Administrador → Configurações da conta → Codificação automática. Precisa estar ativada.
Ação de conversão do tipo errado
Sintoma: O envio é recusado com erro de tipo inválido, e a conversão nunca aparece no relatório.
Correção: A ação precisa ser criada como Importar → Upload manual via API. Uma tag de site não aceita upload de cliques.
Token de desenvolvedor sem aprovação
Sintoma: Toda chamada volta com DEVELOPER_TOKEN_NOT_APPROVED.
Correção: No API Center do Google Ads, confirme se o acesso é Básico ou Padrão. Tokens novos só funcionam em contas de teste.
Janela de conversão curta demais
Sintoma: Vendas que demoram a fechar são recusadas por estarem fora do prazo.
Correção: Toda ação nasce com 30 dias. Em Metas → a ação → Editar configurações → Janela de conversão de cliques, escolha 90 dias. As opções são fixas: 1, 3, 7, 30 ou 90.
Conversões otimizadas para leads não habilitadas
Sintoma: O upload é recusado mesmo com a ação de conversão do tipo certo.
Correção: O Google exige que a conta tenha optado por conversões otimizadas para leads e aceito os termos de dados do cliente antes de aceitar uploads com identificadores.
Acesso à API
uma vez por instalaçãoEsta parte é feita uma única vez, por quem administra o Dialogy. Depois disso, qualquer workspace conecta a própria conta sozinho, pelo botão da tela. Se você é usuário e só quer ligar a sua conta, pode pular para a seção seguinte.
Criar o cliente OAuth
No Google Cloud Console, em APIs e Serviços → Credenciais, crie um ID do cliente OAuth do tipo Aplicativo da Web.
Autorizar o endereço de retorno
Ainda na tela do cliente OAuth, em URIs de redirecionamento autorizados, adicione o endereço do seu domínio terminando em /api/integrations/google-ads/callback.
Habilitar a API
Em APIs e Serviços → Biblioteca, ative a Google Ads API para o projeto.
Obter o token de desenvolvedor
Em Ferramentas e configurações → Configuração → Central de API. Atenção: essa tela só existe em contas gerenciadoras (MCC). Se a sua conta é individual, será preciso vinculá-la a um MCC antes, porque contas individuais não emitem token.
Pedir aprovação do token
Um token novo nasce com acesso apenas a contas de teste. Solicite o nível Básico pela própria Central de API, senão as chamadas contra a conta real serão recusadas. Desde o início de 2026 a fila de análise do Google está mais longa e inclui verificação do anunciante, então peça com antecedência.
Os dois passos destacados são os que mais causam dor de cabeça: sem o endereço de retorno autorizado o botão de conectar falha, e sem a aprovação do token toda chamada à conta real é recusada. Os dois erros aparecem só depois, na hora de usar.
Configurar no Dialogy
A tela da integração é um passo a passo. Cada etapa só libera a seguinte, então basta seguir de cima para baixo.
Conectar a conta do Google
Na tela da integração, clique em Conectar com o Google e autorize o acesso. O Dialogy guarda a autorização criptografada. Você não precisa copiar nenhum token.
Se o botão devolver erro, o endereço de retorno ainda não foi autorizado no Google Cloud Console. Veja a seção de solução de problemas.
Escolher a conta de anúncios
O Dialogy lista as contas que a sua autorização alcança. Escolha aquela onde as campanhas rodam.
Só preencha Conta gerenciadora (MCC) se a conta escolhida estiver sob um gerenciador. Fora isso, deixe em Nenhuma.
Mapear as conversões
Cada evento do Dialogy vira uma ação de conversão no Google. A lista aparece pronta, buscada da sua conta.
Mensagem recebida é obrigatória. Lead qualificado e Venda fechada são o que fazem o Google buscar qualidade em vez de volume.
Criar os links dos anúncios
Crie um destino por campanha ou por número de atendimento. O Dialogy gera a URL pronta com todos os parâmetros.
Copie a URL e cole no campo de URL final do anúncio. Não use link direto do wa.me nos anúncios que precisam de atribuição.
Criar as conversões no Google Ads
Esta é a parte que mais dá errado. A ação de conversão precisa ser de importação por clique. Se você criar uma tag de site, o Dialogy não conseguirá enviar nada, e o erro só vai aparecer depois.
- 1No Google Ads, abra Metas no menu lateral.
- 2Entre em Conversões e depois em Resumo.
- 3Clique em Nova ação de conversão.
- 4Escolha Importar, e não Site nem App.
- 5Selecione Outras fontes de dados ou CRM.
- 6Marque Monitorar conversões de cliques. Esta é a escolha decisiva: sem ela o upload por API é recusado.
- 7Dê um nome claro, como Dialogy · Mensagem recebida.
- 8Em Categoria, use Lead para os dois primeiros eventos e Compra para Venda fechada.
- 9Em Valor, escolha Usar valores diferentes para cada conversão quando for Venda fechada.
- 10Em Janela de conversão de cliques, escolha 90 dias, principalmente na de Venda fechada. O padrão é 30, as opções são fixas (1, 3, 7, 30 ou 90) e uma venda que fecha no dia 45 seria recusada mesmo estando corretamente atribuída aqui.
- 11Salve e repita para cada um dos três eventos que você for usar.
Espere de 4 a 6 horas entre criar a ação e o primeiro envio. Esse é o prazo que o próprio Google indica: enviar antes disso pode fazer a conversão levar até 2 dias para aparecer nos relatórios.
Os três eventos, e por que os dois últimos importam
O Dialogy sabe enviar três conversões diferentes. Configurar só a primeira funciona, mas desperdiça a maior parte do valor.
Mensagem recebida
Obrigatória- Quando dispara
- A pessoa manda a primeira mensagem no WhatsApp.
- Valor enviado
- Valor fixo de 1.
- Efeito no leilão
- É o sinal mais raso: quase equivale ao clique. Sozinho, ensina o Google a comprar volume, não qualidade.
Lead qualificado
Recomendada- Quando dispara
- O contato avança do primeiro estágio do funil no CRM.
- Valor enviado
- Valor fixo de 1.
- Efeito no leilão
- Separa quem só mandou um oi de quem tem perfil real. É o primeiro filtro de qualidade.
Venda fechada
Recomendada- Quando dispara
- Um negócio é marcado como ganho no CRM.
- Valor enviado
- O valor real do negócio.
- Efeito no leilão
- É o sinal mais forte que existe. Com ele o Google passa a otimizar por receita, não por contagem de leads.
Correção automática de valor: se o valor do negócio mudar depois de fechado, o Dialogy envia a correção ao Google. Se o negócio for reaberto ou cancelado, envia a retratação. Você não precisa fazer nada.
Colocar a URL no anúncio
Cada destino criado no Dialogy gera uma URL própria. Copie pelo botão da tela e cole no campo de URL final do anúncio. As chaves entre colchetes são substituídas pelo próprio Google no momento do clique.
Repare que a URL pede três identificadores diferentes. O gclid é o normal. Os outros dois, gbraid e wbraid, aparecem no lugar dele quando o clique vem do iOS, onde as restrições de privacidade da Apple impedem o identificador tradicional. Manter os três garante que o rastreio não perca metade do tráfego mobile.
https://app.dialogy.com.br/t/wpp/WORKSPACE_ID/zap7?dest=pmax-palmas&utm_source=google&utm_medium=cpc&utm_campaign={campaignid}&gclid={gclid}&gbraid={gbraid}&wbraid={wbraid}&adgroupid={adgroupid}&creative={creative}&keyword={keyword}&device={device}&matchtype={matchtype}Não use wa.me direto no anúncio quando precisar de atribuição. O link direto pula o registro do clique, e nenhuma conversão conseguirá ser ligada à campanha depois.
Como não perdemos a origem
O texto do WhatsApp é editável, e parte das pessoas apaga o código antes de enviar. Por isso existem três camadas, da mais precisa para a mais tolerante.
Código na mensagem
DeterminísticoA mensagem pré-preenchida leva um código curto. Quando ele chega, a ligação entre clique e conversa é certa, sem estimativa.
Clique recente
ProbabilísticoSe a pessoa apagar o código antes de enviar, o Dialogy casa a conversa com o clique mais recente ainda não usado daquele mesmo número, dentro de uma janela curta.
Dados do contato com hash
Rede de segurançaJunto de cada conversão vão o telefone e o e-mail convertidos em hash SHA-256. O Google usa isso para recuperar a atribuição quando o GCLID se perdeu.
Na conversa, um ícone pequeno do Google Ads aparece no canto do avatar. Passando o mouse, você vê a campanha e se a origem foi confirmada pelo código ou inferida pelo clique recente.
Medir e criar públicos
Com a conta conectada, o Dialogy deixa de só empurrar conversão e passa a trazer dados do Google de volta. São dois recursos que só funcionam depois que a conexão está de pé.
Custo, CAC e ROAS por campanha
Na própria tela da integração, ao final.
O custo vem do Google Ads e a receita vem dos negócios ganhos no CRM. Escolha o período e clique em Carregar. É o único lugar onde as duas pontas aparecem juntas: quanto cada campanha custou e quanto ela devolveu.
Públicos de Customer Match
No CRM, ao selecionar uma lista.
O botão Sincronizar com Google Ads envia os contatos daquela lista direto como público, sem CSV. Serve para criar públicos semelhantes ou excluir quem já é cliente das campanhas de aquisição.
Desde 1º de abril de 2026 o Google recusa chamadas de Customer Match de tokens que nunca fizeram esse tipo de requisição antes. Se a sua conta é nova nesse recurso, fale com o suporte do Google Ads para liberar.
Como ler o ROAS: a receita é apurada por contato. Se o mesmo cliente clicou em duas campanhas diferentes, o valor dele aparece nas duas. Isso infla o total quando somado. Use os números para comparar campanhas entre si, e não como fechamento contábil.
Validar a configuração
Faça este teste antes de subir verba. Ele leva alguns minutos e mostra se cada elo da corrente está funcionando.
Abra a URL numa aba anônima
Você deve ser redirecionado ao WhatsApp com a mensagem preenchida e um código no formato DGY-XXXXXXXX.
Envie a mensagem sem apagar o código
No inbox do Dialogy, a conversa deve aparecer na instância certa, com o ícone do Google Ads no canto do avatar.
Confira o registro do clique
Na tabela ad_clicks deve existir uma linha nova. Atenção: o campo gclid precisa conter algo longo começando com Cj0K ou EAIa.
Se aparecer literalmente {gclid}, o clique não veio de um anúncio real ou a codificação automática está desligada.
Acompanhe a fila
No card Saúde das conversões, a contagem em Na fila deve subir e migrar para Enviadas em até um minuto.
Confirme no Google Ads
A conversão aparece no relatório do Google entre 3 e 24 horas depois do envio. Não é instantâneo.
Solução de problemas
| Sintoma | Causa provável | O que fazer |
|---|---|---|
O botão Conectar com o Google devolve erro | O endereço de retorno não está autorizado. | No Google Cloud Console, em APIs e Serviços → Credenciais → seu cliente OAuth, adicione o endereço de retorno do seu domínio, terminando em /api/integrations/google-ads/callback. |
A lista de contas aparece vazia | A autorização foi feita com um usuário sem acesso à conta de anúncios. | Desconecte e conecte novamente usando um usuário Google que tenha acesso à conta no Google Ads. |
A lista de conversões aparece vazia | A conta ainda não tem ação de conversão, ou o token de desenvolvedor não foi aprovado. | Crie as ações seguindo a seção anterior. Se elas existem e mesmo assim não aparecem, verifique o nível de acesso do token no API Center. |
gclid gravado como {gclid} | A URL foi aberta fora de um anúncio, ou a codificação automática está desligada. | Ative a codificação automática e teste clicando num anúncio de verdade. O Dialogy ignora esses valores e não os envia ao Google. |
Conversões ficam paradas em Na fila | O processo que envia as conversões não está no ar. | Confirme com a equipe técnica se o serviço worker-google-ads está rodando. |
Conversões aparecem em Descartadas | O Google recusou o envio de forma definitiva. | A mensagem exata do erro aparece no card Saúde das conversões, em Últimas falhas. Ela costuma apontar o tipo errado de ação ou janela de conversão vencida. |
A conversa não mostra o ícone do Google Ads | A mensagem chegou sem o código e fora da janela do casamento por proximidade. | Deixe a mensagem inicial curta, para reduzir a chance de a pessoa apagar o código antes de enviar. |
Privacidade e dados pessoais
A declaração de consentimento fica desligada por padrão porque é uma decisão de compliance da sua empresa, não nossa. Ative apenas se a sua política de privacidade cobrir o compartilhamento desses dados com o Google.
Glossário
Referências oficiais
Pronto para configurar
Abra a integração e siga as quatro etapas. Leva menos tempo do que ler este guia.