
A API de Conversões é o canal oficial da Meta para o seu sistema contar ao anúncio o que aconteceu depois do clique. No caso de quem vende pelo WhatsApp, isso resolve um buraco conhecido: o anúncio sabe que a pessoa clicou e abriu a conversa, mas não sabe se ela comprou, porque a venda aconteceu dentro das mensagens. Ligando a API de Conversões no CRM, a venda marcada como ganha volta para o anúncio que a trouxe, com o valor em reais.
O que é a API de Conversões da Meta?
É uma forma de enviar eventos para a Meta a partir do servidor, sem depender do navegador da pessoa. O pixel tradicional roda no site e registra o que o visitante faz ali. A API de Conversões faz o caminho contrário: quem manda a informação é o seu sistema, depois que algo aconteceu de fato, como uma compra confirmada.
No WhatsApp, a pessoa clica no anúncio, cai direto na conversa e nunca passa pelo seu site. Não existe página de obrigado para o pixel registrar a compra. Quem sabe que a venda aconteceu é o seu CRM.
Conjunto de dados, pixel e evento: os nomes que você vai ver
- Conjunto de dados. É o "recipiente" que recebe os eventos no Gerenciador de Eventos da Meta. Muitas contas ainda chamam de pixel, por isso o campo no CRM traz os dois nomes.
- Evento. É cada fato enviado: um lead que chegou, uma compra que fechou.
- Token de acesso. É a chave que autoriza o seu sistema a enviar eventos para aquele conjunto de dados.
Para que serve devolver a venda ao anúncio
A Meta decide para quem mostrar o seu anúncio olhando para os sinais que recebe. Se ela só recebe "a pessoa abriu a conversa", ela aprende a achar gente que abre conversa. Quando recebe também "esta pessoa comprou, e o valor foi este", ela passa a ter informação sobre quem compra, e não só sobre quem clica.
Não há promessa de resultado numérico: cada conta responde de um jeito. O que muda é a qualidade da informação. Sem a venda, o anúncio é avaliado pelas conversas abertas; com ela, pelo que virou dinheiro. Se você ainda não marca as conversas como ganhas, comece pelo modelo de funil de vendas no WhatsApp, que tem a etapa Ganho com o valor fechado.
Quais eventos o CRM envia para a Meta?
São dois, e só dois:
- Lead. Enviado quando chega a primeira mensagem vinda do anúncio. É o aviso de que aquele clique virou uma conversa.
- Compra (Purchase). Enviada quando a conversa é marcada como ganha, com o valor da venda em reais.
O telefone e o nome do cliente seguem criptografados com hash SHA-256, como a Meta pede: ela consegue comparar com o que já tem, mas o texto puro não viaja.
O que não é enviado
- Não existe evento de lead qualificado. Mover o cartão para uma etapa intermediária do funil não manda nada para a Meta.
- Não instala pixel no seu site. O recurso trabalha do servidor, a partir da conversa.
De onde precisa vir o lead
Para ligar o evento ao clique certo, a Meta usa o identificador do clique, que só existe quando a pessoa chega por um anúncio de clique para o WhatsApp. Por isso o recurso vale para lead de anúncio de clique para o WhatsApp. Lead de formulário e lead de link de origem ficam de fora, porque não trazem esse identificador.
Em Conexões existe a opção Formulários do Facebook (Lead Ads), que para a maioria das contas ainda aparece como Em breve, porque depende de aprovação da Meta.
Como ligar a API de Conversões na tela Rastreamento
Tudo acontece na tela Rastreamento do CRM da VEX Sales, na seção API de Conversões da Meta, que tem o subtítulo "Devolve ao anúncio a venda que ele trouxe". O passo a passo:
1. Pegue os dados no Gerenciador de Eventos da Meta
No Gerenciador de Eventos, abra o conjunto de dados que recebe os eventos da sua conta de anúncios e copie o ID dele. Nas configurações do mesmo conjunto, gere um token de acesso para a API de Conversões. Anote também o ID da página do Facebook ligada aos anúncios de clique para o WhatsApp.
2. Preencha os campos
- ID do conjunto de dados (pixel): o número copiado no passo anterior.
- ID da página do Facebook: a página que aparece como anunciante.
- Token de acesso: a chave gerada no Gerenciador de Eventos. Trate como senha e não compartilhe em grupo.
- Código de evento de teste: opcional, para o período de teste (veja o passo 3).
3. Teste antes de ligar de vez
Copie o código da aba Testar eventos do Gerenciador de Eventos e cole no campo Código de evento de teste. Com ele, os envios aparecem lá em segundos, sem valer. Apague o código quando estiver certo.
4. Ligue os interruptores
- Avisar quando o lead chega: manda um evento de lead assim que a primeira mensagem de anúncio chega, além da compra.
- Ligar a API de Conversões: cada venda marcada como ganha, de um lead que veio de anúncio, vira um evento de compra na Meta. Sem anúncio, nada é enviado.
5. Acompanhe o Diário de envios
O Diário de envios mostra o que foi para a Meta, e o que não foi e por quê. É o primeiro lugar para olhar quando uma venda não aparece no relatório do anúncio.
Como deixar o fluxo confiável no dia a dia
O recurso depende de uma coisa que só a sua equipe faz: marcar a conversa como ganha quando a venda fecha, com o valor certo. Se o vendedor esquece de marcar, a Meta nunca fica sabendo. Três cuidados:
- Defina quando uma venda é ganha, com o mesmo critério para todos.
- Registre o valor real. É ele que segue para a Meta.
- Não use "ganha" para outra coisa. Isso manda uma compra falsa para o anúncio.
Se você ainda está estruturando o pipeline e o motivo de perda, o guia de CRM com WhatsApp e pipeline de vendas mostra como deixar as etapas claras. E se a dúvida é sobre o tipo de conexão do número, veja a comparação entre WhatsApp Oficial e QR code.
Quando você precisa de mais do que o recurso
A API de Conversões do CRM cobre uma ponta específica: a venda que fecha no WhatsApp voltando para o anúncio de clique para o WhatsApp. Ela não monta o pixel do site, não configura o Google Analytics e não cria painéis com todas as fontes de tráfego juntas.
Se a sua empresa precisa disso tudo funcionando junto, com pixel no site, GA4, Google Tag Manager e um painel que cruza as fontes, a VEX Growth, agência do mesmo grupo, faz esse trabalho em trackeamento e dashboard de marketing.
Em quais planos está disponível
A API de Conversões da Meta faz parte dos planos de CRM da VEX Sales, que começam no Starter, de R$ 297 por mês, e seguem pelo Essencial, Profissional e Escala. Os planos Só IA, que trazem Agente de IA, Mensagens e Agenda sem o CRM, não incluem este recurso. Veja o que vem em cada plano na página do CRM para WhatsApp e compare os valores em preços.
Resumo
A API de Conversões resolve o ponto cego de quem anuncia para o WhatsApp: a venda acontece na conversa, longe do pixel. Na tela Rastreamento você preenche o ID do conjunto de dados, o ID da página e o token, testa com o código de evento de teste e liga os interruptores. A conversa marcada como ganha vira uma compra com valor, enviada uma vez só. O cuidado que fica com você é marcar a venda como ganha, com o valor certo.
Perguntas frequentes
Preciso instalar o pixel no meu site para usar a API de Conversões?
Não para este recurso. A integração do CRM não instala pixel no navegador do seu site: ela envia os eventos direto do servidor para a Meta. Você só precisa do ID do conjunto de dados, que a Meta também chama de pixel, para dizer em qual conjunto os eventos devem cair dentro do Gerenciador de Eventos.
Lead que chegou por formulário do Facebook também gera evento?
Não. O evento depende do identificador do clique, que só existe quando a pessoa veio de um anúncio de clique para o WhatsApp. Lead de formulário e lead de link de origem não geram evento. A conexão Formulários do Facebook aparece como Em breve para a maioria das contas, porque ainda depende de aprovação da Meta.
O que acontece se eu marcar a mesma conversa como ganha duas vezes?
A compra não é enviada de novo. O CRM guarda o que já foi mandado e a mesma venda nunca vai duas vezes para a Meta, mesmo que alguém reabra a conversa e marque como ganha outra vez. Assim o anúncio não recebe uma venda em dobro e o relatório da Meta não infla.
Como sei se os eventos chegaram na Meta?
Preencha o Código de evento de teste, que vem da aba Testar eventos do Gerenciador de Eventos: com ele os envios aparecem lá em segundos, sem valer. No CRM, o Diário de envios mostra o que foi para a Meta, e o que não foi e por quê. Quando estiver certo, apague o código.
Equipe VEX Sales
Escrito por quem constrói e opera a plataforma, na VEX Sales.
Categoria:WhatsApp para vendas


