whatsapp.business_account.updated

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

Disparadores

Ocurre cuando se produce una infracción de políticas, se suspende la cuenta de WhatsApp Business y más. Suscríbete a whatsapp.business_account.updated 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 del payload. 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.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappBusinessAccount": {
    "id": "<ID>",
    "name": "<NAME>",
    "updateEvent": "<UPDATE_EVENT>",
    "violationType": "<VIOLATION_TYPE>",
    "restrictions": [
      {
        "restrictionType": "<RESTRICTION_TYPE>",
        "expiration": "<EXPIRATION>"
      }
    ]
  }
}

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.updated`.
`apiVersion`	string	Sí	La versión de la API utilizada para generar este evento.
`createTime`	string (date-time)	Sí	Fecha y hora en que se creó este evento, en formato RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.

Payload del evento

Parámetro	Tipo	Obligatorio	Descripción
`whatsappBusinessAccount`	object	No	Payload específico del evento `whatsappBusinessAccount`.

Los cuatro campos comunes del envoltorio son obligatorios. Los campos del payload 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 de 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 reconocible para diferenciar cuentas de WhatsApp Business.
`accountReviewStatus`	string	No	Estado de revisión de la cuenta de WhatsApp Business. Valores: `PENDING`, `APPROVED`, `REJECTED`.
`updateEvent`	string	No	Indica el tipo de evento de actualización de la WABA cuando se te envía una notificación para reportar una infracción de políticas, que se ha suspendido una WABA y más. `DISABLED_UPDATE`: Cuenta de WhatsApp Business suspendida. `ACCOUNT_RESTRICTION`: Cuenta de WhatsApp Business restringida debido a infracciones de políticas. `ACCOUNT_VIOLATION`: La cuenta de WhatsApp Business infringe las políticas. `PARTNER_REMOVED`: La cuenta de WhatsApp Business se eliminó de la conexión del socio. `PARTNER_APP_UNINSTALLED`: Se desinstaló la aplicación de socio de la cuenta de WhatsApp Business. `AUTH_INTL_PRICE_ELIGIBILITY_UPDATE`: La cuenta de WhatsApp Business es apta para la tarifa internacional de autenticación. `BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE`: Se configuró la ubicación comercial principal del negocio. `BUSINESS_CAPABILITY_UPDATE`: Meta reportó un cambio en el portafolio comercial o en el límite de registro de números de teléfono de la WABA.
`banState`	string	No	El estado de suspensión de la cuenta de WhatsApp Business. Valores: `SCHEDULE_FOR_DISABLE`, `DISABLE`, `REINSTATE`.
`banDate`	string	No	La fecha en que se suspende la WABA.
`violationType`	string	No	Se usa para informar sobre las infracciones impuestas a la WABA. Consulta Infracciones de cumplimiento de políticas de Meta para conocer los tipos de infracciones y sus descripciones. Meta puede actualizar esta lista con el tiempo. Para conocer los tipos de infracciones de Utility Direct Send y los detalles de las restricciones, consulta el Webhook para restricción de cuentas de Meta.
`restrictions`	object[]	No	Se usa para informar sobre las restricciones impuestas a la WABA, cuando esa WABA infringe las políticas de la Plataforma de WhatsApp Business.
`maxPhoneNumbersPerBusiness`	integer (int32)	No	Se incluye en un webhook `whatsapp.business_account.updated` con `updateEvent=BUSINESS_CAPABILITY_UPDATE` cuando Meta informa el límite de registro de números de teléfono de Business Portfolio. Actualmente, Meta informa este campo por separado de `maxPhoneNumbersPerWaba`, pero los consumidores deben procesar ambos si una actualización futura los incluye juntos.
`maxPhoneNumbersPerWaba`	integer (int32)	No	Se incluye en un webhook `whatsapp.business_account.updated` con `updateEvent=BUSINESS_CAPABILITY_UPDATE` cuando Meta informa el límite de registro de números de teléfono de la WABA. Actualmente, Meta informa este campo por separado de `maxPhoneNumbersPerBusiness`, pero los consumidores deben procesar ambos si una actualización futura los incluye juntos.
`authIntlRateEligibilityCountries`	object[]	No	A partir del 1 de junio de 2024, actualizaremos nuestra tabla de tarifas de autenticación e introduciremos una nueva tarifa de autenticación internacional. Esta tarifa se aplicará en los siguientes países: 1 de junio de 2024: Indonesia (código de llamada de país +62, código de país `ID`) 1 de julio de 2024: India (código de llamada de país +91, código de país `IN`) Consulta también Tarifas de autenticación internacional.
`primaryBusinessLocation`	string	No	Tu ubicación comercial principal es el país donde tiene su sede tu empresa. Aparecerá en Business Manager en el campo Ubicación comercial principal a partir del 1 de mayo de 2024. Código de país ISO 3166-1 alfa-2.

whatsappBusinessAccount.restrictions[]

Parámetro	Tipo	Requerido	Descripción
`restrictionType`	string	No	Tipo de restricción. Valores: `RESTRICTED_ADD_PHONE_NUMBER_ACTION`, `RESTRICTED_BIZ_INITIATED_MESSAGING`, `RESTRICTED_CUSTOMER_INITIATED_MESSAGING`, `RESTRICTED_DIRECT_SEND_UTILITY_TEMPLATES`.
`expiration`	string (date-time)	No	La hora a la que expira esta restricción, con formato según RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.

whatsappBusinessAccount.authIntlRateEligibilityCountries[]

Parámetro	Tipo	Requerido	Descripción
`countryCode`	string	No	Código de país ISO 3166-1 alfa-2.
`startTime`	string (date-time)	No	Fecha en la que las conversaciones de autenticación recién abiertas están sujetas a tarifas de autenticación internacional, con formato según RFC 3339. Por ejemplo, `2024-07-01T00:00:00.000Z`.

Ejemplo

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

Evento de restricción de Utility Direct Send

Meta restringió Utility Direct Send durante 7 días tras el uso indebido reiterado de categorías.

{
  "id": "evt_direct_send_restriction_123",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "v2",
  "createTime": "2026-09-17T08:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "whatsapp-business-account-id",
    "name": "Example business",
    "updateEvent": "ACCOUNT_RESTRICTION",
    "violationType": "DIRECT_SEND_UTILITY_CATEGORY_ABUSE_STRIKE_1",
    "restrictions": [
      {
        "restrictionType": "RESTRICTED_DIRECT_SEND_UTILITY_TEMPLATES",
        "expiration": "2026-09-24T08:00:00.000Z"
      }
    ]
  }
}

Elegibilidad para tarifas de autenticación internacional

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "v2",
  "createTime": "2024-06-01T00:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "106681...",
    "updateEvent": "AUTH_INTL_PRICE_ELIGIBILITY_UPDATE",
    "authIntlRateEligibilityCountries": [
      {
        "countryCode": "IN",
        "startTime": "2024-07-01T00:00:00.000Z"
      },
      {
        "countryCode": "ID",
        "startTime": "2024-07-01T00:00:00.000Z"
      }
    ]
  }
}

Actualización de la ubicación comercial principal

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "v2",
  "createTime": "2024-06-01T00:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "106681...",
    "updateEvent": "BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE",
    "primaryBusinessLocation": "US"
  }
}

Actualización del límite de registro de números de teléfono

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "v2",
  "createTime": "2026-09-23T00:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "106681...",
    "updateEvent": "BUSINESS_CAPABILITY_UPDATE",
    "maxPhoneNumbersPerWaba": 25
  }
}

Infracción de cuenta

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "v2",
  "createTime": "2024-06-01T00:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "106681...",
    "updateEvent": "ACCOUNT_VIOLATION",
    "violationType": "SCAM"
  }
}

Restricción de cuenta

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "v2",
  "createTime": "2024-06-01T00:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "106681...",
    "updateEvent": "ACCOUNT_RESTRICTION",
    "restrictions": [
      {
        "restrictionType": "RESTRICTED_ADD_PHONE_NUMBER_ACTION",
        "expiration": "2024-09-01T12:00:00.000Z"
      },
      {
        "restrictionType": "RESTRICTED_BIZ_INITIATED_MESSAGING",
        "expiration": "2024-09-01T12:00:00.000Z"
      },
      {
        "restrictionType": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
        "expiration": "2024-09-01T12:00:00.000Z"
      }
    ]
  }
}

Cuenta desactivada

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "v2",
  "createTime": "2024-06-01T00:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "106681...",
    "updateEvent": "DISABLED_UPDATE",
    "banDate": "September 19, 2024",
    "banState": "DISABLE"
  }
}

Restablecimiento de cuenta

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "v2",
  "createTime": "2024-06-01T00:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "106681...",
    "updateEvent": "DISABLED_UPDATE",
    "banState": "REINSTATE",
    "banDate": "December 27, 2024",
    "accountReviewStatus": "APPROVED"
  }
}

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

HTTP/1.1 200 OK

Para ver descripciones paso a paso de situaciones, consulta los ejemplos comentados.

Primeros pasos

Guías

Endpoints

Webhook reference

whatsapp.business_account.updated

Disparadores

Sintaxis

Parámetros

Envoltorio del evento

Payload del evento

whatsappBusinessAccount

Ejemplo

​Disparadores

​Sintaxis

​Parámetros

​Envoltorio del evento

​Payload del evento

​whatsappBusinessAccount

​Ejemplo

Disparadores

Sintaxis

Parámetros

Envoltorio del evento

Payload del evento

whatsappBusinessAccount

Ejemplo