WhatsApp Oficial (API Cloud)

Modelos de mensagem, custos, limites e saúde da conta oficial

Por Central de Ajuda and 1 outro

• 6 artigos

Modelos de mensagem do WhatsApp (templates)

No WhatsApp Oficial (API Cloud), a Meta exige modelos de mensagem aprovados (templates) para: Iniciar uma conversa com um cliente; Responder quando já se passaram mais de 24 horas desde a última mensagem do cliente; Enviar campanhas. Dentro das 24 horas após a última mensagem do cliente, você conversa normalmente, com mensagens livres. Categorias Cada modelo tem uma categoria, que define o preço cobrado pela Meta: Marketing — ofertas, novidades, convites. Utilidade — confirmações de pedido, atualizações de entrega, lembretes. Autenticação — códigos de verificação. Ver e sincronizar os modelos Vá em Configurações → Modelos de Mensagem. A lista mostra os modelos de cada caixa do WhatsApp Oficial com a categoria, o idioma e o status (Aprovado, Pendente, Rejeitado...). Filtre por caixa, status e categoria, ou busque pelo nome ou conteúdo. Sincronizar Modelos — busca na Meta os modelos novos ou alterados (por exemplo, criados direto no Gerenciador do WhatsApp). Habilitado para envio — a chave de cada modelo define se ele aparece para os agentes na hora de enviar. Criar um modelo 🔒 Disponível para administradores e tipos de agente com a permissão de gerenciar modelos. Clique em Criar Modelo. Em Informações Básicas, preencha o Nome do Modelo (apenas letras minúsculas, números e sublinhado — ex.: confirmacao_pedido), escolha a(s) caixa(s) de entrada, a Categoria e o Idioma. Escolha o Formato de Parâmetros: Positional ({{1}}, {{2}}) ou Named ({{nome}}). Avance para o Conteúdo: cabeçalho (texto, imagem, vídeo ou documento), corpo da mensagem com as variáveis, rodapé e botões (resposta rápida, link, telefone). A pré-visualização mostra como o cliente vai ver. Confira a etapa Visualização e clique em Enviar Modelo. O modelo vai para aprovação da Meta, que costuma responder em minutos, mas pode levar até 24 horas. 💡 Dicas para aprovação: escreva de forma clara, sem erros, e dê exemplos realistas para as variáveis. Modelos de marketing disfarçados de utilidade costumam ser reclassificados ou rejeitados. Enviar um modelo na conversa Quando a janela de 24 horas está fechada, a conversa mostra o aviso "Você só pode responder a esta conversa usando um modelo de mensagem" e o botão Enviar Template: Clique em Enviar Template. Escolha o modelo (filtre por categoria, idioma ou tipo). Preencha as variáveis — por exemplo, o nome do cliente e o número do pedido. A pré-visualização mostra a mensagem final. Os campos aceitam as mesmas variáveis das respostas prontas, como {{contact.first_name}}, que são trocadas pelos dados do contato no envio. Isso vale também para modelos enviados por campanhas e pela API. Clique em Enviar Mensagem. Quando o cliente responder, a janela de 24 horas abre de novo e você volta a conversar livremente. Para iniciar uma conversa nova, use Nova Mensagem no contato, escolha a caixa do WhatsApp Oficial e selecione o modelo. Histórico do modelo O botão Histórico de cada modelo mostra tudo o que aconteceu com ele: criação, envio para a Meta, análise, aprovação, mudanças de categoria e de qualidade, com quem fez cada coisa. Quando a Meta muda a categoria de um modelo, você recebe um alerta. Veja Histórico dos modelos do WhatsApp e alertas de categoria. Qualidade dos modelos A Meta avalia a qualidade de cada modelo pela reação dos clientes (bloqueios, denúncias). Modelos com qualidade baixa podem ser pausados. Veja Notificações de qualidade e status do WhatsApp.

Última atualização em Oct 29, 2026

Limites de mensagens e gastos no WhatsApp Oficial

