Meta错误代码

节流错误

代码

详情

可能的原因和解决方案

HTTP 状态代码

4

API 调用过多

此应用已达到 API 调用流量限制。

应用面板arrow-up-right中加载此应用,然后查看应用流量限制部分,确认此应用是否已达到其流量限制arrow-up-right。如果已达到,请稍后再试,或减少此应用进行 API 查询的频次或数量。

400错误请求

80007

流量限制问题

WhatsApp Business 商业账户已达到其流量限制。

请参阅 WhatsApp Business 商业账户流量限制arrow-up-right。稍后重试;或减少此应用进行 API 查询的频次或数量。

400错误请求

130429

达到流量限制

已达到云端 API 消息吞吐量。

此应用已达到 API 吞吐量限制。请参阅吞吐量arrow-up-right。稍后重试;或减少此应用发送消息的频次。

400错误请求

131048

达到垃圾信息流量限制

此电话号码被限制了可发送的消息数量,因此消息发送失败。这可能是因为之前有太多消息被封锁,或被标记为垃圾信息。

请在 WhatsApp 管理工具中检查您的质量状态。请参阅模板限制arrow-up-right模板质量arrow-up-right

400错误请求

131056

达到(业务账户、消费者账户)配对流量限制

短时间内从发信人电话号码发送到同一收信人电话号码的消息过多。

如需发送消息到同一电话号码,等待并重试操作。您仍可发送消息到其他电话号码,而无需等待

400错误请求

133016

超出账户注册注销数量限制

由于短时间内尝试次数太多,未能成功注册或注销此电话号码

此业务电话号码因达到注册/注销的尝试次数上限而遭到封锁。号码解除封锁后,请再试一次。请查看注册arrow-up-right文档的“限制”部分。

400错误请求

其他错误

代码

详情

可能的原因和解决方案

HTTP 状态代码

130472

用户的号码涉及实验

消息并非作为实验arrow-up-right的一部分发送。

400错误请求

131000

出错了

出现未知错误,因此消息发送失败。

再试一次。如果错误持续存在,则创建直接支持arrow-up-right工单。对于使用端点的 WhatsApp Flows - 在设置企业公钥arrow-up-right时,无法计算签名或调用 GraphQL 端点,或者 GraphQL 端点返回错误。

500内部服务器错误

131005

访问遭拒

未获得权限或权限已被移除。

使用访问口令调试工具arrow-up-right来确认您的应用是否已获得端点所需的权限。请参阅身份验证和授权错误arrow-up-right

403禁止访问

131008

必要参数缺失

请求中缺少必要参数。

请参阅端点参考文档,确定哪些是必要参数。

400错误请求

131009

参数值无效

一个或多个参数值无效。

参阅此端点的参考文档,确定每个参数支持哪些值;参阅电话号码arrow-up-right,了解如何将电话号码添加到 WhatsApp Business 商业账户。

400错误请求

131016

服务不可用

服务暂时不可用。

访问 WhatsApp Business 开放平台状态arrow-up-right页面,查看 API 状态信息,然后重试。

500内部服务器错误

131021

收信人不能是发信人

发信人和收信人的电话号码相同。

将消息发送到与发信人不同的电话号码。

400错误请求

131026

消息无法送达

无法送达消息。原因可包括:

  • 收信人电话号码不是 WhatsApp 电话号码。

  • 收信人尚未接受我们的新服务条款和隐私政策。

  • 收信人使用的是旧版 WhatsApp;必须使用以下 WhatsApp 版本或更高版本:

    • Android:2.21.15.15

    • SMBA:2.21.15.15

    • iOS:2.21.170.4

    • SMBI:2.21.170.4

    • KaiOS:2.2130.10

    • 网页版:2.2132.6

使用非 WhatsApp 联系方式,请 WhatsApp 用户执行以下操作:

  • 确认他们实际可以向您的 WhatsApp Business 业务电话号码发送消息。

  • 确认他们已接受我们的最新服务条款(如果他们还未接受,在设置 > 帮助中,或在设置 > 应用程序信息中,系统会提示他们接受最新条款/政策)

  • 更新到最新版 WhatsApp 客户端。

400错误请求

131037

WhatsApp 提供的电话号码需要显示名获得批准,才能发送消息。

用来发送请求的 555 业务电话号码arrow-up-right没有获得批准的显示名arrow-up-right

更改 555 业务电话号码的显示名arrow-up-right。另请参阅我们帮助中心的如何更改 WhatsApp Business 商家显示名arrow-up-right一文。

