LetsBot 菜单
立即开始 简体中文 语言

Meta 商业合作伙伴 英国注册公司

语言

免费参考资料

WhatsApp Business API 错误码 详解与解决方案

消息发送失败或连接号码时看到一串数字?在这里搜索,即可了解究竟发生了什么、是需要您处理还是重试即可成功,以及具体的解决步骤。

已对照 Meta 官方文档核对,核对日期: 2026-08-24 85 个错误码 · 85 个详解页面 官方来源
营销活动报表 Cloud API
  • Sara 已送达
  • Karl 失败 13104724 小时回复窗口已关闭
  • Maya 已读

授权错误

6
0 需要处理

WhatsApp 不再接受您的连接

WhatsApp 无法确认您的账号仍处于授权状态,因此该操作未执行。通常是访问令牌已过期或失效,或者账号上更改了某项设置,阻止了应用访问其...

完整说明与解决方法 →
3 需要处理

您的 WhatsApp 连接缺少必要权限

该操作因功能或权限问题被拒绝:您的 WhatsApp 连接要么不具备此操作所需的功能,要么未获得所需的权限。

完整说明与解决方法 →
10 需要处理

权限从未授予或后来被撤销

该操作被阻止,因为它所依赖的某项权限从未授予,或之后被撤销。当您的账号不符合所要使用功能的资格要求时,也可能出现此错误。

完整说明与解决方法 →
190 需要处理

WhatsApp 访问令牌已过期

用于授权您 WhatsApp 连接的访问令牌已过期,因此 WhatsApp 拒绝了该操作。需要重新签发访问令牌。

完整说明与解决方法 →
200 需要处理

未向 WhatsApp 发送访问令牌

WhatsApp 拒绝了该操作,因为请求中根本没有附带访问令牌,并返回了 “Provide valid app ID”。这不是令牌过期:问题在于什么都没有发送,而...

完整说明与解决方法 →
200-299 需要处理

缺少必要权限或权限已被撤销

200–299 范围内的错误代码表示您的 WhatsApp 连接所需的某项权限从未授予或已被撤销。在该权限恢复之前,操作会在此中止。Meta 将单独的代...

完整说明与解决方法 →

账号限制错误

3

模板创建错误

7
2388039 暂时性

模板状态目前无法更改

您对此消息模板的修改被拒绝,因为该模板的状态目前无法更改——例如模板仍在审核中。在这种状态下,您只能新增模板或删除现有模板。

完整说明与解决方法 →
2388040 需要处理

模板字段超出字符数上限

您的消息模板中有一个字段超出了允许的最大字符数,因此模板未被接受。随附的错误消息会指明具体字段及其适用的字符数上限。

完整说明与解决方法 →
2388047 需要处理

模板页眉格式无效

您的消息模板页眉中包含 WhatsApp 不接受的格式,因此模板被拒。此错误仅针对页眉,与正文或页脚无关。

完整说明与解决方法 →
2388072 需要处理

模板正文格式无效

您的消息模板正文(即主要文字内容)包含 WhatsApp 不接受的格式,因此模板被拒。此错误仅针对正文,与页眉或页脚无关。

完整说明与解决方法 →
2388073 需要处理

模板页脚格式无效

您的消息模板页脚中包含 WhatsApp 不接受的格式,因此模板被拒。此错误仅针对页脚,与页眉或正文无关。

完整说明与解决方法 →
2388293 需要处理

相对模板长度而言变量过多

您的模板被拒,因为相对于其简短的文字而言,所含变量过多。WhatsApp 会权衡变量数量与消息长度的比例,而此模板超出了允许的比例。

完整说明与解决方法 →
2388299 需要处理

变量位于模板开头或结尾

您的模板被拒,因为有变量位于文字的最开头或最末尾。WhatsApp 不允许模板以变量开头或结尾。

完整说明与解决方法 →

模板发送错误

1

号码迁移错误

5

模板数据分析错误

3

WhatsApp Business 账号错误

2

同步错误

2

速率与发送限额错误

7
4 暂时性

发送已暂停——应用达到速率上限

您的消息未能发送,因为将您的账号连接到 WhatsApp 的应用达到了 Meta 设定的单位时间请求次数上限。该限制针对的是请求频率,而非消息内容...

完整说明与解决方法 →
80007 暂时性

您的 WhatsApp Business 账号达到速率上限

您的消息未能发送,因为您的 WhatsApp Business 账号达到了速率上限。短时间内发出的请求过多,WhatsApp 暂时停止接受更多请求。稍后重试通...

