Webhooks de supresión de WhatsApp

whatsapp_suppression.created se dispara cuando se abre una supresión en la lista de supresiones del espacio de trabajo, para que tus propios sistemas puedan ver los nuevos bloqueos sin hacer polling.

El payload

Ejemplo de código

{
  "type": "whatsapp_suppression.created",
  "timestamp": "2026-08-25T14:52:03.192524705Z",
  "data": {
    "suppression_id": "was_01krdgeqcxet5s7t44vh8rt9mg",
    "address": "+14155550100",
    "waba": null,
    "reason": "manual",
    "workspace_id": "ws_01ky7m21hjffh9s8kq76gyb1xf"
  }
}

suppression_id identifica la supresión.
address es el número suprimido en formato E.164.
waba es la cuenta de negocio de WhatsApp a la que se limita el bloqueo, o null cuando cubre todo el espacio de trabajo, sin importar qué cuenta envíe.
reason indica por qué se abrió la supresión.
workspace_id es el espacio de trabajo que posee la lista.

Qué no se dispara

Solo las aperturas disparan un evento. Finalizar una supresión aún no lo hace, así que vuelve a leer la lista antes de dar por vigente un bloqueo reflejado.

Una baja solicitada por el propio destinatario es una preferencia y no una supresión, y dispara preference.revoked en su lugar.

Próximos pasos

Supresiones: cómo una supresión bloquea envíos y cómo gestionar la lista
Preferencias: bajas solicitadas por el propio destinatario

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Ver la guíaConnecting WhatsApp to Bird: from buying a number to a live channel Comprender el conceptoWhat is the 24-hour customer service window on WhatsApp?Usar la herramientaWhatsApp message builder Explorar la funcionalidadWhatsApp

Prueba el ejercicio y obtén un resumen de implementación