Principal WhatsApp Oficial (API Cloud) Conversões da Meta: informe as vendas dos anúncios clique para WhatsApp

Conversões da Meta: informe as vendas dos anúncios clique para WhatsApp

Última atualização em Oct 29, 2026

🔒 Configurar a caixa, as automações e as macros: administradores. Botão Reportar conversão: administradores e tipos de agente com a permissão Gerenciar relatórios. Se a aba Conversões Meta não aparecer nas configurações da caixa, o recurso ainda não está ativo na sua conta — fale com o suporte.

Nos anúncios clique para WhatsApp, o Gerenciador de Anúncios mostra quantas conversas cada anúncio iniciou, mas a Meta não sabe quais delas viraram venda — e por isso entrega o anúncio para quem conversa, não para quem compra.

Com as Conversões da Meta, quando uma conversa que veio de anúncio vira um resultado (uma compra, um lead qualificado, um pedido), a plataforma avisa a Meta pela API de Conversões para mensagens, junto com o código do clique (o CTWA CLID do cartão Mensagem de anúncio). Assim o Gerenciador de Anúncios passa a mostrar compras e leads por anúncio, e a Meta otimiza a entrega para pessoas com mais chance de comprar. Para ver de qual anúncio cada cliente veio, veja Anúncios.

Antes de começar

  • WhatsApp Oficial (API Cloud) — suporte completo: a conta do WhatsApp Business (WABA) e o token vêm da própria caixa.
  • Api Web — funciona quando a conexão recebe os dados do anúncio e o número tem uma WABA: se a caixa Api Web está vinculada a uma caixa oficial do mesmo número (aba API Web da caixa oficial, veja Limites de mensagens e gastos), a WABA e o token da caixa oficial são usados sozinhos; se não, informe a WABA e um token. Um número comum do WhatsApp Business, sem WABA, não envia conversões.
  • Token com permissão de eventos — a Meta exige whatsapp_business_management e whatsapp_business_manage_events. O token da conexão oficial costuma bastar; se a Meta recusar, crie um token de usuário do sistema no Gerenciador de Negócios com as duas permissões.

1. Configurar a caixa de entrada

Em Configurações → Caixas de Entrada, abra a caixa (engrenagem) e entre na aba Conversões Meta.

  1. Ligue Reportar à Meta as conversões desta caixa.
  2. Em Credenciais, confira o ID da conta do WhatsApp Business (WABA) — na caixa oficial ele vem preenchido — e deixe o Token de acesso em branco para usar o do canal. Cole um token dedicado só se a Meta recusar o do canal.
  3. Em Dataset, clique em Obter dataset. Deu certo quando aparece "Dataset 123…, vinculado em…".
  4. Em Resultados de negócios, escolha o evento enviado sozinho quando o resultado de uma conversa da caixa mudar: Negócio ganho (por exemplo, Compra) e Negócio em negociação (por exemplo, Lead qualificado). Não reportar desliga cada um.
  5. Clique em Salvar.

Aba Conversões Meta da caixa de entrada

O topo da aba mostra Pronto quando dataset, token e WABA foram encontrados, ou Não está pronto com o que falta. Se a Meta recusou o token em algum envio, o topo diz Pronto, mas a Meta recusou o token em… com a mensagem da Meta (veja Quando a Meta recusa o token).

Testar, abrir na Meta e remover

Com o dataset vinculado, a seção Dataset ganha três ações:

  • Testar conexão — pergunta à Meta se o token atual ainda acessa o dataset. "A Meta aceitou o token" confirma que está tudo certo; uma recusa mostra o motivo da Meta.
  • Abrir no Gerenciador de Eventos — abre o dataset da sua conta do WhatsApp Business na Meta, onde você vê os eventos recebidos e a atribuição aos anúncios.
  • Desvincular dataset — a caixa para de enviar até você clicar em Obter dataset de novo.

Ações do dataset, regra pronta e remoção

