Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

Objeto de preços do webhook do WhatsApp: type, category e billable (2026)

O objeto de preços viaja nos webhooks de estado e indica como a Meta classificou uma mensagem: billable (a ser descontinuado), pricing_model PMP, type (regular, free_customer_service, free_entry_point ou free_group_customer_service), category como marketing, utility, authentication ou service, e um subtype opcional de paid_exempt. Desde 1 de outubro de 2026, regular marca toda a mensagem cobrada, incluindo as mensagens de serviço.

A easyCoexistence liga o número da sua app WhatsApp Business à Cloud API da Meta através da Coexistence e envia os webhooks de estado que trazem este objeto para o seu servidor, para que o seu próprio sistema possa contabilizar a utilização.

PMP

Nos webhooks atuais, o pricing_model indica preço por mensagem; CBP aparece apenas em webhooks enviados antes de 1 de julho de 2025.

1,000

Mensagens de serviço entregues por número de telefone empresarial por mês dentro do nível gratuito da Meta, desde 1 de outubro de 2026.

regular

O type de uma mensagem cobrada, incluindo as mensagens de serviço entregues depois de esgotado o nível gratuito do número.

paid_exempt

O subtype nas mensagens de serviço gratuitas por a organização ser elegível como entidade governamental ou sem fins lucrativos.

0

Detalhes de escalões nos webhooks; a Meta indica o campo pricing_analytics para informação sobre escalões de volume.

Onde aparece o objeto de preços?

Apenas nos estados, e só em alguns deles: a Meta inclui-o com o estado sent e com um dos estados delivered ou read. Um exemplo da referência da Meta na v24.0 mostra que ele falta em sent porque veio no webhook delivered. Os estados failed nunca o trazem. Por isso, trate o preço como uma propriedade da mensagem, identificada pelo wamid, e registe-o uma vez, seja qual for o estado que o traga. Eis os exemplos da própria Meta do objeto numa mensagem de serviço, antes e depois de esgotar o nível gratuito mensal do número:

Meta's examples: a service message in the free tier, then a charged one
// Service message delivered while the number is within its free tier
"pricing": {
  "billable": false,
  "pricing_model": "PMP",
  "type": "free_customer_service",
  "category": "service"
}

// Service message delivered after the number's free tier has been used
"pricing": {
  "billable": true,
  "pricing_model": "PMP",
  "type": "regular",
  "category": "service"
}

O que significam os valores de type desde 1 de outubro de 2026?

type é o campo que responde à pergunta se a Meta cobra. O seu significado mudou a 1 de outubro de 2026, quando a Meta passou a cobrar por mensagem as mensagens de serviço e os templates de utilidade enviados em resposta a um cliente. O código escrito antes dessa data pode ler free_customer_service como uma resposta dentro da janela aberta; agora significa uma mensagem de serviço um a um dentro do nível gratuito mensal do número. billable continua presente, mas a Meta indica que será descontinuado e pede que leia type e category em conjunto.

Through 30 Sep 2026From 1 Oct 2026
regularA billable messageBillable, now including utility replies to customers and service messages past the number's monthly tier
free_customer_serviceA utility template or non-template message sent in an open windowA one-to-one service message within the number's monthly tier
free_group_customer_serviceGroup utility or non-template message in an open group windowA group service message within the number's monthly tier
free_entry_pointSent in an open free entry point windowUnchanged

Que categorias pode ter uma mensagem?

category indica a tarifa que a Meta aplicou quando cobra, e é o campo pelo qual agrupar ao conciliar com a fatura da Meta, juntamente com o país do número do cliente, já que as tarifas variam por mercado. Cada mensagem tem uma categoria e apenas uma cobrança: uma mensagem que não é template, com conteúdo promocional, continua a ser uma mensagem de serviço, nunca uma cobrança de marketing extra. Os valores que a Meta lista:

