API de Conversões da Meta no WhatsApp: como enviar suas vendas

Resposta curta: a API de Conversões é o caminho pelo qual você envia à Meta, direto do servidor, um evento que acontece fora do anúncio, como a venda fechada no WhatsApp. Para a Meta saber de qual anúncio a venda veio, o evento precisa carregar o identificador do clique. Sem ele, a Meta recebe a venda, mas não consegue ligá-la ao anúncio.

Você roda anúncios que abrem o WhatsApp, as conversas chegam, e a venda fecha lá dentro. O pixel do seu site não enxerga nada disso, porque ele só vê o que acontece em uma página. Para a Meta aprender com quem compra, e não só com quem manda mensagem, a venda precisa voltar por outro caminho.

É isso que a API de Conversões faz. E é também onde a maioria das implementações falha em silêncio: o evento sai, a Meta recusa, e ninguém percebe.

O caminho de uma venda até a Meta

Cada etapa depende da anterior. Se a conversa não guarda o identificador do clique, a venda não consegue voltar ligada ao anúncio. Se a venda não é registrada, não há evento para enviar.

O que a Meta precisa receber

O conjunto exato varia conforme o formato de envio e muda com o tempo, então confirme na documentação atual da Meta. Em geral, para uma venda do WhatsApp, o evento leva:

Dado	Para que serve	Se faltar
Nome do evento (por exemplo, compra)	Diz à Meta o que aconteceu	O evento não é reconhecido
Data e hora reais da venda	Coloca o evento na linha do tempo correta	A atribuição fica errada, ou o evento é recusado por ser antigo
Valor e moeda	Permite calcular o retorno (ROAS)	A compra perde o sentido, porque a Meta não mede receita
Identificador do clique (ctwa_clid)	Liga a conversa ao anúncio de origem	A Meta recebe a venda, mas não sabe de qual anúncio veio
Telefone com hash	Ajuda a Meta a reconhecer a pessoa	Menos correspondência entre a venda e o usuário
Conta do WhatsApp Business	Indica de qual conta veio a conversa	O evento pode não ser associado à conversa
ID do evento (event_id)	Evita contar a mesma venda duas vezes	Risco de duplicidade

Sobre o telefone: o hash é SHA-256, e o número entra só com dígitos, com o código do país, em um formato padronizado antes de gerar o hash. Dois números iguais escritos de formas diferentes geram hashes diferentes, e a correspondência se perde.

Quais eventos enviar

O ideal é enviar as duas etapas que importam: o lead qualificado e a compra. O lead qualificado ensina a Meta a buscar gente com interesse real, e a compra a buscar quem paga.

Uma observação da nossa operação: no formato de mensagens (o que usa o identificador do clique), a Meta aceitou apenas esses dois tipos, lead qualificado e compra. Outros eventos, como um "Lead" genérico, foram recusados com erro de parâmetro inválido. Isso pode mudar, então teste antes de depender. Eventos personalizados seguem por outro caminho, sem a atribuição nativa ao anúncio.

Seis erros que derrubam o envio da venda para a Meta

1. Enviar tarde demais. A Meta recusa eventos com mais de 7 dias, e uma requisição com um evento antigo pode ser recusada inteira. Registre a venda no dia em que ela acontece. No RastroLead, uma venda fora dessa janela continua registrada com a data real, mas não é enviada à Meta, e o motivo fica salvo.

2. Mandar a data de hoje em vez da data da venda. Parece inofensivo, mas desloca a venda no tempo e embaralha a atribuição. Use a data real.

3. Compra sem valor. Sem valor e moeda, a compra não alimenta o ROAS. Uma compra com valor zerado ainda é contada, mas não diz à Meta quanto aquela venda vale.

4. Contar a mesma venda duas vezes. Se a venda chega pelo navegador e pelo servidor sem o mesmo event_id, a Meta pode somar as duas. O identificador igual nos dois caminhos permite que ela descarte a repetição.

5. Não guardar o identificador do clique. Ele chega junto com a primeira mensagem, e depende de o número estar conectado de um jeito que permita recebê-lo. Se você não o guarda naquela hora, não consegue recuperar depois. Esse é o ponto que mais separa uma integração que atribui de uma que só reporta venda.

6. Não perceber que falhou. A Meta pode devolver erro, ou ficar indisponível por alguns minutos. Sem nova tentativa automática e sem alerta, a venda some e ninguém nota.

Como saber se está funcionando

• No Gerenciador de Eventos da Meta, confira se os eventos chegam e se a quantidade bate com as vendas que você registrou.
• Compare o número de compras no Gerenciador de Anúncios com o seu registro de vendas. Uma diferença grande aponta para evento perdido ou recusado.
• Acompanhe o status de cada envio. No RastroLead, cada evento guarda se foi enviado, se está em nova tentativa ou se falhou, com o motivo, e o sistema avisa quando uma venda não chega à Meta.

Fazer você mesmo ou usar uma ferramenta

Dá para montar a integração, e vale se você tem quem mantenha. O que costuma dar trabalho não é o primeiro envio, é o resto:

• guardar o identificador do clique em cada conversa;
• gerar os hashes no formato certo;
• evitar duplicidade entre navegador e servidor;
• reenviar automaticamente quando a Meta falha;
• respeitar a janela de 7 dias;
• acompanhar o que foi aceito e o que foi recusado.

Se você prefere não manter isso, o RastroLead guarda o identificador do clique, envia a compra e o lead qualificado à Meta com nova tentativa automática e avisa quando uma venda não chega. Testar o envio de vendas

Para comparar os caminhos (manual, automação própria e ferramenta pronta), veja como rastrear vendas no WhatsApp. E para entender como a atribuição funciona de ponta a ponta com anúncios que abrem o WhatsApp, veja a atribuição de vendas no Meta Ads.

O que conferir antes de ligar a integração

• Guardar o identificador do clique em toda conversa que chega de anúncio.
• Registrar a venda com valor, moeda e a data real.
• Enviar o lead qualificado e a compra, não só a compra.
• Usar o mesmo event_id quando o evento passa por mais de um caminho.
• Registrar a venda no mesmo dia, por causa da janela de 7 dias.
• Ter nova tentativa automática e um alerta para falha.
• Conferir toda semana a quantidade enviada contra a quantidade de vendas.

Com a venda ligada ao anúncio, vale usar isso para decidir onde investir. Veja como em Meta Ads traz lead mas não vende: onde está o problema?.