Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

Objeto pricing del webhook de WhatsApp: type, category y billable (2026)

El objeto pricing viaja en los webhooks de estado e indica cómo clasificó Meta un mensaje: billable (en proceso de desuso), pricing_model PMP, type (regular, free_customer_service, free_entry_point o free_group_customer_service), category, como marketing, utility, authentication o service, y un subtype opcional, paid_exempt. Desde el 1 de octubre de 2026, regular marca todo mensaje cobrado, incluidos los mensajes de servicio.

easyCoexistence conecta el número de tu app de WhatsApp Business con la Cloud API de Meta mediante Coexistencia y reenvía a tu servidor los webhooks de estado que llevan este objeto, para que tu propio sistema pueda contabilizar el uso.

PMP

El pricing_model de los webhooks actuales, precio por mensaje; CBP solo aparece en webhooks enviados antes del 1 de julio de 2025.

1,000

Mensajes de servicio entregados por número de teléfono de la empresa al mes dentro del nivel gratuito de Meta, desde el 1 de octubre de 2026.

regular

El type de un mensaje cobrado, incluidos los mensajes de servicio entregados después de agotar el nivel gratuito del número.

paid_exempt

El subtype de los mensajes de servicio que son gratuitos porque la organización es una entidad gubernamental o sin fines de lucro elegible.

0

Detalles de niveles en los webhooks; Meta remite al campo pricing_analytics para la información de niveles por volumen.

¿Dónde aparece el objeto pricing?

Solo en los estados, y no en todos: Meta lo incluye con el estado sent y con delivered o con read, y un ejemplo de v24.0 en la referencia de Meta muestra que falta en sent porque llegó en el webhook delivered. Los estados failed nunca lo incluyen. Por eso, trata el precio como una propiedad del mensaje, con su wamid como clave, y regístralo una sola vez, lo traiga el estado que lo traiga. Estos son los ejemplos de Meta del objeto para un mensaje de servicio, antes y después de que se agote el nivel gratuito mensual del 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"
}

¿Qué significan los valores de type desde el 1 de octubre de 2026?

type es el campo que indica si Meta cobra. Su significado cambió el 1 de octubre de 2026, cuando Meta empezó a cobrar por mensaje los mensajes de servicio y las plantillas de utilidad enviadas en respuesta a un cliente. El código escrito antes de esa fecha puede interpretar free_customer_service como una respuesta dentro de la ventana abierta; ahora significa un mensaje de servicio uno a uno dentro del nivel gratuito mensual del número. billable sigue apareciendo, pero Meta indica que quedará obsoleto y pide leer type y 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

¿Qué categorías puede tener un mensaje?

category indica la tarifa que Meta aplicó al cobrar, y es el campo por el que agrupar al conciliar con la factura de Meta, junto con el país del número del cliente, porque las tarifas varían según el mercado. Un mensaje tiene una sola categoría y un solo cargo: un mensaje que no es plantilla con contenido promocional sigue siendo un mensaje de servicio, nunca un cargo adicional de marketing. Los valores que indica Meta:

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.

¿Cómo contar los cobros a partir de los webhooks?

Los webhooks indican qué mensajes son cobrables y en qué categoría, no cuánto cuestan. Para armar una vista de uso que coincida con la facturación de Meta, cuenta por mensaje y por categoría, y aplica las tarifas publicadas por Meta para cada mercado, o lee el campo pricing_analytics de Meta, que ofrece desgloses por mensaje y por nivel.

  • Deduplica por wamid, ya que el precio puede llegar en más de un estado y los reintentos repiten webhooks.
  • Cuenta un mensaje como cobrado cuando type es regular; agrupa por category y por el país del destinatario.
  • Ignora los mensajes fallidos: Meta solo cobra los mensajes entregados.
  • Desde v24.0, no esperes un objeto conversation salvo dentro de una ventana de punto de entrada gratuito, donde su id es único por ventana.

¿Qué implica para las respuestas de IA en un número con Coexistencia?

Cada respuesta que tu IA o una automatización envía por la API es un mensaje que no es plantilla, así que su categoría es service: dentro del nivel gratuito mensual del número aparece como free_customer_service y, después, como regular. Las plantillas que tu IA envía con send_template llevan su propia categoría. La guía de Coexistencia de Meta añade una diferencia que importa para el costo: los mensajes que el propietario escribe en la app de WhatsApp Business no están sujetos a la ventana de atención y no afectan los precios de Cloud API.

Meta cobra los mensajes a la propia cuenta de WhatsApp Business de la empresa, por mensaje, según categoría y país; easyCoexistence nunca les aplica margen, y el uso de IA lo cobra tu proveedor de IA con tu propia clave.

Errores comunes

  • Contar el objeto pricing cada vez que aparece. Puede llegar en más de un estado del mismo mensaje; cuenta una vez por wamid.
  • Leer billable por sí solo. Meta lo está retirando y pide usar type y category juntos.
  • Mantener la interpretación de free_customer_service anterior a octubre. Desde el 1 de octubre de 2026 marca un mensaje de servicio dentro del nivel gratuito mensual del número.
  • Esperar importes en el payload. El objeto indica la categoría; las tarifas salen de los tarifarios de Meta o de pricing_analytics.
Hacerlo con EasyCoexistence

Los cobros de Meta quedan en tu propia cuenta de WhatsApp Business y nunca se les aplica margen. De US$ 9 a US$ 0.75 por número conectado al mes, bajando a medida que agregas números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué cuenta paga cada mensaje de WhatsApp?

La cuenta de WhatsApp Business que lo envió. Cuando varias cuentas envían desde un mismo número, Meta atribuye cada cargo a la cuenta que envió ese mensaje, con su propio método de pago y sus límites de gasto.

¿Qué es marketing_lite?

El valor de category y de type en pricing para los mensajes enviados a través de la Marketing Messages API for WhatsApp de Meta, una vía de envío aparte para plantillas de marketing con sus propias opciones de precio, como un precio máximo por entrega.

¿Cuándo pasó WhatsApp del cobro por conversación al cobro por mensaje?

El 1 de julio de 2025. Los webhooks enviados antes de esa fecha pueden mostrar pricing_model CBP, precio basado en conversaciones; los posteriores muestran PMP. El código que todavía agrupa los cobros por id de conversación debe actualizarse.

¿El nivel gratuito se reinicia cada mes?

Sí. Meta da a cada número de teléfono de la empresa 1000 mensajes de servicio entregados al mes, que no se acumulan de un mes a otro, y el nivel se reinicia a medianoche en la zona horaria de la cuenta de WhatsApp Business.

Sigue leyendo

¿Listo para empezar?

Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.

Empezar prueba gratis

Verificado el