Skip to main content

​
Monitor de Uso e Custo Meta

O Switchbord agora expõe duas superfícies relacionadas de uso Meta:
  • Insights → Billing (/insights, aba Billing) — lê pricing_analytics e analytics do WABA da Meta em tabelas locais de rollup diário, e então mostra mensagens enviadas/entregues, entregues por categoria, divisão entre gratuito e pago, e cobranças totais aproximadas na moeda do WABA.
  • Settings → Usage (/settings/usage) — uma visão de estimativa operacional baseada nos dados de mensagens do Switchbord e na atribuição de campanha.
Os totais de uso Meta são estimativas operacionais. Faturas da Meta, exportações de billing e ferramentas de billing da Meta em nível de conta permanecem como a fonte da verdade para a liquidação.

​
O que o Insights → Billing mostra

  • Mensagens enviadas / entregues — a partir do campo analytics do WABA.
  • Entregues por categoria — a partir das linhas de categoria de pricing_analytics, como MARKETING, UTILITY, AUTHENTICATION e SERVICE.
  • Gratuito vs. pago — divide as linhas FREE_CUSTOMER_SERVICE, FREE_ENTRY_POINT e as linhas pagas REGULAR.
  • Cobranças totais aproximadas — somadas a partir de pricing_analytics.cost na moeda do WABA.

​
O que o Settings → Usage mostra

  • Custo Meta estimado — calculado a partir de mensagens de template entregues e da tabela de tarifas configurada.
  • Templates entregues — entregas de template cobráveis para as categorias de marketing, utilidade e autenticação.
  • Taxa de leitura — eventos de leitura divididos pelas mensagens de template entregues na janela selecionada.
  • Mensagens gratuitas — tráfego freeform de entrada e de janela de serviço contados separadamente da entrega paga de templates.
  • Tendência de gasto — custo estimado diário junto com o volume de templates entregues.
  • Custo por categoria — categorias de marketing, utilidade, autenticação e serviço.
  • Atribuição de campanha — volume de templates entregues, taxa de leitura e custo estimado por campanha.

​
Janelas

O dashboard suporta três janelas:
  • 7d — últimos sete dias.
  • 30d — últimos trinta dias.
  • MTD — mês atual até a data.
O Switchbord busca cada janela separadamente no lado do servidor, para que os rótulos das abas não relabelem o mesmo conjunto de dados.

​
Fontes de dados

O monitor lê dados com escopo de workspace de:
  • messaging_events quando os eventos já incluem status, categoria, país e metadados de campanha.
  • messages, templates, contacts e campaign_recipients como fallback, para que workspaces existentes ainda possam estimar o uso enquanto payloads de eventos de mensagens mais ricos são implantados.
Toda query tem escopo definido pelo workspace_id resolvido a partir da sessão autenticada do operador.

​
Modelo de precificação

O Switchbord segue o formato de precificação por template entregue da Meta pós-julho de 2025:
  • Mensagens de template entregues podem ser cobráveis.
  • Tráfego freeform de janela de serviço é contado separadamente.
  • As tarifas variam por categoria de template e por país/código de discagem do destinatário.
A implementação inicial inclui uma tabela de tarifas operacional para estimativas. Mantenha a tabela de tarifas versionada e reconcilie com as exportações de billing da Meta antes de usar os números para faturamento ou repasse de cobrança ao cliente.

​
Atribuição de campanha

As linhas de campanha são derivadas de campaign_recipients.message_id e do estado de entrega da mensagem. Use esta visão para identificar qual campanha de turismo, fluxo de reengajamento ou lembrete de reserva está direcionando o gasto atual com a Meta.

​
Próximos passos

  • Importar uma tabela de tarifas Meta completa e versionada por país/código de discagem e data de vigência.
  • Adicionar reconciliação explícita de exportação de billing contra as faturas da Meta.
  • Armazenar payloads de status mais ricos no caminho de escrita de eventos de mensagens, para que os joins de fallback possam ser reduzidos ao longo do tempo.
  • Adicionar exportação em CSV para revisões de finanças e customer success.