Em Credenciais, Remover token apaga o token dedicado (a caixa volta a usar o do canal, se houver). No fim da aba, Remover configuração apaga token, dataset e o mapeamento de negócios da caixa; os envios já feitos continuam no relatório. As três ações pedem confirmação e ficam registradas no registro de auditoria.

Regra pronta: todo lead de anúncio

Em Automação, o botão Criar regra de lead de anúncio cria uma regra de automação que reporta à Meta como Lead enviado toda conversa nova que veio de um anúncio desta caixa. É o que a Meta usa para otimizar os anúncios por leads. A regra aparece em Configurações → Automações com o nome Lead de anúncio — nome da caixa, e pode ser editada ou apagada lá como qualquer outra.

🔐 Trocar o token é uma troca de credencial: se a conta exige a verificação em duas etapas para essas ações, a plataforma pede o código.

2. Escolher quando reportar

As formas abaixo podem ser combinadas. Todas usam o clique do anúncio que iniciou (ou retomou) a conversa; uma conversa que não veio de anúncio não envia nada.

Pelo resultado do negócio — com o mapeamento do passo 4, basta a equipe marcar Ganho (ou Em negociação) na seção Resultado da conversa, ou mover o card para a etapa de ganho no Kanban. O valor do negócio vai junto, na moeda da conta. Veja Status da conversa.

Por automação ou macro — nas automações e macros, a ação Reportar conversão à Meta pede o Evento da Meta e o Valor do evento (Sem valor, Valor do negócio ou Valor fixo). Exemplos:

Quando Ação
Conversa resolvida + É uma Mensagem de anúncio = sim Reportar Lead qualificado
Conversa atualizada + etiqueta pedido-fechado Reportar Compra com o valor do negócio
Macro Pedido criado, usada ao lançar o pedido no sistema Reportar Pedido criado

As condições de Atributos do anúncio valem em qualquer evento da automação, não só em Mensagem criada. Ao montar uma regra com Reportar conversão à Meta sem a condição É uma Mensagem de anúncio, o editor avisa: a regra roda em todas as conversas, mas só as que vieram de anúncio são enviadas; as outras aparecem em Não enviadas no relatório.

Por etapa do Kanban — nas Automações da etapa, adicione Reportar conversão à Meta em Quando um card entra, sai ou fica parado, com o evento e o valor. Exemplo: card entrou em Proposta aceita → Compra com o valor do negócio.

Manualmente — no cartão Mensagem de anúncio da conversa, clique em Reportar conversão, escolha o Evento, informe o Valor (obrigatório para Compra) e clique em Enviar à Meta. A janela também lista os Eventos enviados da conversa, com o status (Pendente, Enviado ou Falhou).

Reportar conversão à Meta

Eventos disponíveis

  • Compra — o lead comprou. Exige valor e é o que mais ajuda a Meta a otimizar para vendas.
  • Lead qualificado, Lead enviado — a equipe confirmou a oportunidade; o contato deixou os dados.
  • Checkout iniciado, Adicionado ao carrinho, Conteúdo visualizado, Carrinho abandonado — a jornada de compra.
  • Pedido criado, enviado, entregue, cancelado e devolvido — o andamento do pedido.
  • Avaliação (nota) enviada e Avaliação (comentário) enviada.

Regras

  • Uma vez por clique — cada evento sai uma vez para cada clique em anúncio; uma automação que roda de novo não duplica. Se o cliente voltar por outro anúncio, é um clique novo. O botão manual pode repetir um evento.
  • Compra sem valor não sai — a Meta recusa; a ação com Compra exige Valor do negócio ou Valor fixo.
  • Até 7 dias — a Meta só aceita conversões de até 7 dias atrás.
  • Cada envio fica registrado como atividade na conversa, com a origem (automação, macro, negócio, Kanban ou quem clicou).

3. Acompanhar os envios

Em Relatórios → Anúncios, abra a aba Conversões Meta (ou use Ver as conversões enviadas e as falhas na aba da caixa):

