umClique

umClique › Blog › Anúncios

API de Conversões da Meta no WhatsApp: como baixar o CPL e o CPA dos anúncios de clique para o WhatsApp

Como a API de Conversões leva as vendas do WhatsApp de volta para a Meta, otimiza os anúncios para quem compra e como ligar na umClique sem código.

Capa do guia da API de Conversões da Meta no WhatsApp

Você roda anúncio de clique para o WhatsApp, a conversa chega, a venda acontece no chat e a Meta nunca fica sabendo. Para ela, aquela campanha gerou "conversas iniciadas", e é para isso que ela otimiza: mais gente que chama, não mais gente que compra. O resultado é conhecido de quem anuncia: muito "oi", pouca venda e um custo por lead que não fecha a conta.

A API de Conversões da Meta resolve isso devolvendo para a Meta o que aconteceu depois do clique: quem virou lead qualificado, quem comprou e por quanto. Este guia explica, sem tecniquês, como ela funciona com o WhatsApp, o que muda nas suas campanhas e como ligar na umClique em poucos minutos.

O problema: a Meta não vê o que acontece no WhatsApp

Numa loja virtual, o pixel instalado no site avisa a Meta quando alguém compra. No WhatsApp não existe site nem pixel. A pessoa clica no anúncio, abre a conversa e daí para frente tudo acontece fora do alcance da Meta.

Sem essa informação, o algoritmo trabalha no escuro:

  • otimiza para conversa iniciada, então aprende a achar gente que manda mensagem, inclusive curioso e quem nunca compra;
  • não sabe qual anúncio vendeu, e o Gerenciador de Anúncios mostra custo por conversa, não custo por venda;
  • não consegue criar público parecido com quem comprou, porque nunca soube quem comprou.
Comparativo do que a Meta enxerga numa campanha de clique para o WhatsApp: sem a API de Conversões, ela só vê a conversa iniciada, otimiza para quem chama e não mostra vendas no Gerenciador; com a API, vê lead qualificado e compra, otimiza para quem compra, aprende com o valor da venda e mostra o custo por compra no relatório
A diferença está no que a Meta consegue aprender

O que é a API de Conversões para WhatsApp

É um canal oficial da Meta para empresas e plataformas mandarem eventos de negócio que aconteceram numa conversa: lead enviado, lead qualificado, carrinho, pedido, compra. Cada evento vai junto com o identificador do clique no anúncio, e é isso que permite à Meta saber de qual anúncio aquela venda veio.

Com esses eventos, a Meta consegue:

  1. mostrar no Gerenciador de Anúncios quantas compras cada campanha de clique para o WhatsApp gerou e o custo por compra;
  2. otimizar a entrega para os eventos que você mandou, procurando pessoas com mais chance de comprar, e não só de chamar;
  3. criar públicos semelhantes a partir de quem comprou pelo WhatsApp.

Por isso a API de Conversões é uma das alavancas mais diretas para baixar CPL e CPA em campanhas de mensagem: a Meta para de gastar com quem só chama e passa a procurar quem fecha. O tamanho do ganho varia de conta para conta, e o algoritmo precisa de alguns dias de eventos para aprender, mas a direção é sempre a mesma: mais sinal certo, menos desperdício.

Como funciona na umClique

Fluxo da API de Conversões da Meta na umClique: a pessoa clica no anúncio e abre o WhatsApp, a venda acontece no Chat, a equipe aplica a etiqueta Comprou ou move o contato de etapa e a umClique envia o evento de compra com o valor para a Meta, que passa a procurar mais gente parecida com quem comprou
Quatro passos, nenhum código
  1. A pessoa clica no anúncio de clique para o WhatsApp e cai no seu número da API Oficial.
  2. A conversa acontece no Chat da umClique, com a equipe ou com um agente de IA. A umClique guarda o identificador do clique daquele anúncio.
  3. Algo importante acontece: o contato recebe uma etiqueta (por exemplo, "Comprou") ou entra numa etapa do funil (por exemplo, "Lead qualificado").
  4. A umClique avisa a Meta com o evento que você escolheu, o valor da venda e os dados do contato protegidos.

Você não muda nada no jeito de trabalhar. A equipe continua etiquetando e movendo cards como sempre, e as regras transformam isso em eventos para a Meta.

Os eventos que você pode enviar

São 14 eventos padrão da Meta para conversas. Os mais usados:

EventoQuando usarExemplo de regra
Lead enviadoA pessoa virou lead de verdadeAo entrar na etapa "Novo lead"
Lead qualificadoPassou pela qualificaçãoAo receber a etiqueta "Qualificado"
Carrinho abandonadoComeçou e não terminouAo receber a etiqueta "Carrinho"
Pedido criadoFechou o pedidoAo entrar em "Aguardando pagamento"
CompraPagouAo receber a etiqueta "Comprou"

A lista completa inclui também visualizou conteúdo, adicionou ao carrinho, iniciou o checkout, pedido enviado, entregue, cancelado e devolvido, avaliação e comentário.

Pedido criado, pedido enviado e compra exigem valor: a tela não deixa salvar a regra sem ele. É o valor que permite à Meta otimizar para vendas maiores, não só para mais vendas.

Passo a passo para ligar

