# 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.

Publicado: 2026-11-11 · Categoria: Anúncios · URL: https://connect.umcliquedigital.com/blog/api-conversoes-meta-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](/figuras/blog/api-conversoes-meta-whatsapp/sem-e-com-capi-1200x560.svg "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](/figuras/blog/api-conversoes-meta-whatsapp/como-funciona-1200x560.svg "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:

| Evento | Quando usar | Exemplo de regra |
|---|---|---|
| Lead enviado | A pessoa virou lead de verdade | Ao entrar na etapa "Novo lead" |
| Lead qualificado | Passou pela qualificação | Ao receber a etiqueta "Qualificado" |
| Carrinho abandonado | Começou e não terminou | Ao receber a etiqueta "Carrinho" |
| Pedido criado | Fechou o pedido | Ao entrar em "Aguardando pagamento" |
| Compra | Pagou | Ao 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](/blog/coexistencia-whatsapp-api-oficial) 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](/blog/follow-up-automatico-whatsapp-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.
