EntrarComeçar teste grátis
Meta Tech Provider

Objeto de precificação do webhook do WhatsApp: type, category e billable (2026)

O objeto de precificação vem nos webhooks de status e informa como a Meta classificou uma mensagem: billable (em descontinuação), 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, paid_exempt. Desde 1º de outubro de 2026, regular marca toda mensagem cobrada, inclusive as mensagens de atendimento.

A easyCoexistence conecta o número do seu app do WhatsApp Business à Cloud API da Meta por meio da Coexistência e encaminha ao seu servidor os webhooks de status que trazem esse objeto, para que o seu próprio sistema contabilize o uso.

PMP

O pricing_model nos webhooks atuais, precificação por mensagem; CBP só aparece em webhooks enviados antes de 1º de julho de 2025.

1,000

Mensagens de atendimento entregues por número de telefone comercial por mês dentro da franquia gratuita da Meta, a partir de 1º de outubro de 2026.

regular

O type de uma mensagem cobrada, inclusive mensagens de atendimento entregues depois que a franquia gratuita do número se esgota.

paid_exempt

O subtype em mensagens de atendimento gratuitas porque a organização é um órgão governamental ou uma entidade sem fins lucrativos elegível.

0

Detalhes de níveis de volume nos webhooks; a Meta indica o campo pricing_analytics para informações sobre níveis de volume.

Onde o objeto de precificação aparece?

Somente nos status, e só em alguns deles: a Meta o inclui no status sent e em um entre delivered e read, e um exemplo da v24.0 na referência da Meta mostra o objeto ausente em sent porque ele veio no webhook de delivered. Status failed nunca o trazem. Por isso, trate a precificação como uma propriedade da mensagem, identificada pelo wamid, e registre-a uma única vez, seja qual for o status que a traga. Os exemplos da própria Meta do objeto para uma mensagem de atendimento, antes e depois de a franquia mensal gratuita do número se esgotar:

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 se a Meta cobra. Seu significado mudou em 1º de outubro de 2026, quando a Meta passou a cobrar por mensagem as mensagens de atendimento e os templates de utilidade enviados em resposta a um cliente. Código escrito antes dessa data pode interpretar free_customer_service como uma resposta dentro da janela aberta; agora significa uma mensagem de atendimento individual dentro da franquia mensal gratuita do número. billable ainda aparece, mas a Meta diz que ele será descontinuado e pede que você leia type e category juntos.

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

Quais categorias uma mensagem pode ter?

category indica a tarifa que a Meta aplicou quando há cobrança, e é o campo pelo qual agrupar ao conciliar com a fatura da Meta, junto com o país do número do cliente, já que as tarifas variam por mercado. Uma mensagem tem uma categoria e uma única cobrança: uma mensagem sem template com conteúdo promocional continua sendo uma mensagem de atendimento, nunca uma cobrança extra de marketing. 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 contar as cobranças a partir dos webhooks?

Os webhooks dizem quais mensagens são cobráveis e em qual categoria, não quanto elas custam. Para montar uma visão de uso que bata com a cobrança 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 traz o detalhamento por mensagem e os níveis de volume.

  • Deduplique pelo wamid, já que a precificação pode vir em mais de um status e os reenvios repetem webhooks.
  • Conte uma mensagem como cobrada quando type for regular; agrupe por category e pelo país do destinatário.
  • Ignore mensagens failed: a Meta só cobra por mensagens entregues.
  • A partir da v24.0, não espere o objeto conversation, exceto dentro de uma janela de ponto de entrada gratuito, em que o id dele é único por janela.

O que isso significa para respostas de IA em um número com Coexistência?

Toda resposta que a sua IA ou uma automação envia pela API é uma mensagem sem template, então a categoria dela é service: dentro da franquia mensal gratuita do número, aparece como free_customer_service e, depois disso, como regular. Templates que a sua IA envia com send_template trazem a própria categoria. O guia de Coexistência da Meta acrescenta uma diferença que pesa no custo: as mensagens que o proprietário digita no app do WhatsApp Business não estão sujeitas à janela de atendimento e não afetam a precificação da Cloud API.

A Meta cobra as mensagens na própria WhatsApp Business Account da empresa, por mensagem, por categoria e por país; a easyCoexistence nunca aplica margem sobre elas, e o uso de IA é cobrado pelo seu provedor de IA, com a sua própria chave.

Erros comuns

  • Contar o objeto de precificação toda vez que ele aparece. Ele pode vir em mais de um status da mesma mensagem; conte uma vez por wamid.
  • Ler apenas billable. A Meta está descontinuando esse campo e pede que você use type e category juntos.
  • Manter a interpretação de free_customer_service anterior a outubro. Desde 1º de outubro de 2026, ele marca uma mensagem de atendimento dentro da franquia mensal gratuita do número.
  • Esperar valores no payload. O objeto informa a categoria; as tarifas vêm das tabelas de preços da Meta ou de pricing_analytics.
Fazendo isso com o EasyCoexistence

As cobranças da Meta ficam na sua própria WhatsApp Business Account, sem nenhuma margem. De R$ 29,90 até R$ 3,90 por número por mês, valor que cai conforme você adiciona números, com os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Qual conta paga por uma mensagem?

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

O que é marketing_lite?

O valor de category e de type no pricing das mensagens enviadas pela Marketing Messages API for WhatsApp da Meta, um caminho de envio separado para templates de marketing, com opções de precificação próprias, como um preço máximo por entrega.

Quando a cobrança por mensagem substituiu a cobrança por conversa?

Em 1º de julho de 2025. Webhooks enviados antes dessa data podem mostrar pricing_model CBP, precificação por conversa; os posteriores mostram PMP. Código que ainda agrupa as cobranças pelo id da conversa precisa ser atualizado.

A franquia gratuita é renovada todo mês?

Sim. A Meta dá a cada número de telefone comercial 1.000 mensagens de atendimento entregues por mês, sem acúmulo para o mês seguinte, com renovação à meia-noite no fuso horário da WhatsApp Business Account.

Continue lendo

Pronto para começar?

Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.

Começar teste grátis

Verificado em