Resumen

Esta guía explica los eventos de webhook relacionados con las Cuentas de WhatsApp Business (WABA) y los números de teléfono en Wati. Estos eventos le ayudan a monitorizar en tiempo real los cambios en el estado de la cuenta, las actualizaciones de políticas, las actualizaciones de la calidad de los números de teléfono y los eventos de eliminación. Puede utilizar estos webhooks para automatizar notificaciones, activar flujos de trabajo y mantener sus sistemas internos sincronizados con Wati.

Nota: Para obtener más información sobre los webhooks de Wati, consulte la documentación para desarrolladores de Wati.

Instrucciones

1. Actualización de la revisión del estado de la WABA

Este webhook se activa cuando cambia el estado de revisión de una Cuenta de WhatsApp Business.

Se activa cuando: Cambia el estado de revisión de una Cuenta de WhatsApp Business (WABA)
Evento: wabaStatusReviewUpdate
Estado: Estado de revisión de WABA actualizado

Carga útil de ejemplo del webhook

{
  "eventType": "wabaStatusReviewUpdate",
  "accountReviewStatus": "APPROVED",
  "wabaId": "330039560200863"
}

Valores del estado de revisión de la WABA

Valor del estado	Descripción
`APPROVED`	La Cuenta de WhatsApp Business está aprobada y lista para usarse con las API.
`REJECTED`	La Cuenta de WhatsApp Business fue rechazada debido a violaciones de políticas y no se puede usar con las API.
`PENDING`	El proceso de revisión aún está pendiente y la Cuenta de WhatsApp Business aún no se puede usar con las API.
`DEFERRED`	La decisión de revisión se ha aplazado y la Cuenta de WhatsApp Business actualmente no se puede usar con las API.

Casos de uso

Monitorizar automáticamente los cambios en el estado de revisión de la Cuenta de WhatsApp Business
Notificar a los administradores cuando una WABA sea aprobada o rechazada
Activar flujos de trabajo de incorporación después de la aprobación de la WABA
Pausar flujos de trabajo relacionados con la API cuando una WABA esté pendiente o aplazada
Mantener los sistemas internos sincronizados con las actualizaciones de revisión de la WABA

2. Cuenta de WABA eliminada

Este webhook se activa cuando se elimina una Cuenta de WhatsApp Business.

Se activa cuando: Se elimina una Cuenta de WhatsApp Business (WABA)
Evento: accountDeleted
Estado: Cuenta de WABA eliminada

Carga útil de ejemplo del webhook

{
  "eventType": "accountDeleted",
  "wabaId": "message.WabaId"
}

Casos de uso

Detectar cuándo se elimina una Cuenta de WhatsApp Business
Notificar a los administradores sobre las cuentas de WABA eliminadas
Eliminar las cuentas de WABA desconectadas de los sistemas internos
Activar flujos de trabajo de limpieza después de la eliminación de la cuenta
Mantener los registros de cuentas sincronizados con las actualizaciones de Wati

3. Contenido de la cuenta de WABA actualizado

Este webhook se activa cuando una Cuenta de WhatsApp Business recibe actualizaciones relacionadas con la cuenta, como violaciones de políticas, prohibiciones o restricciones.

Se activa cuando: Una Cuenta de WhatsApp Business (WABA) recibe una actualización relacionada con la cuenta, como violaciones de políticas, prohibiciones o restricciones
Evento: accountUpdated
Estado: Cuenta de WABA actualizada

Carga útil de ejemplo del webhook

{
  "eventType": "accountUpdated",
  "wabaId": "message.WabaId",
  "event": "message.Event",
  "violationInfo": {
    "violation_type": "message.ViolationType"
  },
  "banInfo": {
    "waba_ban_state": "message.WabaBanState",
    "waba_ban_date": "message.WabaBanDate"
  },
  "restriction_info": [
    {
      "restriction_type": "RESTRICTED_ADD_PHONE_NUMBER_ACTION",
      "expiration": "2026-04-19T13:59:20+0000"
    },
    {
      "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
      "expiration": "2026-04-19T13:59:20+0000"
    },
    {
      "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
      "expiration": "2026-04-19T13:59:20+0000"
    }
  ]
}

Tipos de restricción