O controle de limites permite que a sua equipe acompanhe o consumo de mensagens cobradas pela Meta na conexão oficial do WhatsApp e defina até onde os envios podem ir. Você pode limitar a caixa de entrada inteira ou cada conversa, escolher quando receber avisos e decidir se os envios devem ser bloqueados ao passar dos limites. ⚠️ Essas configurações são controles internos da plataforma. Elas não alteram preços, faturas ou regras de envio da Meta. Os valores de gasto são estimativas em dólar (USD) e não substituem a conferência da fatura da Meta. 1. Onde configurar 🔒 Disponível para administradores. Acesse Configurações → Caixas de Entrada. Abra a caixa do WhatsApp Oficial (engrenagem). Selecione a aba Limites de cobrança. Ligue Ativar limites de cobrança nesta caixa de entrada. Preencha os campos desejados e clique em Salvar limites, no fim da página. Se a aba não aparecer, fale com o suporte: o recurso precisa estar habilitado na sua conta. 2. Avisar ou bloquear Em Quando um limite for atingido, escolha: Apenas avisar — a plataforma avisa sobre o consumo, mas permite o envio mesmo acima do limite. Avisar e bloquear envio — avisa quando o consumo se aproxima do limite e bloqueia os envios que o ultrapassariam. Em Avisar em (% do limite), defina a partir de quanto do limite os avisos começam (padrão: 80%). Exemplo: com limite de 100 mensagens e aviso em 80%, o aviso aparece ao chegar a 80 mensagens — já considerando a próxima mensagem a ser enviada. 3. Cota gratuita de mensagens de serviço da Meta A partir de 01/10/2026, a Meta cobra as mensagens de serviço (as respostas livres, sem modelo) pela tarifa de utilidade de cada país. Cada número tem 1.000 mensagens de serviço grátis por mês, e só contam as enviadas pela API oficial. Esta seção mostra quantas mensagens de serviço já foram usadas no mês, se a Meta informou uma forma de pagamento para o número e o fuso usado para contar o mês. A plataforma avisa os administradores quando a cota está acabando, mas nunca bloqueia um envio por causa dela. ⚠️ Se a Meta informar que o número não tem forma de pagamento no Billing Hub, as mensagens de serviço podem deixar de ser entregues quando a cota gratuita acabar. Regularize a forma de pagamento no Gerenciador de Negócios da Meta. 4. Desvio automático para o Api Web Se o mesmo número também está conectado por QR Code (uma caixa Whatsapp Web vinculada na aba API Web da caixa oficial), você pode economizar a cota: depois de usar a parte da cota que você escolher, as mensagens de serviço passam a sair pelo Api Web, no mesmo número, sem custo e sem gastar a cota. Em Política da cota, escolha: Desligada — nenhum desvio: as mensagens de serviço sempre saem pela API oficial. Cota do mês — as 1.000 mensagens do mês saem pela API oficial; depois, pelo Api Web até o fim do mês. Cota diária distribuída — a cota de cada dia é o que sobra do mês dividido pelos dias que faltam (contando hoje). O que um dia não usa passa para os seguintes. Cota diária fixa — um número fixo de mensagens de serviço por dia pela API oficial; depois, pelo Api Web até a meia-noite. O desvio vale para respostas de agentes, robôs, assistente de IA e automações. Modelos de mensagem, campanhas e envios em massa continuam pela API oficial. Para vincular o Api Web, abra a aba API Web nas configurações da caixa oficial e escolha a caixa Whatsapp Web do mesmo número. 5. Limites da caixa de entrada Os limites somam o consumo de todas as conversas da caixa — não são por agente nem por contato. Quantidade de mensagens cobráveis por categoria — Marketing, Utilidade, Autenticação e Serviço, por dia e por mês. A categoria é a cadastrada no modelo usado. Limite de gasto (USD) — teto de gasto diário e mensal da caixa inteira. Mensagens que não são cobradas não entram na contagem — portanto, este não é um limite geral de mensagens. Período O que conta Quando reinicia Diário O dia atual À meia-noite Mensal O mês do calendário À meia-noite do dia 1 Ciclo de faturamento Do dia de fechamento escolhido até o próximo À meia-noite do dia escolhido Os horários seguem o fuso horário configurado na caixa de entrada. Campos vazios e zero: Vazio / "Sem limite" — sem restrição. Zero — limite zero: bloqueia os envios daquela categoria (no modo de bloqueio). Para remover uma restrição, apague o valor e salve; não use zero para "sem limite". Dia de fechamento personalizado Ligando Usar dia de fechamento personalizado, você escolhe o dia de início do ciclo (1 a 28) e ganha uma coluna Ciclo de faturamento, com quantidades por categoria e limite de gasto para o ciclo. O ciclo é um período adicional — os limites diário e mensal continuam valendo. Exemplo: com ciclo no dia 15, os períodos vão de 15/09 a 14/10, depois de 15/10 a 14/11, e assim por diante. 6. Limites por conversa Além dos limites da caixa, você pode limitar cada conversa: quantidade total de mensagens cobráveis, gasto em USD e, opcionalmente, quantidades por categoria. Em Medir por: Ciclo atual — o consumo recomeça quando a conversa é reaberta. Conversa inteira — o consumo total da conversa, sem reinício. O ciclo da conversa é diferente do ciclo de faturamento da caixa. Reabrir uma conversa não reinicia os limites diário, mensal ou do ciclo da caixa. 7. Como os limites funcionam juntos Todos os limites configurados são avaliados ao mesmo tempo. No modo Avisar e bloquear envio, ultrapassar qualquer um impede o envio. Exemplo (Marketing): limite diário de 4 e mensal de 10. A 5ª mensagem do dia é bloqueada. No dia seguinte o diário renova, mas o mensal acumula; ao chegar a 10 no mês, os envios são bloqueados mesmo com o diário disponível. 8. Avisos para os agentes Ao abrir uma conversa, a plataforma verifica os limites e mostra um aviso acima das mensagens: Amarelo — perto ou acima do limite no modo Apenas avisar (o envio continua permitido). Vermelho — envio bloqueado nas categorias indicadas. O aviso mostra a categoria, uma barra com o consumo, o teto, a projeção com a próxima mensagem e a data de renovação. Se houver mais de um limite ativo, clique em Ver detalhes para ver cada um em um cartão. Ao escolher um modelo de mensagem, a plataforma confere os limites daquele modelo. O aviso é atualizado a cada minuto. Notas privadas e mensagens enviadas pelo Api Web não consomem estes limites. 9. Acompanhamento e bloqueios Na seção Uso atual, o administrador acompanha o consumo de cada período, incluindo os envios que a Meta ainda não confirmou. Quando um envio for bloqueado: Leia o aviso e identifique a categoria e o limite responsável. Clique em Ver detalhes para conferir os outros limites ativos. Veja se o período renova automaticamente e quando. Para continuar antes da renovação, peça ao administrador para revisar os limites (aumentar, remover ou mudar para Apenas avisar). Os administradores recebem e-mails quando um limite está perto de ser atingido e quando é atingido (configuráveis em Configurações do Perfil → Notificações → Notificações do sistema). Os custos detalhados ficam no relatório Relatórios → Insights do WhatsApp.

