VEX Sales
WhatsApp para vendas

API de Conversões da Meta: devolva a venda do WhatsApp

Equipe VEX Sales8 min de leitura

Seção API de Conversões da Meta na tela Rastreamento do CRM, com os campos do pixel, da página e do token

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:

  1. Lead. Enviado quando chega a primeira mensagem vinda do anúncio. É o aviso de que aquele clique virou uma conversa.
  2. 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 .

Categoria:WhatsApp para vendas

Compartilhar:WhatsAppLinkedInX

Blog

Leia também

Veja a IA atendendo no seu WhatsApp

Conecte seu número por QR code e veja a IA respondendo em minutos.

  • WhatsApp por QR code em minutos
  • Chat do site incluso em todos os planos
  • A IA pausa quando sua equipe assume
  • Cancele quando quiser