Meta错误代码
节流错误
代码
详情
可能的原因和解决方案
HTTP 状态代码
4
API 调用过多
此应用已达到 API 调用流量限制。
400错误请求
80007
流量限制问题
WhatsApp Business 商业账户已达到其流量限制。
请参阅 WhatsApp Business 商业账户流量限制。稍后重试;或减少此应用进行 API 查询的频次或数量。
400错误请求
131048
达到垃圾信息流量限制
此电话号码被限制了可发送的消息数量,因此消息发送失败。这可能是因为之前有太多消息被封锁,或被标记为垃圾信息。
400错误请求
131056
达到(业务账户、消费者账户)配对流量限制
短时间内从发信人电话号码发送到同一收信人电话号码的消息过多。
如需发送消息到同一电话号码,等待并重试操作。您仍可发送消息到其他电话号码,而无需等待
400错误请求
133016
超出账户注册注销数量限制
由于短时间内尝试次数太多,未能成功注册或注销此电话号码
此业务电话号码因达到注册/注销的尝试次数上限而遭到封锁。号码解除封锁后,请再试一次。请查看注册文档的“限制”部分。
400错误请求
其他错误
代码
详情
可能的原因和解决方案
HTTP 状态代码
131000
出错了
出现未知错误,因此消息发送失败。
500内部服务器错误
131008
必要参数缺失
请求中缺少必要参数。
请参阅端点参考文档,确定哪些是必要参数。
400错误请求
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 业务电话号码没有获得批准的显示名。
更改 555 业务电话号码的显示名。另请参阅我们帮助中心的如何更改 WhatsApp Business 商家显示名一文。
400错误请求
131042
商家支付资格问题
您的支付方式出错了。
参阅 WhatsApp Business 商业账户的账单简介,确认您是否已正确设置账单。常见问题:
WhatsApp Business 商业账户未绑定支付账户
额度超出上限
未设置或启用额度(支付账户)
WhatsApp Business 商业账户已被删除
WhatsApp Business 商业账户已停用
未设置时区
未设置货币
MessagingFor 请求(代操作)待处理或已被拒
400错误请求
131049
Meta 选择了不送达。
为保持健康的生态系统互动,这条消息未被送达。
如果您收到此错误代码,并且怀疑是由于该限制所致,请至少等待 24 小时再重新发送模板消息。由于此限制可能在不同时期生效,立即执行此操作只会导致出现另一个错误响应。详情请参阅每位用户的营销模板消息限制。
400错误请求
131050
用户已停止接收营销消息。
消息无法送达。收信人已选择停止接收商家通过 WhatsApp 发送的营销消息。
请勿再次尝试向此用户发送消息,因为对方不会收到。如要在 WhatsApp 用户每次停止或恢复接收您向其发送的营销模板消息时收到通知,请订阅 user_preferences webhook。
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 类型是否受支持。参阅受支持的影音内容类型。
400错误请求
132068
Flows 已被阻止
Flows 处于被阻止状态。
纠正 Flows
400错误请求
132069
Flows 已被节流
Flows 处于节流状态,过去一小时内已发送 10 条使用此 Flows 的消息。
纠正 Flows
400错误请求
133005
两步验证 PIN 码不一致
两步验证 PIN 码不正确。
确认请求中包含的两步验证 PIN 码正确。要重置 PIN 码,请禁用两步验证,然后设置新的 PIN 码。请参阅两步验证。
400错误请求
133008
两步验证 PIN 码尝试次数过多
此电话号码的两步验证 PIN 码尝试次数过多。
在 details 响应值指定的时间后重试。
400错误请求
133009
两步验证 PIN 码尝试过快
两步验证 PIN 码输入过快。
检查 details 响应值,然后重试。
400无效请求
133015
请等待几分钟,再尝试注册此电话号码
您当前尝试注册的电话号码近期被删除,但删除尚未完成。
请等待 5 分钟,再重新尝试发送请求。
400无效请求
134011
尚未接受 WhatsApp 支付服务条款
消息发送失败,因为正在等待此 WhatsApp Business 商业账户接受 WhatsApp 支付服务条款。
使用错误消息中提供的链接接受 WhatsApp 支付服务条款,然后重试。
400无效请求
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.
您使用的参数可能无效。请确认您使用的是有效参数,然后重试。广告同步可能未完成。请等待 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.
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 无效请求
最后更新于