whatsapp.business_account.deleted

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

Desencadenadores

Se produce cuando se elimina una cuenta de WhatsApp Business. Suscríbete a whatsapp.business_account.deleted cuando configures tu endpoint de webhook. Usa whatsappBusinessAccount.id para identificar la cuenta eliminada. Los campos de eliminación son opcionales. Conserva los valores desconocidos de removedReason e removedInitiatedBy. removedTime registra cuándo se recibió el evento de eliminación, no la hora exacta de la eliminación.

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.deleted",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappBusinessAccount": {
    "id": "<ID>",
    "name": "<NAME>",
    "removedReason": "<REMOVED_REASON>",
    "removedInitiatedBy": "<REMOVED_INITIATED_BY>",
    "removedTime": "<REMOVED_TIME>"
  }
}

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í	Identificador único del evento. Longitud mínima: `6`. Longitud máxima: `128`.
`type`	string	Sí	Siempre `whatsapp.business_account.deleted`.
`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, con formato 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 se aplica cuando su objeto superior 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 descriptivo para diferenciar las cuentas de WhatsApp Business.
`removedReason`	string	No	Motivo sin procesar del evento de eliminación de la cuenta de WhatsApp Business. Los valores conocidos incluyen: `ACCOUNT_DISCONNECTED`: La cuenta se desconectó debido a una medida de cumplimiento o porque se eliminó explícitamente la cuenta de WhatsApp. `BUSINESS_DOWNGRADE`: El número de teléfono se registró con la aplicación de WhatsApp para consumidores. `CHANGE_NUMBER`: Se cambió el número de teléfono de WhatsApp. `COMPANION_INACTIVITY`: Un dispositivo complementario estuvo inactivo durante aproximadamente 30 días. `PRIMARY_INACTIVITY`: Un dispositivo principal estuvo inactivo durante aproximadamente 30 días. `USER_RE_REGISTERED`: WhatsApp se volvió a registrar en un dispositivo nuevo. Los valores desconocidos se devuelven tal como se reciben.
`removedInitiatedBy`	string	No	Iniciador sin procesar del evento de eliminación de la cuenta de WhatsApp Business. Los valores conocidos incluyen: `USER`: La eliminación fue iniciada por el usuario de WhatsApp. `SYSTEM`: La eliminación fue iniciada por el sistema de Meta. Los valores desconocidos se devuelven tal como se reciben.
`removedTime`	string (date-time)	No	La fecha y hora en la que se recibió el evento de eliminación de la cuenta de WhatsApp Business, con formato RFC 3339. Por ejemplo, `2026-05-19T12:00:00.000Z`.

Ejemplo

El siguiente JSON es el cuerpo entregado a tu receptor. Los ID, los números de teléfono y otros valores de cuenta son ilustrativos. Lee whatsappBusinessAccount.id para identificar la cuenta. Cuando estén presentes, removedReason, removedInitiatedBy y removedTime describen la eliminación. Conserva los valores desconocidos de motivo e iniciador.

{
  "id": "evt_business_account_deleted_123",
  "type": "whatsapp.business_account.deleted",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "whatsapp-business-account-id",
    "name": "Example business",
    "removedReason": "ACCOUNT_DISCONNECTED",
    "removedInitiatedBy": "USER",
    "removedTime": "2026-05-26T12:00:00.000Z"
  }
}

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

HTTP/1.1 200 OK

Para ver tutoriales paso a paso de situaciones prácticas, consulta los ejemplos comentados.

Primeros pasos

Guías

Endpoints

Webhook reference

whatsapp.business_account.deleted

Desencadenadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

whatsappBusinessAccount

Ejemplo

​Desencadenadores

​Sintaxis

​Parámetros

​Envoltorio del evento

​Carga útil del evento

​whatsappBusinessAccount

​Ejemplo

Desencadenadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

whatsappBusinessAccount

Ejemplo