Tipo de restricción	Descripción
`RESTRICTED_ADD_PHONE_NUMBER_ACTION`	Restringe la adición de nuevos números de teléfono a la WABA.
`RESTRICTED_BIZ_INITIATED_MESSAGING`	Restringe la mensajería iniciada por la empresa.
`RESTRICTED_CUSTOMER_INITIATED_MESSAGING`	Restringe la mensajería iniciada por el cliente.

Casos de uso

Monitorizar violaciones de políticas en las Cuentas de WhatsApp Business
Detectar automáticamente prohibiciones o restricciones de cuenta
Notificar a los administradores sobre problemas de salud de la cuenta
Activar flujos de trabajo cuando se apliquen restricciones de mensajería
Mantener los sistemas de cumplimiento y monitorización sincronizados con las actualizaciones de la WABA
Rastrear las fechas de vencimiento de las restricciones para la planificación operativa

4. Evento de actualización de calidad de número de teléfono

Este webhook se activa cuando cambian la calidad de mensajería, el rendimiento o el límite de mensajes de un número de teléfono de WhatsApp.

Se activa cuando: Cambia la calidad de mensajería, el rendimiento o el límite de mensajes de un número de teléfono de WhatsApp
Evento: PhoneNumberQualityUpdatedEvent
Estado: Calidad del número de teléfono actualizado

Carga útil de ejemplo del webhook

{
  "eventType": "PhoneNumberQualityUpdatedEvent",
  "phoneNumber": "12177593225",
  "event": "THROUGHPUT_UPGRADE",
  "currentLimit": "TIER_UNLIMITED",
  "oldLimit": "",
  "channelId": null,
  "channelPhoneNumber": "17735704742"
}

Valores de límite de mensajes y rendimiento

Valor	Descripción
`TIER_50`	Límite de mensajes de 50.
`TIER_250`	Límite de mensajes de 250.
`TIER_1K`	Límite de mensajes de 1.000.
`TIER_10K`	Límite de mensajes de 10.000.
`TIER_100K`	Límite de mensajes de 100.000.
`TIER_NOT_SET`	El número de teléfono de la empresa aún no se ha utilizado para enviar mensajes.
`TIER_UNLIMITED`	El número de teléfono de la empresa tiene un rendimiento superior y capacidad de mensajería ilimitada.

Casos de uso

Monitorizar automáticamente los cambios en el límite de mensajes y el rendimiento
Detectar actualizaciones o degradaciones de la calidad del número de teléfono
Notificar a los administradores cuando cambie la capacidad de mensajería
Rastrear las mejoras de nivel de mensajería en los números de WhatsApp
Activar flujos de trabajo operativos basados en cambios de rendimiento

5. Número de teléfono eliminado

Este webhook se activa cuando se elimina un número de teléfono de una Cuenta de WhatsApp Business.

Se activa cuando: Se elimina un número de teléfono de una Cuenta de WhatsApp Business (WABA)
Evento: phoneNumberDeleted
Estado: Número de teléfono eliminado

Carga útil de ejemplo del webhook

{
  "eventType": "phoneNumberDeleted",
  "wabaId": "message.WabaId",
  "phoneNumber": "message.PhoneNumber"
}

Casos de uso

Detectar cuándo se elimina un número de teléfono de una Cuenta de WhatsApp Business
Notificar a los administradores sobre los números de WhatsApp eliminados
Eliminar números de teléfono desconectados de los sistemas internos
Activar flujos de trabajo de limpieza después de la eliminación del número de teléfono
Mantener los registros de cuentas y canales sincronizados con las actualizaciones de Wati

Preguntas frecuentes (FAQ)

Eventos de webhook de WABA

1. ¿Para qué se utilizan los eventos de webhook de WABA y números de teléfono en Wati?

Los eventos de webhook de WABA y números de teléfono en Wati se utilizan para monitorizar en tiempo real los cambios en el estado de la cuenta, las actualizaciones de políticas, las actualizaciones de la calidad de los números de teléfono y los eventos de eliminación. Estos webhooks pueden ayudar a automatizar notificaciones, activar flujos de trabajo y mantener los sistemas internos sincronizados con Wati.

2. ¿Qué significa el evento de webhook wabaStatusReviewUpdate?

El evento de webhook wabaStatusReviewUpdate se activa cuando cambia el estado de revisión de una Cuenta de WhatsApp Business (WABA).

3. ¿Qué significan los valores del estado de revisión de la WABA?