1. Conecte o pixel ao canal

  1. No menu, abra Apps e clique em API de Conversões Meta.
  2. Na aba Pixels, em Canais conectados, clique em Conectar CAPI no seu número da API Oficial.
  3. Clique em Conectar com Meta (CAPI) e escolha a mesma conta do WhatsApp Business do canal. O conjunto de dados é vinculado sozinho, sem você digitar ID ou token.
  4. Ligue o interruptor do canal. O canal passa a mostrar o selo CAPI na tela de Canais.

Se quiser conferir, use Testar conexão. Atenção: com o código de teste preenchido, os eventos não contam para as campanhas. Use só para testar e apague depois.

2. Crie as regras

Na aba Regras, clique em Nova Regra e preencha:

  • Nome: para você reconhecer, como "Compra pela etiqueta";
  • Gatilho: "Ao receber tag" ou "Ao entrar em etapa";
  • Tag ou etapa: a etiqueta ou a coluna do funil que dispara;
  • Evento (Meta): por exemplo, Compra aprovada;
  • Pixel: o conjunto de dados conectado;
  • Mapeamento de campos (opcional): de onde vem o valor, a moeda, o número do pedido, o produto e outros dados.

Comece com duas regras: Lead qualificado e Compra. São os sinais que mais ajudam o algoritmo.

3. Envie à mão quando precisar

Nem toda venda passa por etiqueta. No Chat, o atendente pode usar o item Evento de conversão no clipe da conversa, escolher o evento e informar o valor. Ele aparece quando a empresa tem o pixel ligado.

4. Acompanhe os envios

A aba Logs mostra cada evento: quando, contato, evento, atribuição, regra e status. Na própria conversa do Chat aparece o aviso "Conversão enviada" ou "Conversão falhou".

Dados protegidos e sem duplicidade

  • Telefone, e-mail e nome vão protegidos por hash, o padrão que a Meta exige. A Meta consegue cruzar com a conta da pessoa sem receber o dado aberto.
  • Cidade e estado são deduzidos pelo DDD, o que melhora a correspondência sem pedir nada a mais ao cliente.
  • Sem contagem dupla: o mesmo contato com o mesmo evento no mesmo dia conta uma vez só, mesmo que a etiqueta seja colocada e tirada várias vezes.

O que você precisa saber antes de ligar

  • Vale para conversas que vieram de anúncio. O evento só é enviado quando a conversa tem o identificador de um clique em anúncio de clique para o WhatsApp. Lead orgânico aparece no log como "Sem anúncio (não enviado)". É assim que a Meta atribui a venda ao anúncio certo.
  • Precisa da API Oficial. O número conectado por QR Code não entra. Se você ainda usa o app no celular, a coexistência coloca o mesmo número na API Oficial sem largar o WhatsApp Business.
  • Regra por etapa vale para o Kanban de contatos. No Kanban de negócios, use a etiqueta como gatilho.
  • Dê tempo ao algoritmo. Os primeiros dias servem para a Meta juntar eventos. Não troque a campanha inteira no segundo dia.

Como usar os eventos nas campanhas

Com os eventos chegando, três ajustes no Gerenciador de Anúncios fazem diferença:

  1. Coloque a coluna de compras e custo por compra no relatório das campanhas de mensagem. Pela primeira vez você compara anúncio contra anúncio pelo que vendeu.
  2. Desligue o que gera conversa e não gera venda. Tem anúncio campeão de "oi" que nunca vendeu nada. Agora dá para ver.
  3. Crie públicos semelhantes a partir de quem comprou pelo WhatsApp e teste contra o seu público atual.

Junto com a API de Conversões, um agente de IA com o gatilho Mensagem vinda de um anúncio atende o lead na hora, já sabendo de qual oferta ele veio. Quem chega e não fecha pode ser retomado pelo follow-up automático com IA.

Perguntas frequentes

A Meta cobra pelos eventos enviados?

Não. A Meta não cobra pelos eventos da API de Conversões. O que continua sendo cobrado são as mensagens da API Oficial, como sempre.

Preciso de programador?

Não. A conexão é feita pelo login da Meta e as regras são montadas na tela, com etiquetas e etapas que a equipe já usa.

Funciona para o Instagram?

As regras desta tela enviam eventos das conversas do WhatsApp que vieram de anúncio de clique para o WhatsApp.

Venda mais pelo WhatsApp com o umClique

API oficial, automações, disparos e CRM num lugar só. Comece hoje e veja o resultado nas primeiras conversas.

Conhecer os planos

Continue lendo

Capa do guia de agente de IA no WhatsApp Oficial para leads de anúncio CRM ·

Agente de IA no WhatsApp Oficial: como atender lead de anúncio na hora sem estourar o custo

Como configurar um agente de IA no WhatsApp Oficial para responder lead de anúncio na hora, aproveitar a janela grátis da Meta e controlar o custo do atendimento.

Capa do guia para pagar menos no envio da API Oficial do WhatsApp API oficial ·

Como pagar menos no envio de mensagens da API Oficial do WhatsApp

O que mudou na cobrança da Meta em outubro de 2026 e 10 formas práticas de gastar menos com mensagens na API Oficial do WhatsApp sem vender menos.

Capa do guia de disparo de Ano Novo no WhatsApp Disparo em massa ·

Disparo de Ano Novo no WhatsApp: como fechar dezembro e começar janeiro vendendo

Três disparos entre o Natal e janeiro, com modelos de mensagem, e a faxina da base que deixa o primeiro envio de 2027 mais barato.