> ## Documentation Index > Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt > Use this file to discover all available pages before exploring further. # whatsapp.business_account.updated > Ocurre cuando se produce una infracción de políticas, se suspende la cuenta de WhatsApp Business y más. 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](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md). ## 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. ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "id": "", "type": "whatsapp.business_account.updated", "apiVersion": "", "createTime": "", "whatsappBusinessAccount": { "id": "", "name": "", "updateEvent": "", "violationType": "", "restrictions": [ { "restrictionType": "", "expiration": "" } ] } } ``` ## Parámetros Valida el encabezado HTTP `YCloud-Signature` antes de procesar el cuerpo JSON. Consulta [validación de firma](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md). ### 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](https://datatracker.ietf.org/doc/html/rfc3339). 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](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement), 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](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates).
  • `BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE`: Se configuró la [ubicación comercial principal](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates#primary-business-location) 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/policy-enforcement-violations) 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/direct-send/integrity-and-content-guidelines#webhook-for-account-restriction) 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](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement). | | `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](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates). | | `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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). | > [accordion] 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](https://datatracker.ietf.org/doc/html/rfc3339). Por ejemplo, `2022-06-01T12:00:00.000Z`. | > [accordion] whatsappBusinessAccount.authIntlRateEligibilityCountries\[] > > | Parámetro | Tipo | Requerido | Descripción | > | - | - | - | - | > | `countryCode` | string | No | [Código de país ISO 3166-1 alfa-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-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](https://datatracker.ietf.org/doc/html/rfc3339). 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. > [accordion] 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. > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "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" > } > ] > } > } > ``` > [accordion] Elegibilidad para tarifas de autenticación internacional > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "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" > } > ] > } > } > ``` > [accordion] Actualización de la ubicación comercial principal > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "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" > } > } > ``` > [accordion] Actualización del límite de registro de números de teléfono > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "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 > } > } > ``` > [accordion] Infracción de cuenta > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "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" > } > } > ``` > [accordion] Restricción de cuenta > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "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" > } > ] > } > } > ``` > [accordion] Cuenta desactivada > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "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" > } > } > ``` > [accordion] Restablecimiento de cuenta > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "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 theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK ``` Para ver descripciones paso a paso de situaciones, consulta los [ejemplos comentados](https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.