WhatsApp suppression webhooks

whatsapp_suppression.created fires when a suppression opens on the workspace's suppression list, so your own systems can see new blocks without polling.

The payload

Contoh kode

{
  "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 names the suppression.
address is the suppressed number in E.164 format.
waba is the WhatsApp Business Account the block is limited to, or null when it covers the whole workspace, whichever account sends.
reason says why the suppression opened.
workspace_id is the workspace that owns the list.

What does not fire

Only openings fire an event. Ending a suppression does not yet, so re-read the list before treating a mirrored block as still standing.

An opt-out the recipient stated themselves is a preference rather than a suppression, and fires preference.revoked instead.

Next steps

Suppressions: how a suppression blocks sends and how to manage the list
Preferences: opt-outs the recipient stated themselves

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaConnecting WhatsApp to Bird: from buying a number to a live channel Pahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builder Jelajahi kemampuannyaWhatsApp

Coba praktiknya dan dapatkan ringkasan implementasi