WhatsApp 退订与关键词
工作区中记录的屏蔽条目,或收件人声明的偏好设置,都会阻止 WhatsApp 发送。两者是独立的记录,存储在不同的位置。
本页说明两者的区别,以及本节其余内容使用的术语。子页面涵盖您需要操作的三项内容:Bird 在您号码上应答的关键词、收件人声明的偏好设置,以及您维护的屏蔽列表。
屏蔽与偏好设置
| 屏蔽 | 偏好设置 | |
|---|---|---|
| 定义 | 工作区不再发送消息的地址 | 关于收件人意愿的声明 |
| 记录者 | 您,通过仪表板或 API | 收件人,或您代其操作 |
| 覆盖内容 | 在其作用域内发往该地址的所有消息 | 所有消息,或营销消息 |
| 存储位置 | Suppressions 列表 | Preferences 选项卡 |
| 撤销权限 | 您,仅限您添加的记录 | 声明该偏好的人 |
作用域与覆盖范围
两个属性描述一条记录的影响范围。
作用域指记录适用于您的哪些 WhatsApp Business Account。作用域为单个帐户的记录不影响您的其他帐户向该地址发送消息。作用域为工作区的记录覆盖所有帐户,包括之后接入的帐户。
覆盖范围指记录阻止哪些消息。All messages 阻止所有消息。Non-transactional 阻止营销及其他非必要消息,而事务性消息(如验证码)不受影响。
屏蔽记录具有作用域,并阻止其范围内的所有消息。偏好设置同时具有作用域和覆盖范围。
发送时的处理逻辑
发送和投递是两个独立的阶段,因此屏蔽不会作为即时错误返回。Bird 接受发送请求,然后以携带 error.code: "recipient_suppressed" 的 whatsapp.rejected 事件异步将其标记为失败。如果您正在核查一条在 API 响应成功后消失的消息,该事件中包含了原因。
屏蔽记录会阻止在其作用域内发往该地址的所有消息。偏好设置按其覆盖范围阻止对应消息。Bird 在向个人发送时会检查两个存储。向群组发送时不检查任何一个存储,因此请在您自己的发送逻辑中处理成员的退订。
查看位置
打开 Suppressions 页面可查看两个存储。Suppressions 选项卡列出工作区屏蔽的地址,其 Business account 列显示每条记录的作用域帐户,或显示 All accounts 表示工作区级记录。同一页面的 Preferences 选项卡列出收件人的偏好声明。

关键词需单独配置,在 Keywords 页面操作。
在更改收件人的记录之前,请同时查看两个选项卡。在一个选项卡中找不到的记录可能存在于另一个中,而且删除屏蔽记录不会清除偏好设置。