400错误请求

131042

商家支付资格问题

您的支付方式出错了。

参阅 WhatsApp Business 商业账户的账单简介arrow-up-right,确认您是否已正确设置账单。常见问题:

  • WhatsApp Business 商业账户未绑定支付账户

  • 额度超出上限

  • 未设置或启用额度(支付账户)

  • WhatsApp Business 商业账户已被删除

  • WhatsApp Business 商业账户已停用

  • 未设置时区

  • 未设置货币

  • MessagingFor 请求(代操作)待处理或已被拒

400错误请求

131045

证书不正确

由于电话号码注册错误,消息发送失败。

500内部服务器错误

131047

再互动消息

距收信人上次回复发信人号码,时间已超过 24 小时。

请改为向收信人发送模板消息arrow-up-right

400错误请求

131049

Meta 选择了不送达。

为保持健康的生态系统互动,这条消息未被送达。

如果您收到此错误代码,并且怀疑是由于该限制所致,请至少等待 24 小时再重新发送模板消息。由于此限制可能在不同时期生效,立即执行此操作只会导致出现另一个错误响应。详情请参阅每位用户的营销模板消息限制arrow-up-right

400错误请求

131050

用户已停止接收营销消息。

消息无法送达。收信人已选择停止接收商家通过 WhatsApp 发送的营销消息。

请勿再次尝试向此用户发送消息,因为对方不会收到。如要在 WhatsApp 用户每次停止或恢复接收您向其发送的营销模板消息时收到通知,请订阅 user_preferences webhookarrow-up-right

400错误请求

131051

消息类型不受支持

消息类型不受支持。

参阅消息arrow-up-right,了解受支持的消息类型,然后使用受支持的消息类型重试。

400错误请求

131052

下载影音内容出错

无法下载用户发送的影音内容。

我们无法下载此 WhatsApp 用户所发消息中包含的影音内容。有关详情,参见此消息被接收时触发的任何消息 Webhook 中的 error.error_data.details 值。让 WhatsApp 用户使用非 WhatsApp 方式向您发送影音文件。

400错误请求

131053

上传影音内容出错

无法上传消息中使用的影音内容。

由于一个或多个原因(例如不支持的影音内容类型),我们无法上传影音内容。有关详情,参见消息发送失败时触发的任何消息 Webhook 中的 error.error_data.details 值。建议您检查造成错误的任何影音文件,并确认这些文件实际上受支持。例如,在 UNIX 中,您可以通过命令行使用文件检查,来确定文件的 MIME 类型:file -I rejected-file.mov然后您可以确认其 MIME 类型是否受支持。参阅受支持的影音内容类型arrow-up-right

400错误请求

131057

账户处于维护模式

业务账户处于维护模式

WhatsApp Business 商业账户目前处于维护模式。其中一个原因可能是账户正在进行吞吐量arrow-up-right升级。

500错误请求

132000

模板参数数量不一致

请求中包含的可变参数值数量与模板中定义的可变参数数量不一致。

请参阅我们的模板arrow-up-right文档,了解相关参数,并确保请求包含模板需要的所有参数值。

400错误请求

132001

模板不存在

该模板在特定语言中不存在,或尚未通过审核。

确保您的模板已通过审核,并且模板的名称和语言设置准确无误。请参阅我们的模板arrow-up-right文档,详细了解模板。

404未找到

132005

模板填充文字过长

翻译文字过长。

查看 WhatsApp 管理工具,确认模板已翻译。请参阅我们的模板质量arrow-up-right文档,了解如何检查模板状态。

400错误请求

132007

违反模板格式字符政策

模板内容违反了 WhatsApp 政策。

请参阅我们的模板审核arrow-up-right文档,了解违规的可能原因。

400错误请求

132012

模板参数格式不一致

可变参数值格式不正确。

请求中包含的可变参数值未使用模板中指定的格式。请参阅我们的模板arrow-up-right文档,详细了解模板参数和格式。

400错误请求

132015

模板已暂停

模板因低质量arrow-up-right而被暂停使用,因此您无法在模板消息中发送此模板。

编辑模板arrow-up-right以提高其质量,并在模板通过审核后重试。

400错误请求

132016

模板已禁用

模板已多次因低质量arrow-up-right而被暂停使用,现已永久禁用。

使用不同内容新建模板。

400错误请求

132068

Flows 已被阻止

Flows 处于被阻止状态。

纠正 Flows

400错误请求

132069

Flows 已被节流

Flows 处于节流状态,过去一小时内已发送 10 条使用此 Flows 的消息。