Última atualização em Oct 09, 2026

Qualidade e status do número no WhatsApp Oficial

A plataforma acompanha automaticamente a saúde da sua conta e dos seus modelos no WhatsApp Oficial. Quando a Meta identifica um problema — queda na qualidade de um modelo, número sinalizado ou conta banida — os administradores recebem um e-mail automático para agir antes que os envios sejam afetados. Não é preciso configurar nada: o monitoramento funciona sozinho para todas as caixas do WhatsApp Oficial. Status do número Para ver a situação do número a qualquer momento, abra Configurações → Caixas de Entrada, clique na engrenagem da caixa do WhatsApp Oficial e escolha a aba Status do número. Resumo — Operacional, Requer atenção ou Envio bloqueado, com a quantidade de verificações em ordem. Status do telefone, Classificação de qualidade (verde, amarela ou vermelha), Nível de limite de mensagens (quantas conversas o número pode iniciar por dia) e Taxa de transferência. Identidade — nome de exibição aprovado, modo da conta, se o número também está no app WhatsApp Business (coexistência) e desde quando está conectado. Prontidão para envio — capacidade de envio, webhook, registro do telefone, aplicativo inscrito e verificação da empresa. Use Atualizar para consultar a Meta novamente e Ir para o Meta Business Manager para resolver pendências na própria Meta. Quem recebe os alertas? Todos os usuários com perfil de Administrador na conta. Quais eventos geram alerta 1. Qualidade de modelo caiu Quando um modelo ativo cai para qualidade BAIXA (vermelha) segundo a Meta, os administradores recebem um e-mail com o nome do modelo e um link para a página de modelos. O que fazer: revise o conteúdo do modelo. Modelos com qualidade baixa podem ser pausados ou desativados pela Meta, impedindo o envio. 2. Número sinalizado (flagged) Quando a Meta sinaliza o número por excesso de volume ou baixa taxa de resposta. O que fazer: reduza o volume de mensagens em massa e acompanhe as métricas no Gerenciador de Negócios da Meta. Números sinalizados têm limites de envio menores. 3. Conta banida ou desconectada pela Meta Quando a Meta bane a conta do WhatsApp Business, ou quando ela é desconectada pelo aplicativo WhatsApp Business, a plataforma: marca a caixa de entrada como precisando de reautorização — um aviso aparece na lista de caixas e na conversa, com o botão Verificar conexão; envia um e-mail aos administradores. As mensagens recebidas continuam chegando normalmente enquanto isso. O que fazer: abra a caixa e use Verificar conexão. Se o banimento for permanente, entre em contato com o suporte da Meta. Status dos modelos A plataforma atualiza o status dos modelos automaticamente quando a Meta envia mudanças. Os status possíveis são: Aprovado — pronto para uso. Pendente — aguardando análise da Meta. Rejeitado — não aprovado; o motivo fica registrado na plataforma. Pausado — pausado temporariamente pela Meta por qualidade baixa. Desativado — fora de uso; precisa ser recriado. Veja mais em Modelos de mensagem do WhatsApp. Não recebi o e-mail — o que verificar? Confirme que o seu usuário é Administrador na conta. Verifique a pasta de spam / lixo eletrônico. Confira o e-mail cadastrado em Configurações do Perfil. Em Configurações do Perfil → Notificações → Notificações do sistema, verifique se os alertas do WhatsApp estão ligados.

