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