Visão geral
A Calculadora de custo de disparo mostra quanto uma campanha de WhatsApp vai custar antes de enviar e quanto ela custou depois. O cálculo se baseia na tarifa por mensagem que a Meta cobra por categoria de template (marketing, utilidade e autenticação) e no país do destinatário, convertida de USD para BRL pela cotação do dia.
Apenas o WhatsApp Cloud é cobrado pela Meta. As caixas de WhatsApp Web não têm cobrança da Meta por mensagem, então aparecem como sem custo (
billable: false).
A plataforma usa esse mesmo número em dois lugares: a calculadora (uma simulação "e se") e a estimativa de custo do público que aparece no compositor da campanha.
Pré-requisitos
- Acesso ao módulo Campanhas.
- Para custo cobrado: uma caixa de entrada de WhatsApp Cloud conectada (Web não gera custo Meta).
- A categoria do template definida na campanha — marketing, utilidade ou autenticação. É a categoria que determina a tarifa por mensagem.
Passo a passo
- Abra Campanhas na barra lateral.
- Abra a Calculadora de disparo (botão da calculadora na tela de campanhas).
- Escolha o país dos destinatários no seletor (ex.: BR, US, MX...).
- Para cada categoria (marketing, utilidade, autenticação), informe a quantidade de mensagens.
- Veja, por linha, a tarifa por mensagem (em USD) e o total em BRL.
- Confira o custo total estimado em destaque (USD e BRL) e o número de mensagens cobráveis.
No compositor da campanha, ao definir a audiência e a categoria, a plataforma também mostra o custo estimado do público resolvido (etiquetas, contatos específicos, segmentos salvos ou todos), já em BRL.
Configurações & opções
- Tarifas por categoria (USD): cada categoria tem uma tarifa por mensagem por país, conforme a tabela oficial da Meta de 2026.
- Conversão USD → BRL: usa a cotação ao vivo do dia (cache de ~1h). Use Atualizar para buscar uma cotação nova ignorando o cache, ou Ajustar para informar manualmente uma taxa "e se".
- Origem da cotação: o selo indica se a taxa é ao vivo, estimada (fallback quando a cotação não está disponível) ou manual.
- Tarifa editável pelo admin (override): a Meta não tem API de preços, então um administrador pode editar a tarifa por categoria/país com o preço real negociado. A linha ganha o selo personalizada. Deixar o campo da tarifa em branco e salvar restaura a tarifa oficial/ sincronizada.
- Sincronizar (oficial): lê a tabela de tarifas publicada pela Meta (o arquivo CSV "Rates in USD" da página de preços para desenvolvedores) e atualiza as tarifas por país e categoria. As linhas atualizadas passam a aparecer com origem sincronizada. Um override do administrador continua vencendo a tarifa sincronizada — sincronizar não apaga o preço que você negociou. Se a leitura falhar, nada é alterado: a tabela editável/base continua valendo.
- Fonte alternativa de tarifas: se preferir alimentar as tarifas por conta própria, aponte a
variável de ambiente
WHATSAPP_PRICING_SOURCE_URLpara um endpoint JSON ou CSV com a tarifa por país e categoria. A plataforma usa essa fonte no lugar da página oficial. - Estimativa de custo do público (no compositor): ao escolher audiência + categoria, a plataforma resolve os contatos com telefone e devolve o custo estimado em BRL e se é cobrável.
- Custo estimado vs. custo real na campanha: a campanha guarda o custo estimado
(
estimated_cost), o custo real (actual_cost) e a moeda (currency, padrão BRL). O custo estimado é gravado na criação (apenas Cloud); o custo real vai sendo acumulado conforme as mensagens cobráveis (entregues/lidas/respondidas) são contabilizadas.
Casos de uso
- Orçar uma promoção: simule 10.000 mensagens de marketing para o Brasil e veja o total em BRL antes de aprovar.
- Comparar categorias: veja a diferença de preço entre marketing, utilidade e autenticação para escolher o melhor formato.
- Validar a cobrança: registre o preço real negociado com a Meta na tarifa editável e compare o custo estimado com o custo real ao fim da campanha.
Dicas, limites e boas práticas
- WhatsApp Web não tem custo Meta: linhas e campanhas de Web aparecem como sem custo
(
billable: false) e não somam ao orçamento. - Restaurar a tarifa oficial: para desfazer um override, deixe o campo da tarifa em branco e salve — isso volta para a tarifa oficial/sincronizada.
- Tarifa = preço real: como a Meta não expõe preços por API, mantenha a tarifa editável alinhada ao seu contrato para que a estimativa fique fiel à fatura.
- Cotação: se a taxa estiver marcada como estimada, é um fallback — atualize para obter a cotação ao vivo antes de fechar um orçamento.
Solução de problemas
- Custo aparece R$ 0 ou ausente: a campanha é de WhatsApp Web (sem cobrança Meta) ou o público é muito grande e ultrapassou o limite de estimativa (acima de ~5.000 contatos), caso em que a estimativa é omitida para não travar a criação — o custo real ainda é contabilizado durante o envio.
- A tabela não sincroniza: a mensagem diz por quê — a fonte respondeu com erro, não pôde ser
acessada, ou respondeu sem tarifas legíveis. Em todos os casos a plataforma mantém a tabela
editável/base como fonte de verdade. Se persistir, aponte
WHATSAPP_PRICING_SOURCE_URLpara um endpoint JSON/CSV próprio ou ajuste a tarifa manualmente. - Sincronizei e a tarifa não mudou: existe um override do administrador para aquele país e categoria — o override vence a tarifa sincronizada. Deixe o campo em branco e salve para restaurar.
- Cotação marcada como "estimada": a cotação ao vivo não estava disponível; use Atualizar ou informe uma taxa manual.