Última atualização em Oct 29, 2026

Ligações pelo WhatsApp Oficial e histórico de chamadas

🔒 Configurar: administradores. Ligar e atender: agentes da caixa de entrada. Histórico de chamadas: administradores e agentes com a permissão Visualizar histórico de ligações e baixar gravações no tipo de agente. Disponível só para caixas do WhatsApp Oficial (API Cloud). Se a aba Ligações não aparecer, o recurso ainda não está ativo na sua conta — fale com o suporte. Com as ligações ativas, o agente faz e recebe chamadas de voz pelo WhatsApp direto no navegador, sem celular, e cada chamada fica registrada na conversa do cliente. Ativar na caixa de entrada Vá em Configurações → Caixas de Entrada → caixa do WhatsApp Oficial → aba Ligações. Permitir ligações de voz — liga o recurso para o número. Os clientes passam a poder ligar para a empresa e a empresa para eles. Permitir retornos de ligação — se ninguém atender, o cliente pode pedir que a empresa retorne. Exibir botões de ligação — mostra o botão de ligar no perfil do número no WhatsApp. Mesmo desligado, o cliente ainda liga a partir de uma mensagem com botão de ligação. Horário disponível para ligações e pausas temporárias (feriados) são configurados no WhatsApp Manager da Meta, pelo link Configurar. 💡 A Meta exige alguns pré-requisitos do número: estar ativo na API Cloud, ter a permissão de chamadas liberada e um limite de envio de pelo menos 2.000 contatos por dia. Se a aba mostrar um erro de "pré-requisitos técnicos", fale com o suporte. Receber uma chamada Quando o cliente liga, todos os agentes da caixa veem o aviso Chamada recebida… com Aceitar e Rejeitar. Quem aceita primeiro atende; os outros veem Aceito por outro usuário. Durante a chamada dá para silenciar o microfone e desligar. Se ninguém atender, a chamada fica como perdida no histórico e, com os retornos ativos, o cliente pode pedir um retorno. Ligar para o cliente Abra a conversa e clique no telefone no topo. O WhatsApp só permite que a empresa ligue para quem autorizou receber ligações. Antes da primeira chamada, envie uma solicitação de permissão de chamada: em Configurações → Modelos de Mensagem, use a sugestão Solicitação de permissão de chamada (um modelo com a opção de mesmo nome marcada) e envie-o na conversa — veja Modelos de mensagem. Quando o cliente aceita, a conversa mostra uma atividade com a permissão concedida (permanente ou temporária) e o botão de ligar passa a funcionar. Sem permissão, a plataforma avisa antes de tentar. Cada chamada aparece na conversa como uma atividade Chamada de voz, com a direção (recebida ou realizada), o resultado (concluída, perdida, rejeitada, ocupado) e a duração. Histórico de chamadas O relatório Relatórios → Histórico de Chamadas reúne todas as chamadas da conta. Indicadores — total, atendidas, perdidas, recebidas, realizadas e duração média, no período escolhido. Filtros — período, caixa de entrada, direção e status. Lista — data, direção, contato, status, duração, provedor, caixa, link para a conversa e, quando existe, a gravação para ouvir ou baixar. Limites que a Meta aplica Até 100 chamadas realizadas por dia para o mesmo cliente. Quatro chamadas seguidas não atendidas revogam a permissão daquele cliente; peça de novo com o modelo. Chamadas iniciadas pela empresa não estão disponíveis para alguns países. Veja também Conectar o WhatsApp Oficial e Limites de cobrança.

