whatsapp.business_account.reviewed

Usa whatsapp.business_account.reviewed para gestionar este evento en tu endpoint de webhook.

Activadores

Se produce cuando se ha revisado una cuenta de WhatsApp Business. Suscríbete a whatsapp.business_account.reviewed cuando configures tu endpoint de webhook.

Sintaxis

YCloud envía una solicitud HTTP POST a la URL de webhook que hayas configurado. La siguiente estructura muestra una variante de la 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.business_account.reviewed",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappBusinessAccount": {
    "id": "<ID>",
    "decision": "<DECISION>",
    "accountReviewStatus": "<ACCOUNT_REVIEW_STATUS>"
  }
}

Parámetros

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

Envoltorio del evento

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

Carga útil del evento

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

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 pueden omitirse; un ejemplo no hace que un campo sea obligatorio.

whatsappBusinessAccount

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	ID de la cuenta de WhatsApp Business.
`name`	string	No	Nombre fácil de recordar para diferenciar las cuentas de WhatsApp Business.
`accountReviewStatus`	string	No	Estado de revisión de la cuenta de WhatsApp Business. Valores: `PENDING`, `APPROVED`, `REJECTED`.
`businessVerificationStatus`	string	No	Estado actual de la verificación de empresa de la cuenta de Meta Business a la que pertenece esta cuenta de WhatsApp Business. Valores: `expired`, `failed`, `ineligible`, `not_verified`, `pending`, `pending_need_more_info`, `pending_submission`, `rejected`, `revoked`, `verified`.
`decision`	string	No	Decisión de revisión tomada sobre esta cuenta de WhatsApp Business. Uno de `APPROVED` o `REJECTED`.

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_business_account_reviewed",
  "type": "whatsapp.business_account.reviewed",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "whatsapp-business-account-id",
    "decision": "APPROVED",
    "accountReviewStatus": "APPROVED"
  }
}

Después de verificar la firma y aceptar el evento de forma duradera, 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 los ejemplos comentados.

Primeros pasos

Guías

Endpoints

Webhook reference

whatsapp.business_account.reviewed

Activadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

whatsappBusinessAccount

Ejemplo

​Activadores

​Sintaxis

​Parámetros

​Envoltorio del evento

​Carga útil del evento

​whatsappBusinessAccount

​Ejemplo

Activadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

whatsappBusinessAccount

Ejemplo