WhatsApp 模板消息错误:完整指南
当 WhatsApp 模板消息发送失败时,Meta 会返回一个数字错误代码,准确告诉你消息被拒绝或未送达的原因。本指南列出最常见的模板错误代码,解释成因,并为每个错误提供分步修复指南的链接。
模板消息为什么会失败
模板消息通过 WhatsApp Business API 传输,因此失败可能发生在多个环节:
- 你的账户: Meta 账单未付、缺少付款方式,或你的 WhatsApp Business Account 存在消息限制。
- 你的模板: 模板仍在等待审批,或模板的名称与语言和实际发送的内容不匹配。
- 收件人: 号码未注册 WhatsApp、用户屏蔽了你,或 Meta 的保护机制限制了单个用户可接收的营销消息数量。
错误代码会告诉你具体是哪种情况,所以在做任何更改之前,请先在消息日志或自动化失败列表中找到确切的错误代码。
常见错误代码与修复方法
下面每篇文章完整讲解一个错误代码:含义、快速检查、解决方案,以及何时升级处理。
- 错误 130472:用户号码属于实验对象(Experiment):WhatsApp 正在进行一项实验,限制向该收件人发送消息。
- 错误 131026:消息无法送达(Message Undeliverable):WhatsApp 无法向收件人送达消息(未注册 WhatsApp、应用版本过旧、被屏蔽或未接受条款)。
- 错误 131042:商家资格付款问题(Business Eligibility Payment Issue):Meta 账单问题,通常是账单未付或未设置默认付款方式。
- 错误 131048:触发垃圾消息频率限制(Spam Rate Limit Hit):你的账户在滚动 24 小时窗口内达到了商家主动发起对话的上限。
- 错误 131049:Meta 选择不投递(Healthy Ecosystem):Meta 的健康生态保护机制限制了发送给该收件人的营销消息数量。
- 错误 132001:模板名称不存在(Template Name Does Not Exist):模板仍在等待审批,或名称、语言与已批准的翻译不匹配。
💡
针对特定收件人的错误(130472、131026、131049)通常意味着其他联系人仍能正常收到消息。账户级别的错误(131042、131048)会阻止所有人的发送,请优先修复这类错误。