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 la referencia del endpoint:
url especifica el endpoint de recepción del webhook. La gestión 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 del callback:
Los demás campos se describen en Recuperar un mensaje.
3. Reglas de precios
3.1 Definitividad del precio
YCloud informa precios estimados o definitivos según el estado del mensaje:3.2 Tipos de precios facturables y gratuitos
YCloud informa los siguientes tres tipos de precios a través depricingType:
A partir del 1 de octubre de 2026, el cupo de servicio se reinicia 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 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 ya no son gratuitas solo porque la ventana esté abierta y no están cubiertas por el cupo de servicio. Los mensajes que cumplen con los requisitos 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 a través de un anuncio que dirige a WhatsApp o de un botón de WhatsApp en una página de Facebook mediante WhatsApp para Android o iOS, y la empresa responde dentro de las 24 horas. La ventana dura 72 horas a partir de la respuesta de la empresa. Los clientes de WhatsApp para escritorio y web no cumplen con los requisitos para esta regla de punto de entrada.
4. Ejemplos de payload de Webhook
Los siguientes extractos de callback representan mensajes individuales. Los ID y los importes de cobro son ilustrativos, no cotizaciones de tarifas reales. Para ver los payloads completos, consulta Ejemplos de webhook de mensaje de WhatsApp actualizado.4.1 Mensaje de marketing: facturable
Un mensaje de marketing entregado utiliza el precioregular. El importe definitivo 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 cupo mensual de 1000 mensajes de servicio gratuitos y el mensaje no cumpla con los requisitos para el precio de punto de entrada gratuito, YCloud informapricingType=regular. El importe definitivo 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 1.000 mensajes de servicio gratuitos del número de teléfono comercial, YCloud informapricingType=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 del punto de entrada gratuito, YCloud informapricingType=free_entry_point, pricingCategory=referral_conversion y un importe final de 0.