Conversões Meta no relatório de anúncios

  • Enviadas à Meta, Com falha, Na fila e Valor reportado no período, e na faixa de apoio o total de envios, conversas, cliques de anúncio, envios manuais e Não enviadas;
  • Conversões por evento da Meta e Por que os envios falharam (passe o mouse no motivo para ver o que fazer);
  • Por que não foram enviadas — o que as automações, macros, negócios e etapas do Kanban tentaram reportar e a plataforma não enviou, por motivo (sem clique de anúncio, sem valor, caixa não pronta, duplicado…) e por origem, com o nome da regra, macro ou etapa. Antes isso só aparecia nos registros do servidor;
  • envios e valor por dia, por caixa de entrada, por anúncio e por origem;
  • a lista Envios, com o link da conversa, o anúncio, e Reenviar para falhas dos últimos 7 dias, e a exportação em CSV ou XLSX (com o anúncio nas duas últimas colunas).

Por que não foram enviadas

Por anúncio responde qual anúncio gerou compras e quanto: para cada anúncio, as Conversas do anúncio no período, quantas Converteram (tiveram ao menos um envio aceito), a Taxa, as Enviadas e o Valor reportado. Clique no anúncio para abrir a aba Anúncios filtrada por ele.

Conversões por anúncio

💡 Enviada à Meta significa que a Meta aceitou o evento. Quantas conversões ela atribuiu a cada anúncio aparece no Gerenciador de Eventos (dataset da sua conta do WhatsApp Business), com um link por caixa na nota do relatório, e no Gerenciador de Anúncios.

💡 Uma Compra que não saiu por falta de valor também deixa uma atividade na conversa, para a equipe preencher o valor do negócio.

Quando a Meta recusa o token

Quando um envio falha porque a Meta recusou o token ou a permissão, a plataforma avisa sem esperar alguém abrir o relatório:

  • os administradores recebem um e-mail "A Meta recusou o token das conversões da caixa…", no máximo um por caixa por dia (a preferência fica em Perfil → Notificações, grupo Integrações);
  • a aba Conversões Meta da caixa mostra Pronto, mas a Meta recusou o token em… com a mensagem da Meta;
  • o relatório mostra um aviso no topo com o link Verificar a caixa.

Aviso de token recusado na caixa

O que fazer: troque o token (ou reconecte a caixa oficial, se o token recusado era o do canal), clique em Testar conexão para confirmar e use Reenviar na lista de envios do relatório para as falhas dos últimos 7 dias. Um envio aceito limpa o aviso sozinho.

Problemas comuns

O que aparece O que fazer
Obter dataset recusado Token sem whatsapp_business_manage_events: crie um token de usuário do sistema e cole em Token de acesso
Botão Reportar conversão não aparece Caixa não está Pronta, a conversa não veio de anúncio (ou sem código do clique) ou falta Gerenciar relatórios
Falha Token recusado pela Meta Token expirado ou revogado: reconecte a caixa oficial ou troque o token, confira com Testar conexão e use Reenviar (veja Quando a Meta recusa o token)
Falha Caixa não estava pronta As conversões da caixa estavam desligadas ou incompletas na hora: confira a aba Conversões Meta
Automação rodou e nada foi enviado Veja Por que não foram enviadas no relatório: a conversa não veio de anúncio, o evento já tinha saído para aquele clique ou faltou o valor da Compra
Preciso apagar um token ou dataset Remover token, Desvincular dataset ou Remover configuração na aba Conversões Meta da caixa

Boas práticas

  • Comece por Negócio ganho → Compra, com a equipe registrando o valor ao marcar Ganho.
  • Reporte Lead qualificado num momento claro do processo (uma etapa do Kanban, uma etiqueta), igual para todos.
  • Confira a aba Conversões Meta toda semana e reenvie as falhas antes dos 7 dias.
  • Reporte só resultados reais: eventos inflados fazem a Meta otimizar para o público errado.