Los valores del estado de revisión de la WABA tienen los siguientes significados:

APPROVED significa que la Cuenta de WhatsApp Business está aprobada y lista para usarse con las API.
REJECTED significa que la Cuenta de WhatsApp Business fue rechazada debido a violaciones de políticas y no se puede usar con las API.
PENDING significa que el proceso de revisión aún está pendiente y la Cuenta de WhatsApp Business aún no se puede usar con las API.
DEFERRED significa que la decisión de revisión se ha aplazado y la Cuenta de WhatsApp Business actualmente no se puede usar con las API.

4. ¿Qué significa el evento de webhook accountDeleted?

El evento de webhook accountDeleted se activa cuando se elimina una Cuenta de WhatsApp Business (WABA).

5. ¿Qué significa el evento de webhook accountUpdated?

El evento de webhook accountUpdated se activa cuando una Cuenta de WhatsApp Business recibe actualizaciones relacionadas con la cuenta, como violaciones de políticas, prohibiciones o restricciones.

6. ¿Qué tipos de restricción pueden incluirse en el webhook accountUpdated?

El webhook accountUpdated puede incluir los siguientes tipos de restricción:

RESTRICTED_ADD_PHONE_NUMBER_ACTION restringe la adición de nuevos números de teléfono a la WABA.
RESTRICTED_BIZ_INITIATED_MESSAGING restringe la mensajería iniciada por la empresa.
RESTRICTED_CUSTOMER_INITIATED_MESSAGING restringe la mensajería iniciada por el cliente.

7. ¿Qué significa el evento de webhook PhoneNumberQualityUpdatedEvent?

El evento de webhook PhoneNumberQualityUpdatedEvent se activa cuando cambian la calidad de mensajería, el rendimiento o el límite de mensajes de un número de teléfono de WhatsApp.

8. ¿Qué significan los valores del límite de mensajes en el webhook PhoneNumberQualityUpdatedEvent?

Los valores del límite de mensajes indican la capacidad de mensajería de un número de teléfono de WhatsApp:

TIER_50 significa un límite de mensajes de 50.
TIER_250 significa un límite de mensajes de 250.
TIER_1K significa un límite de mensajes de 1.000.
TIER_10K significa un límite de mensajes de 10.000.
TIER_100K significa un límite de mensajes de 100.000.
TIER_NOT_SET significa que el número de teléfono de la empresa aún no se ha utilizado para enviar mensajes.
TIER_UNLIMITED significa que el número de teléfono de la empresa tiene un rendimiento superior y capacidad de mensajería ilimitada.

9. ¿Qué significa el evento de webhook phoneNumberDeleted?

El evento de webhook phoneNumberDeleted se activa cuando se elimina un número de teléfono de una Cuenta de WhatsApp Business (WABA).

Cómo usar eventos de webhook de número de teléfono y WABA

Resumen

Instrucciones

1. Actualización de la revisión del estado de la WABA

Carga útil de ejemplo del webhook

Valores del estado de revisión de la WABA

Casos de uso

2. Cuenta de WABA eliminada

Carga útil de ejemplo del webhook

Casos de uso

3. Contenido de la cuenta de WABA actualizado

Carga útil de ejemplo del webhook

Tipos de restricción

Casos de uso

4. Evento de actualización de calidad de número de teléfono

Carga útil de ejemplo del webhook

Valores de límite de mensajes y rendimiento

Casos de uso

5. Número de teléfono eliminado

Carga útil de ejemplo del webhook

Casos de uso

Preguntas frecuentes (FAQ)

Eventos de webhook de WABA

1. ¿Para qué se utilizan los eventos de webhook de WABA y números de teléfono en Wati?

2. ¿Qué significa el evento de webhook wabaStatusReviewUpdate?

3. ¿Qué significan los valores del estado de revisión de la WABA?

4. ¿Qué significa el evento de webhook accountDeleted?

5. ¿Qué significa el evento de webhook accountUpdated?

6. ¿Qué tipos de restricción pueden incluirse en el webhook accountUpdated?

7. ¿Qué significa el evento de webhook PhoneNumberQualityUpdatedEvent?

8. ¿Qué significan los valores del límite de mensajes en el webhook PhoneNumberQualityUpdatedEvent?

9. ¿Qué significa el evento de webhook phoneNumberDeleted?