Dialogy

Visao geral

Clique

O Google envia o usuario para uma URL do Dialogy.

Tracking

O Dialogy salva GCLID, campanha, grupo, criativo e destino.

O usuario e redirecionado para o numero configurado no card.

Conversao

A mensagem real vira evento exportavel para Google Ads.

Pre-requisitos

Uma instancia Evolution API conectada no workspace que recebera as mensagens.

Um numero de WhatsApp de destino em formato internacional, por exemplo 556338104040.

Acesso administrativo ao Google Ads para criar acoes de conversao.

Credenciais Google Ads API configuradas no ambiente do Dialogy.

Conta e conversoes

A primeira parte da tela GADS configura a conta do Google Ads e as acoes de conversao. Esses campos sao compartilhados por todos os cards de destino.

Customer ID

ID da conta Google Ads que recebera as conversoes.

Use apenas numeros, sem hifens. Exemplo: 1234567890.

Login Customer ID

ID do MCC quando a conta e gerenciada por uma conta manager.

Se voce nao usa MCC, deixe em branco.

Mensagem recebida

Acao de conversao principal.

Preencha o resource name da acao no formato customers/ID/conversionActions/ID.

Lead qualificado e Venda fechada

Eventos avancados para melhorar a otimizacao.

Sao opcionais no inicio. Configure quando o CRM ja tiver criterio claro para lead qualificado e venda.

Cards de destino

Cada card representa uma URL de anuncio. Crie cards separados quando quiser medir campanhas, regioes, numeros, unidades ou operacoes diferentes.

Nome do destino

Nome interno para identificar o card, como PMAX Palmas ou Pesquisa Fibra.

Slug da URL

Identificador curto usado em dest=slug. Deve ser unico no workspace.

Instancia Evolution

Instancia que recebera o webhook quando o cliente mandar mensagem.

WhatsApp de destino

Numero que sera aberto no WhatsApp, com DDI e DDD.

Mensagem inicial

Texto pre-preenchido. O Dialogy adiciona o codigo tecnico de tracking automaticamente.

Configurar o anuncio no Google Ads

Esta e a parte mais sensivel da configuracao. O Dialogy precisa dos IDs tecnicos do Google Ads para exportar conversoes offline com precisao. Nao use nome de campanha, nome da conversao ou link direto do WhatsApp nesses campos.

Customer ID

Onde pegar

No Google Ads, clique na foto/perfil no canto superior direito. O ID aparece abaixo do nome da conta. Copie os 10 digitos e cole no Dialogy sem hifens.

Se o Google mostra 123-456-7890, salve 1234567890.

Login Customer ID

Quando preencher

Preencha somente se a integracao/API estiver autenticada por uma conta manager/MCC. Nesse caso, abra o MCC, clique no seletor de contas e copie o ID do manager.

Se a API acessa direto a conta anunciante, deixe em branco.

Mensagem recebida

Conversao principal

Crie uma acao offline para o evento que acontece quando uma conversa real chega pelo WhatsApp. Essa deve ser a primeira conversao enviada pelo Dialogy.

Nome sugerido: Dialogy - Mensagem recebida.

Lead qualificado

Conversao opcional

Use quando o atendimento ou CRM marcar que a pessoa tem perfil real de compra. No inicio, deixe como secundaria ate validar qualidade e volume.

Nome sugerido: Dialogy - Lead qualificado.

Venda fechada

Conversao de valor

Use quando o CRM tiver fechamento confiavel. E o evento mais forte para otimizacao, mas so deve entrar quando a operacao consegue registrar venda sem falha.

Nome sugerido: Dialogy - Venda fechada.

1. Abra a conta correta

Entre no Google Ads pela conta que recebe as conversoes. Se voce usa MCC, primeiro confirme se a acao de conversao fica na conta cliente ou no manager.

2. Copie os IDs da conta

O Customer ID vem da conta anunciante. O Login Customer ID so entra quando a API autentica por uma conta manager/MCC.

3. Crie a conversao offline

Crie uma acao de conversao de importacao por clique. Ela precisa aceitar upload/API, porque o Dialogy enviara a conversao depois que a mensagem chegar.

4. Monte o resource name

O Dialogy nao usa apenas o nome da conversao. Ele precisa do formato tecnico customers/ID_DA_CONTA/conversionActions/ID_DA_ACAO.

Criar a acao de conversao no Google Ads

Para esse fluxo, a conversao precisa ser de importacao/offline por clique. Ela nao e uma tag de site, porque o evento real acontece depois, quando a Evolution API confirma a mensagem recebida.

1No Google Ads, abra Metas ou Goals no menu lateral.

2Entre em Conversoes e depois Resumo.

3Clique em Criar acao de conversao ou Nova acao de conversao.

4Escolha Conversoes offline. Em algumas contas, o caminho aparece como Importar.

5Selecione dados de CRM/outras fontes ou importacao manual via API/uploads.

6Escolha rastrear conversoes de cliques. Nao escolha conversao de site/tag para esse fluxo.

7Crie a acao com categoria Lead para Mensagem recebida e Lead qualificado. Para Venda fechada, use Compra/Venda quando fizer sentido para o negocio.

8Depois de criar a acao, aguarde algumas horas antes do primeiro envio, porque o Google pode demorar para aceitar uploads de uma conversao nova.

Como preencher o resource name no Dialogy

O campo de conversao no Dialogy deve receber o identificador completo da acao de conversao. Esse e o valor que a Google Ads API exige para aceitar o upload.

customers/1234567890/conversionActions/987654321

Abra a acao de conversao criada no Google Ads.

Copie o ID numerico da acao de conversao. Ele aparece na URL da tela da conversao ou pode ser consultado pela Google Ads API.

Monte o valor no formato customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID.

Cole esse valor no campo correspondente do Dialogy. Nao cole apenas o nome da conversao.

Exemplo de URL gerada

Use a URL do card como destino do anuncio.

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}

Referencias oficiais

Google: encontrar o Customer ID Google: conversoes offline com GCLID Google Ads API: upload de conversoes offline

Validar se esta funcionando

Copie a URL de um card e abra em uma aba anonima.

Confirme que o navegador redireciona para o WhatsApp com a mensagem inicial.

Envie a mensagem sem apagar o codigo tecnico DGY.

Abra o inbox do Dialogy e confirme que o chat foi criado pela instancia correta.

No banco, a conversa deve gerar registro em ad_clicks, ad_attributions e conversion_exports.

Depois de configurar credenciais Google Ads API, processe a fila para enviar a conversao.

Boas praticas

Use um card por campanha importante para facilitar auditoria e comparacao.

Nao use link direto do WhatsApp nos anuncios que precisam de atribuicao precisa.

Mantenha a mensagem inicial curta para reduzir a chance do cliente apagar o codigo tecnico.

Envie primeiro o evento Mensagem recebida. Depois evolua para Lead qualificado e Venda fechada.

Abrir integracao GADS Voltar para docs Developer Hub