完整说明与解决方法 →
130429 暂时性

消息发送速度超出 Cloud API 的承受上限

您的消息未能送达,因为消息发出的速度超过了 Cloud API 同一时间能接受的速度——发送已达到其允许的最高速率。放慢发送速度或稍后重试即可...

完整说明与解决方法 →
131048 需要处理

此号码的发送功能受到限制

您的消息未能发送,因为此号码可发送的消息数量受到限制。Meta 表示,这可能是因为此前发送的消息中有过多被屏蔽或被标记为垃圾消息。

完整说明与解决方法 →
131056 暂时性

发给同一收件人的消息过多

您的消息未能送达,因为您的号码在短时间内向同一收件人发送了过多消息。目前已暂停向该号码发送;您的其他收件人不受影响。

完整说明与解决方法 →
131064 需要处理

因模板分类违规导致发送受限

由于模板分类违规,您的账号已达到消息发送上限。这会同时阻止向客户发送模板消息和直接消息。处罚期结束后,限制会自动解除。

完整说明与解决方法 →
133016 暂时性

此号码的连接尝试次数过多

由于在短时间内尝试次数过多,连接或断开您的企业号码失败。该号码现已被禁止继续尝试注册,直到封锁解除为止。

完整说明与解决方法 →

发送与连接错误

43
1 暂时性

无效请求或 WhatsApp 服务器错误

WhatsApp 报告了无效请求或可能的服务器错误,因此消息未发送。Meta 的状态页面会显示是否存在服务中断;如果没有中断,就需要检查请求本身...

完整说明与解决方法 →
2 暂时性

WhatsApp 服务中断或负载过高

由于当时 WhatsApp 服务暂时中断或负载过高,消息未能发送。Meta 将此情况描述为暂时性的。

完整说明与解决方法 →
33 需要处理

用于发送的企业号码已被删除

由于用于发送的企业电话号码已被删除,消息未能发送。

完整说明与解决方法 →
100 需要处理

WhatsApp 拒绝了消息中的某个值

请求中包含一个或多个 WhatsApp 不支持或拼写错误的字段,因此消息未发送。

完整说明与解决方法 →
130403 需要处理

未送达——您已屏蔽此收件人

此收件人在您自己的屏蔽名单中,因此消息未送达。在屏蔽解除之前,您发送的任何内容都无法送达对方。

完整说明与解决方法 →
130472 暂时性

因实验原因消息未发送

作为一项实验的一部分,WhatsApp 未发送这条消息。Meta 对此代码的说明中没有提供关于该实验或这条消息的更多信息。

完整说明与解决方法 →
131000 暂时性

未知错误导致消息未发出

发送时出现意外的 WhatsApp 错误,消息未能发出。WhatsApp 没有给出具体的失败原因。

完整说明与解决方法 →
131005 需要处理

权限未授予或已被撤销

此操作所需的权限从未授予或已被撤销,因此操作未能完成。Meta 给出的解决方法是检查已连接应用所获得的权限,而不是您自己账号中的设置。

完整说明与解决方法 →
131008 需要处理

消息缺少必填字段

消息缺少必填字段,因此 WhatsApp 拒绝发送。在所有必填字段都填写完整之前,消息无法发出。

完整说明与解决方法 →
131009 需要处理

消息字段中有无效值

消息中有一个或多个值无效,因此 WhatsApp 不予发送。Meta 针对此代码的指引还介绍了如何将电话号码添加到 WhatsApp Business 账号。

完整说明与解决方法 →
131016 暂时性

某项 WhatsApp 服务暂时不可用

由于某项 WhatsApp 服务暂时不可用,消息未能发送。

完整说明与解决方法 →
131021 需要处理

发送方与收件方号码相同

消息无法发送到发送方自己的号码。所用的收件人号码与您的企业号码相同,而 WhatsApp 不允许这样做。

完整说明与解决方法 →
131026 需要处理

消息无法送达此号码

无法送达——该号码未使用 WhatsApp,或无法接收这条消息。可能的原因包括:该号码不是 WhatsApp 号码、号码所有者尚未接受新的服务条款和隐...

完整说明与解决方法 →
131037 需要处理

您的企业号码没有已获批准的显示名称

由于用于发送的企业电话号码没有已获批准的显示名称,消息未能发送。在显示名称获批之前,WhatsApp 不会使用该号码发送消息。

完整说明与解决方法 →
131042 需要处理

付款方式问题导致无法发送

您的付款方式出现错误,发送因此停止。在 WhatsApp Business 账号的账单设置正确之前,发送将一直被阻止。

