Onde fica no painel
Automações → Automações nativas → criar → Meta ADS - API de Conversão. Só aparece na conexão oficial (e na coexistência). O projeto precisa ter pelo menos uma coluna.Como configurar
Um mapeamento comum:
Como funciona por trás
Quando dispara
O evento sai quando um lead que veio de anúncio entra na coluna configurada:- Movido para a coluna, por qualquer caminho de um lead por vez: CRM, API, agente ou transbordo por inatividade.
- Chegou pelo anúncio: quando a mensagem do anúncio chega, a Zatten guarda os dados do clique e já envia as conversões da coluna em que o lead está. Assim, uma conversão ligada à coluna de entrada sai logo na primeira mensagem.
Quem conta como “lead de anúncio”
O lead cuja mensagem chegou por um anúncio Click-to-WhatsApp, com o id do clique (ctwa_clid). A Zatten guarda o primeiro clique do lead. Lead orgânico, importado ou que chegou por outro canal não gera evento nenhum, e nada avisa: a automação simplesmente não age.
O que é enviado
Um evento por conversão, com o horário do momento, origembusiness_messaging no canal whatsapp, a conta do WhatsApp Business, o ctwa_clid e o telefone e o nome do lead em hash SHA-256. Em Purchase, vai também o valor em BRL.
Deduplicação
Cada evento sai uma vez por lead e por clique. Se o lead sai e volta para a coluna, o evento não é reenviado. Um segundoPurchase do mesmo lead, vindo do mesmo anúncio, também não.
Se o envio falha (credencial da Meta inválida, por exemplo), não há nova tentativa, e a falha não aparece no painel. As conversões enviadas aparecem em Métricas.
Pelo MCP
Blococonversions.
- Identificado por
name. Nasce desligado. - A coluna vai por nome, em
column_name. Coluna inexistente faz a conversão ser ignorada, com nota. - Use só os seis eventos do painel:
LeadSubmitted,AddToCart,InitiateCheckout,Purchase,ViewContenteCartAbandoned. O campoeventaceita outros nomes, mas hoje só esses seis aparecem como enviados no registro de conversões. Conversões comScheduleou com nome personalizado (comoQualifiedLead) não aparecem enviadas, nem com erro. Não use. valuesó vale emPurchase.
Armadilhas
- Só funciona com lead de anúncio Click-to-WhatsApp. Testar movendo um lead orgânico não envia nada.
- Só os seis eventos do painel saem. Conversão com
Scheduleou com nome personalizado não aparece enviada (nem com erro). Modelos de nicho antigos trazemScheduleem “Consulta agendada”: troque por um dos seis. - Valor fixo em
Purchase. O valor é o da automação, não o da venda real. Para valores diferentes, crie colunas diferentes (ou use um ticket médio). - Um evento por clique. Recompra do mesmo lead, vinda do mesmo anúncio, não é informada de novo.
- O primeiro anúncio fica com o crédito. Se o lead volta por outro anúncio, as conversões continuam atribuídas ao primeiro clique.
- Moeda sempre BRL. Contas de anúncio em outra moeda recebem o valor como BRL.
- Trocar a conexão para não oficial faz as conversões pararem, mesmo ligadas.
- Mover vários leads de uma vez pelo CRM não envia conversões. Mova um por vez ou pela API.
Perguntas frequentes
Onde vejo as conversões no Meta Ads?
Onde vejo as conversões no Meta Ads?
No Gerenciador de Eventos e nas colunas de resultados das campanhas de mensagem, conforme a configuração da sua conta de anúncios. Os nomes dos eventos são os da Meta (por exemplo,
Purchase aparece como compra).Preciso configurar pixel ou dataset?
Preciso configurar pixel ou dataset?
Não. A Zatten cria o dataset da conta do WhatsApp Business ao enviar o primeiro evento.
Uma conversão por coluna ou várias?
Uma conversão por coluna ou várias?
Uma coluna pode ter várias conversões (eventos diferentes). Cada uma é enviada uma vez por lead e por clique.
Para saber mais
- Funil (Kanban)
- Webhooks de eventos:
adsDatanoLEAD_CREATED. - Playbook: anúncios Click-to-WhatsApp
- Meta: Conversions API para mensagens, anúncios Click-to-WhatsApp.
- Termos para buscar: “Conversions API business messaging”, “ctwa_clid”, “Click-to-WhatsApp ads”, “action_source business_messaging”.