1. Evento de suscripción
YCloud envía actualizaciones de estado y precios de los mensajes a través del eventowhatsapp.message.updated. Las suscripciones están disponibles en Desarrolladores → Webhook en la consola de YCloud.
La siguiente solicitud crea una suscripción a través de la API. Consulta Crear un endpoint de webhook para ver la referencia del endpoint:
url especifica el endpoint de recepción del webhook. El procesamiento de eventos y la verificación de firmas se describen en la Guía de integración de webhooks.
2. Campos de precios
La información de precios se incluye en el objetowhatsappMessage de la retrollamada:
Otros campos se describen en Recuperar un mensaje.
3. Reglas de precios
3.1 Firmeza del precio
YCloud reporta precios estimados o definitivos según el estado del mensaje:
Para los mensajes de marketing con Max Price, el límite de precio efectivo es el
maxBid de la plantilla multiplicado por el multiplicador del país y el multiplicador por mensaje. Utiliza el totalPrice de delivered/read para el cargo definitivo. Consulta la Guía de integración de Max Price para conocer la configuración y el ejemplo de puja entregada para ver una retrollamada completa.
3.2 Tipos de precios facturables y gratuitos
YCloud reporta los tres tipos de precios siguientes a través depricingType:
A partir del 1 de octubre de 2026, el cupo de servicio se restablece mensualmente para cada número de teléfono comercial. El cupo no utilizado no se acumula, y los mensajes de servicio individuales y grupales comparten el mismo cupo. Una vez agotado, los mensajes de servicio individuales utilizan el precio
regular, a menos que se apliquen las reglas de punto de entrada gratuito.
A partir de la misma fecha, las plantillas de utilidad dentro de la ventana de atención al cliente dejan de ser gratuitas únicamente por el hecho de que la ventana esté abierta y no están cubiertas por el cupo de servicio. Los mensajes aptos para el precio de punto de entrada gratuito siguen utilizando free_entry_point.
Una ventana de punto de entrada gratuito se abre cuando un usuario envía un mensaje a una empresa mediante un anuncio con clic a WhatsApp o un botón de WhatsApp en una página de Facebook mediante WhatsApp para Android o iOS, y la empresa responde en un plazo de 24 horas. La ventana dura 72 horas a partir de la respuesta de la empresa. Los clientes de WhatsApp para escritorio y web no son válidos para esta regla de punto de entrada.
4. Ejemplos de payload de webhook
Los siguientes extractos de retrollamada representan mensajes individuales. Los IDs y los importes de cobro son ilustrativos, no cotizaciones de tarifas reales. Para ver cargas útiles completas, consulta WhatsApp Message Updated Webhook Examples.4.1 Mensaje de marketing: facturable
Un mensaje de marketing entregado utiliza los precios deregular. El importe final ilustrativo es 0.05 USD.
4.2 Mensaje de servicio: facturable
A partir del 1 de octubre de 2026, cuando el número de teléfono comercial haya agotado su asignación mensual de 1000 mensajes de servicio gratuitos y el mensaje no cumpla los requisitos para el precio de punto de entrada gratuito, YCloud reportapricingType=regular. El importe final ilustrativo es 0.01 USD.
4.3 Mensaje de servicio: dentro de la asignación gratuita
A partir del 1 de octubre de 2026, para un mensaje cubierto por la asignación mensual de 1000 mensajes de servicio gratuitos del número de teléfono comercial, YCloud reportapricingType=free_customer_service y un importe final de 0.
4.4 Mensaje de punto de entrada gratuito
Para un mensaje entregado dentro de la ventana de 72 horas de punto de entrada gratuito, YCloud reportapricingType=free_entry_point, pricingCategory=referral_conversion y un importe final de 0.