完整说明与解决方法 →
131045 需要处理

电话号码注册错误

由于电话号码注册错误,消息发送失败。Meta 给出的解决方法是先注册电话号码再重试。

完整说明与解决方法 →
131047 需要处理

24 小时回复窗口已关闭

距离收件人上次回复您的号码已超过 24 小时,因此普通消息未被接受。需要改用模板消息联系对方。

完整说明与解决方法 →
131049 暂时性

为维持健康的互动生态,消息未送达

为维持健康的生态互动,WhatsApp 未送达这条消息。Meta 的指引表明,原因可能是其针对单个收件人的营销模板消息限额,该限额的生效时长不一...

完整说明与解决方法 →
131050 永久性

收件人已退订您的营销消息

该收件人已选择不再通过 WhatsApp 接收您企业的营销消息,因此消息未送达。Meta 的指引是不要重试,因为发给对方的消息不会被接收。

完整说明与解决方法 →
131051 需要处理

不支持的消息类型

消息类型不受支持,因此 WhatsApp 不予发送。所用类型不在 WhatsApp 接受的消息类型之列。

完整说明与解决方法 →
131052 永久性

无法下载客户发送的媒体文件

客户通过 WhatsApp 发送了图片或文件,但该媒体文件无法下载,因此您无法获取该文件。

完整说明与解决方法 →
131053 需要处理

消息中的媒体文件无法上传

消息中使用的媒体文件无法上传,因此消息未发送。Meta 指出,可能的原因之一是媒体类型不受支持。

完整说明与解决方法 →
131057 暂时性

WhatsApp Business 账号处于维护模式

由于您的 WhatsApp Business 账号处于维护模式,消息未能发送。Meta 指出了一个可能的原因:该账号正在进行吞吐量升级。

完整说明与解决方法 →
131063 需要处理

Cloud API 上的营销模板已被停用

您尝试发送的模板归类为“营销”,而您的账号目前在 Cloud API 上已关闭营销模板。该设置是在 WhatsApp Business 账号本身关闭的,因此 Whats...

完整说明与解决方法 →
132000 需要处理

模板变量数量与模板不符

您发送的模板变量数量与已获批准的模板不符。模板定义的每个变量都必须且只能接收一个值,而此次发送的数量不同,因此 WhatsApp 拒绝了它,...

完整说明与解决方法 →
132001 需要处理

该语言下没有此模板或模板未获批准

该模板不存在于您发送时所用的语言版本中,或者尚未获得批准。WhatsApp 只发送名称和语言完全匹配且已通过审核的模板。

完整说明与解决方法 →
132005 需要处理

模板译文过长

由于该模板的译文过长,消息未能发送。WhatsApp 不接受译文超出允许长度的模板。

完整说明与解决方法 →
132007 需要处理

模板内容违反了 WhatsApp 政策

该模板违反了 WhatsApp 的内容政策,因此 WhatsApp 不会发送它。模板会根据 WhatsApp 关于企业可发送内容的规则进行审核,而此模板的内容被...

完整说明与解决方法 →
132012 需要处理

模板变量格式不正确

模板变量的格式与模板要求不符。您发送的值不符合已获批准的模板为其定义的格式,因此 WhatsApp 拒绝了这条消息。

完整说明与解决方法 →
132015 需要处理

模板因质量过低被暂停

该模板已被暂停,目前无法使用。WhatsApp 因其质量下降过多而将其暂停,在暂停期间,基于该模板的任何消息都不会发出。

完整说明与解决方法 →
132016 永久性

模板多次被暂停后已被永久停用

该模板已被停用。它曾因质量过低被暂停太多次,因此 WhatsApp 现已将其永久停用,无法再次使用。

完整说明与解决方法 →
132068 需要处理

消息未发送——Flow 已被封锁

由于消息附带的 Flow 处于封锁状态,消息未能发送。只要该 Flow 仍处于封锁状态,WhatsApp 就不会发送使用它的消息。

完整说明与解决方法 →
132069 需要处理

Flow 已限流——本小时已发送 10 条消息

此消息附带的 Flow 处于限流状态,且过去一小时内已有 10 条使用该 Flow 的消息发出,因此这条消息未被发送。

完整说明与解决方法 →
133000 需要处理

此前注销失败导致无法注册

由于此前注销该号码的尝试失败,号码无法注册。在号码被彻底注销之前,无法再次注册。

完整说明与解决方法 →
133004 暂时性

WhatsApp 服务器暂时不可用

由于当时 WhatsApp 服务器暂时不可用,请求未能完成。这是 WhatsApp 方的问题,与您的账号或消息无关。

