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

1. Abra **Campanhas** na barra lateral.
2. Abra a **Calculadora de disparo** (botão da calculadora na tela de campanhas).
3. Escolha o **país** dos destinatários no seletor (ex.: BR, US, MX...).
4. Para cada **categoria** (marketing, utilidade, autenticação), informe a **quantidade** de mensagens.
5. Veja, por linha, a **tarifa por mensagem** (em USD) e o **total em BRL**.
6. 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_URL` para 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_URL` para 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**.

## Veja também

- [Campanha de WhatsApp para listas de contatos](/hc/ajuda/articles/campaigns-whatsapp-campaign-pt-br)
- [Templates HSM e variáveis](/hc/ajuda/articles/campaigns-templates-hsm-variaveis-pt-br)
- [Visão geral de Campanhas](/hc/ajuda/articles/campaigns-overview-pt-br)