Última atualização em Oct 09, 2026

WhatsApp Flows: formulários interativos no WhatsApp Oficial

🔒 Enviar: agentes da caixa. Modelos com botão de Flow: administradores. Disponível só no WhatsApp Oficial (API Cloud); se o botão não aparecer, o recurso ainda não está ativo na sua conta — fale com o suporte. Um WhatsApp Flow é um formulário que abre dentro do próprio WhatsApp do cliente — agendamento, cadastro, pesquisa de satisfação, escolha de produto — sem link externo. O cliente preenche e envia, e a resposta chega na conversa como uma mensagem dele. O formulário em si (telas, campos, regras) é criado e publicado no Flow Builder da Meta, no WhatsApp Manager da sua conta. A plataforma faz o envio e recebe as respostas. Enviar um Flow na conversa Dentro da janela de 24 horas (o cliente mandou mensagem há menos de um dia), o botão WhatsApp Flow (ícone de formulário) aparece na barra do editor de resposta. Em Identificar o flow por, deixe Catálogo e escolha o Flow na lista — são os Flows publicados na conta do WhatsApp dessa caixa. O botão ⟳ sincroniza a lista com a Meta; se preferir, informe o ID ou o nome do Flow. Texto do botão (CTA) — o que o cliente clica para abrir o formulário (até 30 caracteres, por exemplo Agendar visita). Mensagem — o texto acima do botão. Cabeçalho e rodapé são opcionais. Opções avançadas — a tela inicial do Flow e dados iniciais em JSON, quando o formulário espera algo (nome do produto, pedido). Clique em Enviar. Um Flow marcado como rascunho é enviado em modo de rascunho, para testes; publique-o no Flow Builder antes de usar com clientes. Enviar fora da janela de 24 horas Passado um dia sem resposta do cliente, só um modelo de mensagem chega até ele. Crie um modelo com um botão do tipo WhatsApp Flow (em Botões, informe o ID do Flow e, se quiser, a tela inicial), aguarde a aprovação da Meta e envie o modelo pela conversa ou em uma campanha. O cliente abre o formulário pelo botão do modelo. A resposta do cliente Quando o cliente envia o formulário, a conversa recebe uma mensagem Resposta do Flow com cada campo e o valor preenchido. Ela conta como mensagem do cliente: reabre a janela de 24 horas, dispara as automações e aparece no histórico como qualquer outra. 💡 Um Flow é uma mensagem de serviço: entra na cota gratuita da Meta como uma resposta comum, mas nunca é desviado para o Api Web pela política de cota (o Api Web não exibe o formulário). Veja Limites de cobrança.

Última atualização em Oct 09, 2026

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

🔒 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. Ligue Reportar à Meta as conversões desta caixa. 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. Em Dataset, clique em Obter dataset. Deu certo quando aparece "Dataset 123…, vinculado em…". 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. Clique em Salvar. 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. 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). 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): 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 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. 💡 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. 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.

Última atualização em Oct 29, 2026