Resultados e orçamento

O WhatsApp só vale a pena se der para medir. Esta seção reúne as rotas de resultados da API de administração: quantas mensagens saem e são lidas, quanto a Meta cobra, quantos cliques viram pedidos, quais anúncios compensam, como vão as campanhas e quanto da verba mensal já foi gasto. Tudo é da loja inteira, somando todos os números de WhatsApp e todos os sellers.

Como funciona

1. Veja o panorama
   Visão geral, funil e anúncios mostra volume, taxa de leitura e a conversão do clique ao pedido.
2. Controle o custo
   Custos e uso mensal separa mensagens de serviço, templates e pontos de entrada gratuitos, e estima o que passa da franquia.
3. Defina um teto
   Em Orçamento mensal, fixe o limite do mês e, se quiser, pare as campanhas ao atingi-lo.
4. Compare as campanhas
   Desempenho das campanhas mostra as 20 com mais envios e o custo estimado de cada uma.

Conceitos-chave

Categorias de mensagem da Meta

A Meta cobra por mensagem e o preço depende da categoria.

Origem da mensagem

Cada mensagem tem uma origem de uma letra. Ela aparece em by_origin e nos relatórios de economia.

Coexistência e economia

Quando uma pessoa responde pelo aplicativo WhatsApp Business (origem E), a mensagem não passa pela API e não gera custo de serviço. Em Custos o campo savings estima quanto isso economiza.

Fuso e datas

O relatório de uso mensal conta dias e mês em America/Sao_Paulo. Os demais campos de data vêm em RFC 3339 (UTC) ou como YYYY-MM-DD.

Endpoints

Erros comuns

• Tratar 404 disabled como rota inexistente. É o recurso de analytics desligado na loja; ligue enable_analytics nos ajustes.
• Passar month=2026-9. O uso mensal exige dois dígitos (2026-09); sem eles vem 400.
• Somar cost_cents e estimate_micros como se fossem a mesma unidade. Um é centavos, o outro milionésimos de real.
• Esperar uma janela de datas. days conta para trás a partir de agora; não existe from/to.
• Gravar o orçamento sem reenviar tudo. O PUT substitui o orçamento inteiro: o limite omitido é removido e alert_thresholds omitido vira null.
• Achar que o teto rígido bloqueia o atendimento. Ele só pausa campanhas.
• Conciliar a fatura da Meta com estes números. São estimativas por tabela de tarifas.

Próximos passos