marketingMarketing template rate.
utilityUtility template rate.
authenticationAuthentication template rate.
authentication-internationalAuthentication-international rate.
serviceNon-template message sent in reply to a customer.
marketing_liteMarketing Messages API for WhatsApp pricing.
referral_conversionMessage in a free entry point window.
group_marketing, group_utility, group_serviceThe same categories for group messages.

Como se contam as cobranças a partir dos webhooks?

Os webhooks indicam quais mensagens são faturáveis e em que categoria, não quanto custam. Para criar uma vista de utilização que corresponda à faturação da Meta, conte por mensagem e por categoria, e depois aplique as tarifas publicadas pela Meta para cada mercado, ou leia o campo pricing_analytics da Meta, que dá a discriminação por mensagem e os escalões.

  • Elimine duplicados pelo wamid, já que o preço pode vir em mais de um estado e as novas tentativas repetem webhooks.
  • Conte uma mensagem como cobrada quando type for regular; agrupe por categoria e pelo país do destinatário.
  • Ignore as mensagens failed: a Meta cobra apenas as mensagens entregues.
  • A partir da v24.0, não espere objeto conversation, exceto dentro de uma janela de ponto de entrada gratuita, em que o seu id é único por janela.

O que significa isto para as respostas de IA num número em Coexistence?

Cada resposta que a sua IA ou uma automatização envia pela API é uma mensagem que não é template, por isso a categoria é service: dentro do nível gratuito mensal do número aparece free_customer_service e, depois disso, regular. Os templates que a sua IA envia com send_template têm a sua própria categoria. O guia de Coexistence da Meta acrescenta uma diferença que importa para o custo: as mensagens que o proprietário escreve na app WhatsApp Business não estão sujeitas à janela de atendimento ao cliente e não afetam a faturação da Cloud API.

A Meta fatura as mensagens à própria conta WhatsApp Business da empresa, mensagem a mensagem, por categoria e país; a easyCoexistence nunca aplica margem, e o uso de IA é faturado pelo seu fornecedor de IA, na sua própria chave.

Erros comuns

  • Contar o objeto de preços sempre que aparece. Pode vir em mais de um estado da mesma mensagem; conte uma vez por wamid.
  • Ler apenas billable. A Meta está a descontinuá-lo e pede que use type e category em conjunto.
  • Manter a leitura de free_customer_service anterior a outubro. Desde 1 de outubro de 2026 marca uma mensagem de serviço dentro do nível gratuito mensal do número.
  • Esperar valores no payload. O objeto indica a categoria; as tarifas vêm das tabelas de tarifas da Meta ou do pricing_analytics.
Fazer isto com a EasyCoexistence

As cobranças da Meta ficam na sua própria conta WhatsApp Business e nunca têm margem. De US$ 9 a US$ 0.75 por número ligado e por mês, que baixa à medida que acrescenta números, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Qual conta paga uma mensagem?

A conta WhatsApp Business que a enviou. Quando várias contas enviam a partir de um mesmo número, a Meta atribui cada cobrança à conta que enviou essa mensagem, com o seu próprio método de pagamento e limites de gastos.

O que é marketing_lite?

A categoria e o type de preço para mensagens enviadas pela Marketing Messages API da Meta para WhatsApp, um caminho de envio separado para templates de marketing com opções de preço próprias, como um preço máximo por entrega.

Quando é que o preço por mensagem substituiu as conversas?

A 1 de julho de 2025. Os webhooks enviados antes dessa data podem mostrar pricing_model CBP, preço por conversa; os posteriores mostram PMP. O código que ainda agrupa cobranças pelo id da conversa precisa de ser atualizado.

O nível gratuito é reposto todos os meses?

Sim. A Meta dá a cada número de telefone empresarial 1,000 mensagens de serviço entregues por mês, sem transição para o mês seguinte, reposto à meia-noite no fuso horário da conta WhatsApp Business.

Continue a ler

Pronto para começar?

Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.

Começar período experimental gratuito

Verificado em