whatsapp.template.quality_updated

Usa whatsapp.template.quality_updated para gestionar este evento en tu endpoint de webhook.

Desencadenadores

Se produce cuando se actualiza la calificación de calidad de una plantilla de WhatsApp. Suscríbete a whatsapp.template.quality_updated cuando configures tu endpoint de webhook.

Sintaxis

YCloud envía una solicitud HTTP POST a tu URL de webhook configurada. La siguiente estructura muestra una variante de carga útil. Los valores entre corchetes angulares son marcadores de posición; sus tipos se indican en Parámetros. Los campos opcionales y otras variantes se describen a continuación.

{
  "id": "<ID>",
  "type": "whatsapp.template.quality_updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappTemplate": {
    "officialTemplateId": "<OFFICIAL_TEMPLATE_ID>",
    "wabaId": "<WABA_ID>",
    "name": "<NAME>",
    "language": "<LANGUAGE>",
    "qualityRating": "<QUALITY_RATING>"
  }
}

Parámetros

Valida el encabezado HTTP YCloud-Signature antes de procesar el cuerpo JSON. Consulta validación de firmas.

Envoltorio del evento

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	ID único para el evento. Longitud mínima: `6`. Longitud máxima: `128`.
`type`	string	Sí	Siempre `whatsapp.template.quality_updated`.
`apiVersion`	string	Sí	La versión de la API utilizada para representar este evento.
`createTime`	string (date-time)	Sí	La fecha y hora en la que se creó este evento, con formato RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.

Carga útil del evento

Parámetro	Tipo	Obligatorio	Descripción
`whatsappTemplate`	object	No	Carga útil de `whatsappTemplate` específica del evento.

Los cuatro campos comunes del envoltorio son obligatorios. Los campos de la carga útil dependen de la variante del evento. En cada tabla de objetos, Obligatorio aplica cuando su objeto principal está presente. Los campos opcionales se pueden omitir; una muestra no hace que un campo sea obligatorio.

whatsappTemplate

Parámetro	Tipo	Obligatorio	Descripción
`officialTemplateId`	string	No	ID oficial de la plantilla asignado por WhatsApp. Este ID se utiliza para identificar la plantilla en el sistema de WhatsApp.
`wabaId`	string	Sí	ID de la cuenta de WhatsApp Business.
`name`	string	Sí	Nombre de la plantilla. Longitud máxima: `512`. Patrón: `[a-z0-9]{1,512}`.
`language`	string	Sí	Código de idioma de la plantilla. Consulta Supported Languages para ver todos los códigos.
`qualityRating`	string	No	Calificación de calidad de la plantilla de WhatsApp. Uno de los siguientes valores: `GREEN`, `YELLOW`, `RED` o `UNKNOWN`. Consulta también Template Quality Rating. `GREEN`: alta calidad. `YELLOW`: calidad media. `RED`: baja calidad. `UNKNOWN`: calidad desconocida.

Ejemplo

El siguiente JSON es el cuerpo entregado a tu receptor. Los ID, números de teléfono y otros valores de cuenta son ilustrativos.

{
  "id": "evt_example_whatsapp_template_quality_updated",
  "type": "whatsapp.template.quality_updated",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappTemplate": {
    "officialTemplateId": "official-template-id",
    "wabaId": "whatsapp-business-account-id",
    "name": "order_update",
    "language": "en_US",
    "qualityRating": "GREEN"
  }
}

Tras verificar la firma y aceptar de forma duradera el evento, devuelve una respuesta 2xx. Procesa las tareas lentas de forma asíncrona.

HTTP/1.1 200 OK

Para ver ejemplos prácticos de situaciones, consulta ejemplos anotados.

Primeros pasos

Guías

Endpoints

Webhook reference

whatsapp.template.quality_updated

Desencadenadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

whatsappTemplate

Ejemplo

​Desencadenadores

​Sintaxis

​Parámetros

​Envoltorio del evento

​Carga útil del evento

​whatsappTemplate

​Ejemplo

Desencadenadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

whatsappTemplate

Ejemplo