为什么我的 WhatsApp 模板消息显示为“undeliverable”？

当通过 SparkTG WhatsApp Business API 发送的模板消息未能到达收件人时，营销活动日志会显示该联系人投递失败。这并不意味着 SparkTG 未能发送消息：而是表示消息发出之后，WhatsApp 投递层返回了无法送达的状态。根本原因始终在收件人一侧或 Meta 的投递政策。

是什么导致模板消息无法送达？

WhatsApp 将外发模板消息标记为无法送达有五种不同的原因。判断哪一种适用于你的情况，是最快的解决途径。

原因 1：收件人的号码不在 WhatsApp 上

该电话号码存在，但从未注册 WhatsApp，或与该号码关联的 WhatsApp 账户已被停用。对于刚导入的联系人列表，这是导致营销活动大面积失败的最常见原因。

1. 1

   发送前使用 SparkTG 的号码验证

   SparkTG Dashboard → Campaigns → New Campaign → Audience。在安排发送之前，点击 Validate Contacts。SparkTG 会在 WhatsApp 数据库中检查每个号码，并标记未注册的号码，使你能在消耗任何额度之前将其排除。

2. 2

   定期清理你的联系人列表

   半年前有效的号码现在可能已不是活跃的 WhatsApp 账户。对任何超过 90 天的联系人列表，请在用于营销活动之前先运行验证。

原因 2：收件人屏蔽了你企业的号码

如果用户屏蔽了你的 WhatsApp Business 号码，所有外发消息（包括模板消息）都会被悄悄标记为无法送达。为保护用户隐私，企业被屏蔽时 WhatsApp 不会通知企业。

• 你无法自行解除屏蔽：只有收件人才能取消屏蔽。
• 通过其他渠道（邮件、短信、电话）联系对方，请他们在 WhatsApp 中查看 Settings → Privacy → Blocked Contacts。
• 营销活动中屏蔽率较高，说明你的消息内容或频率不受欢迎：请审核你的 opt-in 流程和模板相关性。

原因 3：收件人尚未接受 WhatsApp 最新的服务条款

WhatsApp 会定期更新服务条款。在用户接受更新后的条款之前，即使仍可收发个人消息，也无法接收来自 Business API 的消息。

1. 1

   请收件人打开 WhatsApp

   有待接受的更新条款时，用户下次打开应用，WhatsApp 会显示接受提示。用户只需打开 WhatsApp 并接受即可。

2. 2

   如果提示没有自动出现

   请收件人前往 WhatsApp → Settings → Help → Terms and Privacy Policy。如果有待接受的更新版本，会显示在那里。

3. 3

   接受后重试

   收件人接受条款后，请从 SparkTG Dashboard → Campaign Logs → 选择失败的联系人 → Retry 重试该消息。

原因 4：收件人使用的 WhatsApp 版本过旧

带有交互式按钮、头部或富媒体内容的模板消息，要求收件人设备上的 WhatsApp 达到最低版本。非常旧的应用版本无法显示这类消息。

• Android：2.21.15.15 或更高版本
• WhatsApp Business (Android)：2.21.15.15 或更高版本
• iOS：2.21.170.4 或更高版本
• WhatsApp Business (iOS)：2.21.170.4 或更高版本
• KaiOS：2.2130.10 或更高版本
• WhatsApp Web：2.2132.6 或更高版本

1. 1

   请收件人更新 WhatsApp

   Android：Google Play Store → My Apps → WhatsApp → Update。iOS：App Store → 搜索 WhatsApp → Update。

2. 2

   更新后重试

   大多数因应用版本导致的投递失败，在更新后会立即解决。请从 SparkTG Dashboard → Campaign Logs 重试。

原因 5：Meta 的每用户营销消息频率上限

为避免用户被企业消息淹没，Meta 限制同一用户在一定时间窗口内可从所有企业接收的营销模板消息数量。这是针对每个用户、覆盖整个平台的上限：即使你的企业此前从未给该联系人发过消息，它同样适用。

• 无法绕过该上限：这是 Meta 平台的限制。
• 受影响的联系人在上限重置后即可再次触达，通常为 24 小时。
• 立即重试没有帮助：请等到重置后再试。
• 实用类（utility）和验证类（authentication）模板类别不受此频率上限限制。将符合条件的消息重新归类为实用类模板，可以提升送达率。

常见问题

• 此错误是 SparkTG 造成的吗？不是。SparkTG 已将消息正确传递给 Meta API。无法送达的状态由 WhatsApp 投递层根据收件人的账户状态或 Meta 自身的政策返回。
• 未送达的消息会被收费吗？WhatsApp 按对话会话计费，而不是按单条消息。如果没有开启任何会话，则不产生对话费用。请查看 SparkTG Dashboard → Billing → Usage，了解按联系人划分的明细。
• 可以自动重试失败的消息吗？可以。前往 SparkTG Dashboard → Campaign Settings → Retry Policy，设置在指定间隔后自动重试失败联系人。
• 如何查看哪些联系人失败以及原因？SparkTG Dashboard → Campaigns → 选择你的营销活动 → Delivery Report。每个失败联系人都会显示 Meta 返回的具体错误码和原因。

如何降低未来营销活动的无法送达率

• 仅向主动 opt-in 接收你企业 WhatsApp 消息的联系人发送消息：这是 Meta 政策的要求，也是影响送达率的最重要因素。
• 每次营销活动之前，使用 SparkTG 内置的号码验证工具验证你的联系人列表。
• 避免在短时间内向同一受众高频发送营销模板：这会加快触及每用户营销上限。
• 在适用时始终使用实用类或验证类模板类别：它们不受营销频率上限限制。
• 定期在 SparkTG → WhatsApp → Channel Status 中监控模板的质量评级。评级下滑是无法送达率正在上升的早期信号。