Webhooks de supressão do WhatsApp

whatsapp_suppression.created é disparado quando uma supressão é criada na lista de supressão do espaço de trabalho, para que seus próprios sistemas possam ver novos bloqueios sem consultar a lista.

O payload

Exemplo 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 nomeia a supressão.
address é o número suprimido no formato E.164.
waba é a conta comercial do WhatsApp à qual o bloqueio se limita, ou null quando ele cobre todo o espaço de trabalho, independentemente de qual conta envia.
reason indica por que a supressão foi criada.
workspace_id é o espaço de trabalho que possui a lista.

O que não é disparado

Apenas criações disparam um evento. O encerramento de uma supressão ainda não dispara, então consulte a lista novamente antes de tratar um bloqueio espelhado como ainda vigente.

Um opt-out declarado pelo próprio destinatário é uma preferência, não uma supressão, e dispara preference.revoked em vez disso.

Próximos passos

Supressões: como uma supressão bloqueia envios e como gerenciar a lista
Preferências: opt-outs declarados pelo próprio destinatário

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Assista ao guiaConnecting WhatsApp to Bird: from buying a number to a live channel Entenda o conceitoWhat is the 24-hour customer service window on WhatsApp?Use a ferramentaWhatsApp message builder Explore a funcionalidadeWhatsApp

Experimente na prática e obtenha um resumo de implementação