完整说明与解决方法 →
133005 需要处理

两步验证 PIN 码不正确

提交的两步验证 PIN 码不正确,因此请求被拒绝。此号码已开启两步验证,只有输入正确的 PIN 码,请求才能通过。

完整说明与解决方法 →
133006 需要处理

电话号码必须先验证才能注册

由于该号码尚未验证,注册未能完成。WhatsApp 要求电话号码先通过验证才能注册,因此注册被拒绝。

完整说明与解决方法 →
133008 暂时性

两步验证 PIN 码尝试次数过多

此号码的两步验证 PIN 码输错次数过多,因此 WhatsApp 会在一段时间内拒绝继续尝试。错误详情中会说明您需要等待多久。

完整说明与解决方法 →
133009 暂时性

两步验证 PIN 码输入过快

两步验证 PIN 码输入过快,因此 WhatsApp 未予接受。错误详情中会说明重试前需要检查的内容。

完整说明与解决方法 →
133010 需要处理

号码未在 WhatsApp Business Platform 上注册

此电话号码未在 WhatsApp Business Platform 上注册,因此发送未能完成。号码必须先注册,才能用于发送消息。

完整说明与解决方法 →
133015 暂时性

号码刚被删除——删除尚未完成

您尝试注册的号码最近已被删除,且删除流程尚未完成。在删除完成之前,该号码无法再次注册。

完整说明与解决方法 →
134011 需要处理

尚未接受 WhatsApp Payments 条款

由于此 WhatsApp Business 账号尚未完成 WhatsApp Payments 服务条款的接受流程,消息发送失败。错误消息中附有接受这些条款的链接。

完整说明与解决方法 →
135000 暂时性

消息因未说明的原因被拒

由于所发送内容的细节存在未知问题,WhatsApp 拒绝了这条消息,而 Meta 并未说明是哪一项细节导致的。

完整说明与解决方法 →

Marketing Messages API 错误

6
131055 需要处理

此渠道仅可发送营销模板

您的消息未能送达,因为该发送渠道仅支持营销模板消息。您发送的可能根本不是模板消息,也可能是类别为“身份验证”或“实用工具”而非“营销”的...

完整说明与解决方法 →
132018 需要处理

模板参数值被拒,消息未发送

WhatsApp 在发送前检查了模板,发现填入的参数值有问题。由于按您填写的内容,该模板设置不正确,消息未被发送。

完整说明与解决方法 →
134100 需要处理

此处不接受实用工具或身份验证模板

您尝试发送的模板类别为“实用工具”或“身份验证”。此渠道只能发送“营销”类模板,因此您的消息被拒绝。

完整说明与解决方法 →
134101 暂时性

模板仍在同步中,请稍后重试

您使用的模板是最近创建的,同步尚未完成。同步最多可能需要 10 分钟,在完成之前,基于该模板的消息无法发出。

完整说明与解决方法 →
134102 需要处理

模板不可用:请检查您的资格

您尝试发送的模板目前无法使用。可能是该模板与您的广告同步未能完成,也可能是您的企业暂不具备发送此类营销消息的资格。

完整说明与解决方法 →
1752041 永久性

已提交入驻申请,无需其他操作

该企业的入驻申请已经提交。每个企业客户只能提交一次入驻申请,且只有第一个提交的合作伙伴会成功。

完整说明与解决方法 →

常见问题解答

WhatsApp 错误码是什么意思?
它是 Meta 的 WhatsApp Cloud API 返回的一个数字,用于说明消息为何未发送或操作为何失败。每个错误码都有特定含义和不同的解决方法;请在本页列表中选择您的错误码,查看对应的说明和操作步骤。
在 LetsBot 中哪里可以找到错误码?
错误码显示在营销活动报表或会话记录中未送达消息的旁边,并附有发送失败原因的简短说明。
每个错误都意味着我的账户出了问题吗?
不是。有些错误码是暂时性的,无需任何操作,重试即可成功;有些与收件人有关,而不是您的账户;还有些需要您采取行动,例如更新付款方式或修正模板。每个错误码的页面都会说明属于哪种情况。
这份列表完整且最新吗?
列表涵盖了 Meta 官方 WhatsApp Cloud API 文档中公布的错误码,页面顶部显示最近一次核对的日期。Meta 会不断新增错误码,因此我们会定期审核这份列表。

错误码未列出,或解决方法无效?

把错误码和截图发给我们,我们会和您一起解读。如果您通过 LetsBot 发送消息,错误码会显示在消息旁边,并附有失败原因。