Webhook di soppressione WhatsApp

whatsapp_suppression.created si attiva quando si apre una soppressione nella lista di soppressione dello spazio di lavoro, così i tuoi sistemi possono vedere i nuovi blocchi senza polling.

Il payload

Esempio di codice

{
  "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 soppressione.
address è il numero soppresso in formato E.164.
waba è il WhatsApp Business Account a cui è limitato il blocco, oppure null quando copre l'intero spazio di lavoro, indipendentemente dall'account che invia.
reason indica il motivo per cui la soppressione è stata aperta.
workspace_id è lo spazio di lavoro che possiede la lista.

Cosa non si attiva

Solo le aperture generano un evento. La chiusura di una soppressione non lo genera ancora, quindi rileggi la lista prima di considerare ancora attivo un blocco replicato.

Un opt-out dichiarato dal destinatario stesso è una preferenza e non una soppressione, e attiva preference.revoked al suo posto.

Passaggi successivi

Soppressioni: come una soppressione blocca gli invii e come gestire la lista
Preferenze: opt-out dichiarati dal destinatario stesso

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaConnecting WhatsApp to Bird: from buying a number to a live channel Comprendi il concettoWhat is the 24-hour customer service window on WhatsApp?Usa lo strumentoWhatsApp message builder Esplora la funzionalitàWhatsApp

Prova l'esercitazione e ottieni un brief di implementazione