# Custos da Meta

Fonte: https://lunahia.com.br/docs/custos-da-meta

A Luna cobra só a capacidade de números do plano. O uso do WhatsApp é cobrado pela Meta, direto do negócio dono do número. Este guia resume as regras de cobrança da Meta em vigor e o que elas mudam para quem integra.

## Quem cobra o quê

A Luna cobra apenas pela capacidade de números conectados do plano. Nunca cobra por mensagem enviada ou recebida, e nenhum limite da API varia com o plano.

Os limites técnicos que a API aplica (requisições por minuto, endpoints de webhook, validade do link de conexão, tamanho de arquivo, envios por segundo) vêm de `GET /v1/limits`, cada um com `key`, `label`, `value`, `unit` e `reason`. São iguais para todos os clientes e existem por capacidade ou porque a Meta os impõe. Pede `numbers:read`.

A Meta cobra o uso do WhatsApp diretamente do negócio que é dono do número, na forma de pagamento cadastrada na conta de WhatsApp desse negócio na Meta. Por isso cada negócio precisa de uma conta própria na Meta, com forma de pagamento própria. A Luna não intermedeia, não adianta e não repassa esse pagamento.

## O que a Meta cobra desde 1º de outubro de 2026

As regras abaixo foram lidas na página de preços da Meta em 07/10/2026. Os valores não estão aqui: variam por categoria de mensagem e pelo país do destinatário, e a Meta os atualiza no primeiro dia de cada trimestre. A [tabela de tarifas da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing) é a referência.

Quem precisa mostrar estas regras no próprio produto lê `GET /v1/meta-pricing`: a lista `rules` (cada regra com `key`, `title` e `text`), o dia em que a Luna as leu em `readAt`, e os endereços da tabela de tarifas (`sourceUrl`) e da política dos Provedores de IA (`aiProvidersUrl`). Não traz valor em moeda. Pede `numbers:read`.

- **Respostas dentro da janela de 24 horas**, que a Meta chama de mensagens de serviço: cada número tem 1.000 mensagens de serviço gratuitas por mês, e o saldo não acumula para o mês seguinte. A partir da 1.001ª, a Meta cobra cada mensagem entregue. A virada do mês é à meia-noite, no fuso da conta de mensagens.
- **Template de utilidade dentro de uma janela aberta** deixou de ser gratuito. A Meta passou a cobrá-lo mesmo com a janela de 24 horas aberta.
- **Template de marketing** é sempre cobrado, dentro ou fora da janela.
- **Conversa iniciada por anúncio de clique para o WhatsApp**: responder dentro da janela de atendimento abre um período gratuito de até 7 dias, para marketing, utilidade, autenticação e serviço.
- **Autenticação e utilidade** têm faixas de volume: a tarifa da faixa seguinte é menor. A contagem é da Meta, feita sobre o portfólio empresarial inteiro, e recomeça todo mês.

> **Sem forma de pagamento, as respostas param.** Se a conta de WhatsApp do negócio não tem forma de pagamento na Meta, a Meta entrega as mensagens de serviço enquanto a franquia gratuita do mês não acaba, e depois disso deixa de entregá-las. Peça ao negócio que cadastre uma forma de pagamento no Billing Hub da Meta antes que isso aconteça.

