---
title: "WhatsApp 屏蔽 Webhook"
description: "whatsapp_suppression.created 载荷，在屏蔽生效时触发，使您的系统无需轮询即可同步新的拦截记录。"
canonical: "https://bird.com/zh-sg/wendang/guides/whatsapp/webhooks/suppressions"
---

# WhatsApp 屏蔽 Webhook

`whatsapp_suppression.created` 在工作区的[屏蔽列表](/docs/guides/whatsapp/opt-outs/suppressions)中新增屏蔽时触发，使您的系统无需轮询即可获知新的拦截。

## 载荷

```json
{
  "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` 是屏蔽的名称。
- `address` 是被屏蔽的号码，采用 E.164 格式。
- `waba` 是该拦截所限定的 WhatsApp Business Account；如果拦截覆盖整个工作区（无论哪个账号发送），则为 `null`。
- `reason` 说明屏蔽生效的原因。
- `workspace_id` 是拥有该列表的工作区。

## 不会触发的情况

只有新增屏蔽会触发事件。移除屏蔽目前不会触发事件，因此在将已同步的拦截视为仍然有效之前，请重新读取屏蔽列表。

收件人自行声明的退订属于[偏好设置](/docs/guides/webhooks#preference-events)而非屏蔽，会触发 `preference.revoked`。

## 后续步骤

- [屏蔽](/docs/guides/whatsapp/opt-outs/suppressions)：屏蔽如何阻止发送以及如何管理屏蔽列表
- [偏好设置](/docs/guides/whatsapp/opt-outs/preferences)：收件人自行声明的退订

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)