WhatsApp 屏蔽 Webhook

whatsapp_suppression.created 在工作区的屏蔽列表中新增屏蔽时触发，使您的系统无需轮询即可获知新的拦截。

载荷

{
  "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 是拥有该列表的工作区。

不会触发的情况

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

收件人自行声明的退订属于偏好设置而非屏蔽，会触发 preference.revoked。

后续步骤

• 屏蔽：屏蔽如何阻止发送以及如何管理屏蔽列表
• 偏好设置：收件人自行声明的退订