Para quem integra, a consequência prática é planejar o primeiro disparo e as respostas em volume com a forma de pagamento já cadastrada. A janela de 24 horas continua sendo o que decide se uma mensagem livre pode sair: veja [Enviar mensagens](https://lunahia.com.br/docs/enviar-mensagens).

## Assistentes de IA de uso geral

A Meta chama de Provedores de IA os assistentes de IA de uso geral, e os trata numa política própria. A regra de mensagens de serviço acima não se aplica a eles. Leia a [política da Meta para Provedores de IA](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/ai-providers) antes de decidir se o seu produto se enquadra.

Quando a Meta classifica uma mensagem enviada nessa cobrança, o `pricing.category` dela chega como `general_purpose_ai`, em `GET /v1/messages/{id}`, em `GET /v1/messages` e no evento `message.status`, e o console mostra o rótulo "IA de uso geral". É a cobrança de Provedor de IA, que a Meta faz ao negócio dono da conta, por mensagem de serviço, e vale para o Brasil. A Luna só exibe a classificação: não soma, não converte em valor e não cobra nada sobre ela. Um agente de atendimento de um negócio, que responde sobre o próprio serviço dele, paga como mensagem de serviço comum; a categoria `general_purpose_ai` aparece quando o produto principal é um assistente de uso geral.

## Como conferir o que a Meta cobrou

A Luna devolve a classificação de custo que a Meta aplicou a cada mensagem enviada, com os nomes dela, e não devolve preço. O objeto `pricing` vem em `GET /v1/messages/{id}` e no evento `message.status`, com `billable`, `pricing_model`, `type` e `category`. A Meta o informa só em `sent` e em um entre `delivered` e `read`: enquanto ela não o informa, o campo é nulo. A Meta vai descontinuar `billable`, então leia `type` e `category` juntos. Os valores são os da Meta e podem ganhar valores novos: não trate como lista fechada.

O que a Luna devolve é o que ajuda a prever a categoria. A categoria do template vem no campo `category` de `GET /v1/templates`. O estado da janela de atendimento de cada contato vem em `GET /v1/conversations`, nos campos `windowOpen`, `windowExpiresAt` e `windowSource`. Os dois estão na [referência da API](https://lunahia.com.br/docs/referencia).

Para ver o consumo que a Meta mede para um número no período, use `GET /v1/usage?numberId=`. A Luna lê o `pricing_analytics` da Meta com o token do negócio e repassa os pontos como ela os informa: categoria e tipo de cobrança, a faixa, o país, o volume e o custo aproximado, na moeda da conta do negócio na Meta. Cada ponto vem de um número só e traz `numberId`, `phoneNumberId` e `currency`, a moeda da conta dele; a resposta não tem total, e `notice` traz o aviso de que o valor é aproximação e de que a Meta cobra direto do negócio. Cada leitura gasta uma unidade do limite de gestão da Meta, então a leitura de cada número fica guardada por cinco minutos (`readAt` diz de quando é a leitura). Nada disso entra na assinatura da Luna.

Para repassar o consumo a um cliente seu, mande `externalId` no lugar de `numberId` (exatamente um dos dois; os dois, ou nenhum, voltam `400` com `campos`): `GET /v1/usage?externalId=cliente-42&start=2026-11-01&end=2026-12-01&granularity=MONTHLY`. A Luna lê cada número daquele cliente e devolve os pontos de todos em `data`, cada um com o seu `numberId` e a sua `currency`. Um cliente com contas em moedas diferentes recebe pontos em moedas diferentes, e a Luna **nunca soma moedas**: agrupe por `numberId` e por `currency` no seu lado. `numbers` lista os números cobertos, inclusive os que não tiveram ponto nenhum e os que ficaram de fora (`read: false`, com `reason`: `number_disconnected` ou `phone_not_read_yet`). `granularity` é `DAILY` (o padrão), `MONTHLY` ou `HALF_HOUR`, e a Meta limita o período de cada uma. Com `format=csv` a resposta vem em `text/csv`, uma linha por ponto, para a planilha do seu financeiro; o aviso de aproximação vai no cabeçalho `X-Luna-Notice`. Continua só exibição: nada disso entra na assinatura da Luna.

O `pricing` é para você exibir, não é a fatura. Para ver o que a Meta de fato cobrou, consulte o Billing Hub da conta de WhatsApp do negócio, e a fatura que a Meta emite para ele. É lá que o valor aparece. A Luna não calcula valor em dinheiro, não soma e não cobra sobre isso.