纠正 Flows

400错误请求

133000

注销未完成

之前的注销尝试失败。

500内部服务器错误

133004

服务器暂时不可用

服务器暂时不可用。

访问 WhatsApp Business 开放平台状态arrow-up-right页面,查看 API 状态信息,检查响应中的 details 值,然后重试。

503服务不可用

133005

两步验证 PIN 码不一致

两步验证 PIN 码不正确。

确认请求中包含的两步验证 PIN 码正确。要重置 PIN 码,请禁用两步验证,然后设置新的 PIN 码。请参阅两步验证arrow-up-right

400错误请求

133006

需要重新验证电话号码

需要先验证电话号码,才能注册。

400错误请求

133008

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

此电话号码的两步验证 PIN 码尝试次数过多。

details 响应值指定的时间后重试。

400错误请求

133009

两步验证 PIN 码尝试过快

两步验证 PIN 码输入过快。

检查 details 响应值,然后重试。

400无效请求

133010

电话号码未注册

电话号码未在 WhatsApp Business 开放平台上注册。

400无效请求

133015

请等待几分钟,再尝试注册此电话号码

您当前尝试注册的电话号码近期被删除,但删除尚未完成。

请等待 5 分钟,再重新尝试发送请求。

400无效请求

134011

尚未接受 WhatsApp 支付服务条款

消息发送失败,因为正在等待此 WhatsApp Business 商业账户接受 WhatsApp 支付服务条款。

使用错误消息中提供的链接接受 WhatsApp 支付服务条款,然后重试。

400无效请求

135000

一般用户错误

您的请求参数出现未知错误,因此消息发送失败。

参阅此端点的参考文档arrow-up-right,确认您查询端点所使用的语法是否正确。如果您在响应中继续收到此错误代码,请联系客户支持arrow-up-right

WhatsApp 营销消息 API 错误代码

WhatsApp 营销消息 API 使用与云端 API 相同的错误代码,并添加了下方列出的一些错误代码。

代码

消息

详情

可能的原因和解决方案

HTTP 状态 码

100

(#100) Invalid parameter

Message must be a template message.

您正在尝试发送非模板消息。消息类型必须为 template。请使用营销模板重试。

400 无效请求

131009

(#131009) Parameter value is not valid

One or more parameter values are invalid.

您使用的参数可能无效。请确认您使用的是有效参数arrow-up-right,然后重试。广告同步可能未完成。请等待 10 分钟,然后重试。如果问题仍然存在,请联系支持。

400 无效请求

131055

(#131055) Method not allowed

Only marketing template messages are supported

您可能试图发送非模板消息,或者身份验证或实用型模板。请尝试使用营销模板消息再次发送。

400 无效请求

134100

(#134100) Only marketing messages supported

You're only able to send marketing messages on this API.

将在图谱 API 23.0 版本中推出。您正在尝试发送实用型或身份验证模板。仅支持 MARKETING 类模板。

400 无效请求

134101

(#134101) Your template is still syncing

When you send a message from a template, the template syncing process can take up to 10 minutes to complete. Wait a few minutes, and then try sending your message again.

将在图谱 API 23.0 版本中推出。您正在尝试发送尚未完成广告同步的新建模板。广告同步最多可能需要 10 分钟。请等待 10 分钟,然后重试。

400 无效请求

134102

(#134102) Template unavailable for use

Please check your eligibility status to ensure you are onboarded (/documentation/business-messaging/whatsapp/marketing-messages/onboarding#ensure-you-are-eligible-to-onboard) or contact Meta's customer support.

将在图谱 API 23.0 版本中推出。我们无法为您尝试发送的模板完成广告同步,或者您可能不符合使用 WhatsApp 营销消息 API 的资格。检查您的资格状态arrow-up-right。如果 WhatsApp Business 商业账户的 marketing_messages_lite_api_status值为 ONBOARDED 且问题仍然存在,请联系支持arrow-up-right

500 内部服务器错误

1752041

(#1752041) Duplicate Request

Duplicate Request is thrown when a client has already been invited to onboard by any partner.

接入请求限每个业务客户 1 个,仅第一个调用意向 API 的合作伙伴能够成功提交请求。接入客户后,其所有符合条件的 WhatsApp Business 商业账户 (WABA) 都会自动包含在该流程中。如果您收到错误消息,表明已提出过加入请求,则无需采取进一步操作,因为该客户的所有符合条件的 WABA 都将加入,无需执行额外步骤。

400 无效请求

最后更新于