VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa/WhatsApp: resultados

Uso e custos

Quanto o WhatsApp custa na Meta, a projeção com as tarifas de outubro de 2026 e o uso mensal de mensagens por categoria.

A Meta cobra por mensagem, e a conta depende da categoria: mensagens de serviço (respostas dentro da janela de 24 horas), templates de marketing, utilidade ou autenticação, e mensagens dentro de um ponto de entrada gratuito (sem cobrança). Desde 1º de outubro de 2026 as mensagens de serviço também são cobradas acima de uma franquia mensal. Duas rotas ajudam a ver isso: o custo diário com projeção e o uso mensal por categoria.

Custos

GET/api/v1/vendor/whatsapp-confluence/analytics/costsSeller

Custo diário, projeção e economia da coexistência

Cabeçalhos

Authorizationstringobrigatório
Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Parâmetros de consulta

daysintegerpadrão: 30
Janela em dias, contada até agora. Valor ausente ou que não é número vale 30.

Exemplo de requisição

bash
curl "$BASE_URL/api/v1/vendor/whatsapp-confluence/analytics/costs?days=30" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Custos
json
{
  "real": [
    {
      "day": "2026-10-09",
      "category": "UTILITY",
      "cost_cents": 320,
      "msg_count": 8
    },
    {
      "day": "2026-10-10",
      "category": "SERVICE",
      "cost_cents": 0,
      "msg_count": 31
    }
  ],
  "october_projection": {
    "month_to_date_cents": 1250,
    "projected_month_cents": 3875
  },
  "savings": {
    "app_replies": 14,
    "api_replies": 96,
    "estimated_savings_cents": 210
  },
  "fep_free_count": 22
}

Campos da resposta

realarray
Custo registrado por dia e categoria: day, category (SERVICE, UTILITY, MARKETING, AUTHENTICATION), cost_cents e msg_count.
october_projectionobject
O volume do mês até agora a tarifas de outubro de 2026: month_to_date_cents e projected_month_cents (estimativa linear até o fim do mês).
savingsobject
Economia da coexistência: app_replies respostas dadas pelo aplicativo WhatsApp Business, api_replies respostas pela API ou assistente, estimated_savings_cents o que as respostas do aplicativo custariam se tivessem ido pela API.
fep_free_countinteger
Mensagens enviadas dentro de um ponto de entrada gratuito.

Erros

StatusQuandoCorpo de exemplo
401Sem token ou token inválido.{"error":"missing authorization header"}
403O usuário não é um seller, ou o seller ainda está em análise de cadastro.{"error":"vendor_pending_review"}
404O recurso de analytics está desligado na loja (enable_analytics).{"error":"disabled"}
500Falha interna ao calcular.{"error":"..."}
Valores em centavos, estimados

Todo valor monetário aqui é em centavos e vem de uma tabela de tarifas, não da fatura da Meta. Use para acompanhar a tendência, não para conciliar a fatura.

Números da loja inteira

Estes números cobrem a loja toda, não só as contas do seu seller. Apenas o relatório de Uso mensal é filtrado pelas contas do seller.

Uso mensal

Conta as mensagens que a Meta aceitou, agrupadas por categoria, conta e dia, no fuso de São Paulo. Calcula quantas mensagens de serviço passaram da franquia e uma estimativa em reais. Este relatório é filtrado para as contas do seller.

GET/api/v1/vendor/whatsapp-confluence/analytics/usageSeller

Mensagens enviadas no mês, por categoria e conta

Cabeçalhos

Authorizationstringobrigatório
Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Parâmetros de consulta

monthstring
Mês no formato YYYY-MM, com dois dígitos no mês (2026-09, não 2026-9). Omitido vale o mês atual.

Exemplo de requisição

bash
curl "$BASE_URL/api/v1/vendor/whatsapp-confluence/analytics/usage?month=2026-10" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Uso do mês
json
{
  "month": "2026-10",
  "timezone": "America/Sao_Paulo",
  "franchise": 1000,
  "franchise_scope": "waba",
  "price_micros": 36000,
  "currency": "BRL",
  "service": 1240,
  "free_entry_point": 22,
  "templates": {
    "template_utility": 80,
    "template_marketing": 15
  },
  "carousel_messages": 4,
  "carousel_cards": 20,
  "over_franchise": 240,
  "estimate_micros": 8640000,
  "accounts": [
    {
      "account_id": "3b9d8c52-1f0a-4e7b-8a21-6d5c4b3a2f10",
      "label": "Loja Exemplo 5511987654321",
      "waba_id": "108765432109876",
      "service": 1240,
      "free_entry_point": 22,
      "templates": {
        "template_utility": 80
      },
      "carousel_messages": 4,
      "carousel_cards": 20
    }
  ],
  "daily": [
    {
      "day": "2026-10-09",
      "service": 120,
      "free_entry_point": 3,
      "templates": 9
    }
  ]
}

Campos da resposta

monthstring
Mês do relatório (YYYY-MM).
timezonestring
Sempre America/Sao_Paulo: os dias e o mês são contados nesse fuso.
franchiseinteger
Franquia mensal de mensagens de serviço. Padrão 1000.
franchise_scopestring
accountwabatenant
Como a franquia é aplicada: account, waba (padrão) ou tenant.
price_microsinteger
Preço por mensagem acima da franquia, em milionésimos de real (1 real = 1000000). 0 quando a loja não informou.
currencystring
Sempre BRL.
serviceinteger
Mensagens de serviço aceitas no mês.
free_entry_pointinteger
Mensagens dentro de um ponto de entrada gratuito.
templatesobject
Templates por categoria, com chaves como template_utility e template_marketing.
carousel_messagesinteger
Carrosséis enviados (cada carrossel conta como 1 mensagem).
carousel_cardsinteger
Cartões dentro dos carrosséis.
over_franchiseinteger
Mensagens de serviço acima da franquia, aplicada conforme franchise_scope.
estimate_microsinteger
over_franchise vezes price_micros, em milionésimos de real. 0 se não há preço.
accountsarray
Uso por conta: account_id, label, waba_id, service, free_entry_point, templates, carousel_messages, carousel_cards. Da conta com mais mensagens de serviço para a menor.
dailyarray
Por dia, em ordem: day, service, free_entry_point, templates (total do dia).

Erros

StatusQuandoCorpo de exemplo
401Sem token ou token inválido.{"error":"missing authorization header"}
403O usuário não é um seller, ou o seller ainda está em análise de cadastro.{"error":"vendor_pending_review"}
400month fora do formato YYYY-MM.{"error":"month must be YYYY-MM"}
500Falha interna ao calcular.{"error":"..."}
Como a estimativa é montada

Ajuste a franquia, o escopo e o preço da loja em Ajustes do canal (service_monthly_franchise, service_franchise_scope, service_price_micros). Sem service_price_micros, estimate_micros fica em 0.

Veja também

  • Orçamento mensal
  • Enviar template
  • Visão geral da seção
Anterior
Visão geral, funil e anúncios
Próxima
Campanhas
Nesta página
  • Custos
  • Exemplo de requisição
  • Resposta
  • Erros
  • Uso mensal
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também