> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitor de Uso e Custo Meta

> Estimativa de uso de templates entregues no WhatsApp e gastos com a Meta a partir dos dados de mensagens do Switchbord.

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

<Info>
  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.
</Info>

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

<Warning>
  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.
</Warning>

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