Conversions API para WhatsApp: como devolver a venda fechada no chat para a Meta, e por que a deduplicação é problema seu
O guia de integração da Conversions API para mensageria, atualizado em 5 de maio de 2026, descreve o caminho para transformar conversa em conversão medida usando o identificador de clique ctwa_clid. E avisa em letras claras: a Meta não deduplica esses eventos, quem tem que deduplicar é o anunciante.
O que a Conversions API resolve no WhatsApp?
Ela fecha o buraco entre o anúncio que gerou a conversa e a venda que aconteceu dentro dela. Quando alguém clica em um anúncio de clique para o WhatsApp, a Meta sabe que houve uma conversa iniciada, mas não sabe se aquela conversa virou pedido, orçamento aprovado ou nada. A Conversions API é o canal pelo qual a empresa devolve essa informação a partir do próprio servidor.
O documento oficial define o produto como uma ferramenta que permite a parceiros de mensageria compartilhar dados de interações valiosas em conversas de negócio, diretamente dos seus servidores, para entender e melhorar o desempenho dos anúncios que clicam para WhatsApp, Messenger ou Instagram.
A diferença prática em relação à medição de site é que aqui não existe pixel. Não há navegador, não há página, não há cookie. O evento nasce no seu sistema de atendimento ou no seu CRM, no momento em que um humano ou um agente marca a conversa como fechada, e viaja por chamada de servidor.
Como a venda no chat é amarrada ao anúncio?
Por um identificador chamado ctwa_clid, o Click to WhatsApp Click ID. A documentação o descreve como um identificador pessoal, único por clique, exposto à empresa quando o usuário que entrou na conversa veio de um anúncio de clique para o WhatsApp.
Esse identificador não chega em nenhuma consulta separada. Ele vem dentro do objeto referral da primeira mensagem que o usuário envia, no mesmo webhook de mensagens que já sustenta o atendimento, junto com o texto do anúncio, o título, a imagem e o identificador da origem. A instrução oficial é curta e define toda a arquitetura: ao receber o ctwa_clid, armazene junto com a conversa.
É esse o ponto em que a maioria das operações brasileiras perde a atribuição. O identificador chega uma única vez, na mensagem de abertura, e se o receptor não gravar aquele campo na ficha do lead, ele desaparece. Semanas depois, quando a venda fecha, não há mais como dizer à Meta de qual anúncio aquele cliente veio.
Quais eventos podem ser enviados?
A lista publicada na seção de perguntas frequentes do guia cobre bem mais do que compra:
- Purchase, LeadSubmitted, QualifiedLead e InitiateCheckout
- AddToCart, ViewContent e CartAbandoned
- OrderCreated, OrderShipped, OrderDelivered, OrderCanceled e OrderReturned
- RatingProvided e ReviewProvided
Há uma regra de escopo que a documentação faz questão de deixar clara: eventos de mensageria devem representar apenas interações que ocorrem na thread de conversa, não conversões que acontecem em outros canais, como o site. Se a conversão acontece fora do chat, o caminho é usar a Conversions API de web ou de aplicativo, e o evento continua sendo atribuído ao identificador de clique correspondente.
Do lado técnico, o envio é um POST para /{DATASET_ID}/events, com action_source igual a business_messaging e messaging_channel igual a whatsapp. O bloco user_data leva o ID da conta do WhatsApp Business e o ctwa_clid, e o custom_data leva moeda e valor.
Por que o evento duplicado é problema seu?
Porque a Meta declara que não resolve isso nesse produto. A resposta oficial à pergunta sobre deduplicação é direta: a Meta não auxilia na deduplicação de eventos para a Conversions API de mensageria, e por isso recomenda fortemente que os anunciantes façam a deduplicação antes de enviar.
Isso é diferente do que acontece na medição de site, onde existe um mecanismo documentado de deduplicação por event_id combinado com event_name, e a Meta escolhe entre o evento do pixel e o do servidor. No caminho da mensageria, esse trabalho não é feito por ninguém além do anunciante.
Some isso ao comportamento do webhook de mensagens, que reentrega eventos por até 7 dias e envia as retentativas a todos os aplicativos inscritos, e o risco fica evidente: uma conversa pode gerar dois eventos de compra, com valor cheio nos dois, inflando o retorno aparente da campanha. A defesa é a mesma da camada de atendimento, ou seja, chave única no banco antes de qualquer disparo de evento.
O que muda para times de mídia no Brasil
O primeiro efeito é sobre a otimização de campanha, e não apenas sobre o relatório. Segundo o próprio documento, a Conversions API habilita acesso à otimização por compra para anúncios que clicam para Messenger e para WhatsApp. Para anúncios que levam ao Instagram Direct isso não está disponível, e a otimização segue sendo por conversas iniciadas. Em um mercado onde o clique para WhatsApp é o formato dominante de geração de demanda, essa é a diferença entre otimizar por volume de conversa e otimizar por venda.
O segundo é de acesso. As permissões exigidas são whatsapp_business_management e whatsapp_business_manage_events, ambas em acesso avançado, mais o nível de acesso da Marketing API. Nesse ponto o documento traz uma mudança relevante: os rótulos foram renomeados, o antigo Standard Access virou Limited Access e o Advanced Access virou Full Access, e o limiar de qualificação para o nível completo caiu de 1.500 para 500 chamadas à Marketing API nos últimos 15 dias. Nenhuma mudança de código é necessária. O efeito prático é que operações menores chegam ao nível completo mais cedo.
O terceiro é tranquilizador para quem já mede o site: adicionar mensageria à integração existente de Conversions API não oferece risco à integração atual, porque a atribuição é baseada no identificador da página ou do dataset, e não no identificador do aplicativo. Quem está montando a operação de ponta a ponta encontra o desenho do canal no nosso guia da API oficial do WhatsApp e a camada de atendimento em como automatizar atendimento no WhatsApp.
Leitura crítica
A Conversions API para mensageria é, na prática, o que separa quem otimiza campanha de WhatsApp por intuição de quem otimiza por resultado. Sem ela, o algoritmo aprende a buscar gente que abre conversa, e gente que abre conversa não é necessariamente gente que compra. Com ela, o sinal de venda volta para dentro do leilão. Para o mercado brasileiro, tão dependente de clique para WhatsApp, esse é possivelmente o ajuste de maior alavancagem disponível hoje sem aumentar verba.
Dito isso, o desenho tem um viés que convém enxergar. A Meta pede que a empresa devolva seu dado de venda para melhorar a entrega do anúncio da própria Meta, e ao mesmo tempo se exime de deduplicar esse dado. Quem envia errado, para mais, melhora o retorno aparente da campanha e piora a decisão de orçamento. O incentivo para auditar o próprio envio é inteiramente da empresa.
Há ainda uma fragilidade estrutural no ctwa_clid: ele é único por clique e chega uma vez só. Troca de fornecedor de atendimento, migração de CRM ou reprocessamento de fila que perca aquele campo quebra a medição em silêncio, sem erro e sem alerta. Ele é o único fio que liga a verba gasta ao dinheiro entrado.