# Meta错误代码

## 节流错误

| 代码                                                    | 详情                                                     | 可能的原因和解决方案                                                                                                                                                                                                                                                      | HTTP 状态代码 |
| ----------------------------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| <p><code>4</code></p><p>API 调用过多</p>                  | 此应用已达到 API 调用流量限制。                                     | 在[应用面板](https://developers.facebook.com/apps)中加载此应用，然后查看**应用流量限制**部分，确认此应用是否已达到其[流量限制](https://developers.facebook.com/docs/graph-api/overview/rate-limiting#wa-biz-api)。如果已达到，请稍后再试，或减少此应用进行 API 查询的频次或数量。                                                     | `400`错误请求 |
| <p><code>80007</code></p><p>流量限制问题</p>                | WhatsApp Business 商业账户已达到其流量限制。                        | 请参阅 WhatsApp Business 商业账户[流量限制](https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#rate-limits)。稍后重试；或减少此应用进行 API 查询的频次或数量。                                                                                          | `400`错误请求 |
| <p><code>130429</code></p><p>达到流量限制</p>               | 已达到云端 API 消息吞吐量。                                       | 此应用已达到 API 吞吐量限制。请参阅[吞吐量](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput)。稍后重试；或减少此应用发送消息的频次。                                                                                                                             | `400`错误请求 |
| <p><code>131048</code></p><p>达到垃圾信息流量限制</p>           | 此电话号码被限制了可发送的消息数量，因此消息发送失败。这可能是因为之前有太多消息被封锁，或被标记为垃圾信息。 | 请在 WhatsApp 管理工具中检查您的质量状态。请参阅[模板限制](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview#template-limits)和[模板质量](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality)。 | `400`错误请求 |
| <p><code>131056</code></p><p>达到（业务账户、消费者账户）配对流量限制</p> | 短时间内从发信人电话号码发送到同一收信人电话号码的消息过多。                         | 如需发送消息到同一电话号码，等待并重试操作。您仍可发送消息到其他电话号码，而无需等待                                                                                                                                                                                                                      | `400`错误请求 |
| <p><code>133016</code></p><p>超出账户注册注销数量限制</p>         | 由于短时间内尝试次数太多，未能成功注册或注销此电话号码                            | 此业务电话号码因达到注册/注销的尝试次数上限而遭到封锁。号码解除封锁后，请再试一次。请查看[注册](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)文档的“限制”部分。                                                                                      | `400`错误请求 |

## 其他错误

<table data-header-hidden><thead><tr><th></th><th width="192.45703125"></th><th width="353.25390625"></th><th></th></tr></thead><tbody><tr><td>代码</td><td>详情</td><td>可能的原因和解决方案</td><td>HTTP 状态代码</td></tr><tr><td><p><code>130472</code></p><p>用户的号码涉及实验</p></td><td>消息并非作为<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/support/experiments">实验</a>的一部分发送。</td><td>请参阅<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/support/experiments#marketing-message-experiment">营销消息实验</a>。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131000</code></p><p>出错了</p></td><td>出现未知错误，因此消息发送失败。</td><td>再试一次。如果错误持续存在，则创建<a href="https://business.facebook.com/direct-support">直接支持</a>工单。对于使用端点的 WhatsApp Flows - 在<a href="https://developers.facebook.com/docs/whatsapp/cloud-api/reference/whatsapp-business-encryption#set-business-public-key">设置企业公钥</a>时，无法计算签名或调用 GraphQL 端点，或者 GraphQL 端点返回错误。</td><td><code>500</code>内部服务器错误</td></tr><tr><td><p><code>131005</code></p><p>访问遭拒</p></td><td>未获得权限或权限已被移除。</td><td>使用<a href="https://developers.facebook.com/tools/debug/accesstoken">访问口令调试工具</a>来确认您的应用是否已获得端点所需的权限。请参阅<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/support#authentication-authorization">身份验证和授权错误</a>。</td><td><code>403</code>禁止访问</td></tr><tr><td><p><code>131008</code></p><p>必要参数缺失</p></td><td>请求中缺少必要参数。</td><td>请参阅端点参考文档，确定哪些是必要参数。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131009</code></p><p>参数值无效</p></td><td>一个或多个参数值无效。</td><td>参阅此端点的参考文档，确定每个参数支持哪些值；参阅<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers">电话号码</a>，了解如何将电话号码添加到 WhatsApp Business 商业账户。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131016</code></p><p>服务不可用</p></td><td>服务暂时不可用。</td><td>访问 <a href="https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api%3Ffbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExbE9VS2JWNHdDYmhoeGEyTHNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR7EwI3ZeWkET0sv1d6qOrSD0EpoQ_Q1Mk2PQW7RwhWbCn75U-eiQJ_KDp0ngQ_aem_4xCDGSMuoqb1wpbLeXHEtA&#x26;h=AT1-HiPjeXGiLt1BiGu1049D_WZ7upc-8sNO1mNYIEEZACB3rt71Yz171vvn4L_RFbrd3KCzjpPyD04aw8m3d2RL5XpZJ5FokjpSwGDAoZ3z0nupqTZS6e4zgm-Xa1D5jKbRobWTbfM">WhatsApp Business 开放平台状态</a>页面，查看 API 状态信息，然后重试。</td><td><code>500</code>内部服务器错误</td></tr><tr><td><p><code>131021</code></p><p>收信人不能是发信人</p></td><td>发信人和收信人的电话号码相同。</td><td>将消息发送到与发信人不同的电话号码。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131026</code></p><p>消息无法送达</p></td><td><p>无法送达消息。原因可包括：</p><ul><li>收信人电话号码不是 WhatsApp 电话号码。</li><li>收信人尚未接受我们的新服务条款和隐私政策。</li><li><p>收信人使用的是旧版 WhatsApp；必须使用以下 WhatsApp 版本或更高版本：</p><ul><li>Android：2.21.15.15</li><li>SMBA：2.21.15.15</li><li>iOS：2.21.170.4</li><li>SMBI：2.21.170.4</li><li>KaiOS：2.2130.10</li><li>网页版：2.2132.6</li></ul></li></ul></td><td><p>使用非 WhatsApp 联系方式，请 WhatsApp 用户执行以下操作：</p><ul><li>确认他们实际可以向您的 WhatsApp Business 业务电话号码发送消息。</li><li>确认他们已接受我们的最新服务条款（如果他们还未接受，在<strong>设置</strong> > <strong>帮助</strong>中，或在<strong>设置</strong> > <strong>应用程序信息</strong>中，系统会提示他们接受最新条款/政策）</li><li>更新到最新版 WhatsApp 客户端。</li></ul></td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131037</code></p><p>WhatsApp 提供的电话号码需要显示名获得批准，才能发送消息。</p></td><td>用来发送请求的 <a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview#555-business-phone-numbers">555 业务电话号码</a>没有获得批准的<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/docs/whatsapp/display-names">显示名</a>。</td><td>更改 555 业务电话号码的<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/display-names">显示名</a>。另请参阅我们帮助中心的<a href="https://www.facebook.com/business/help/378834799515077">如何更改 WhatsApp Business 商家显示名</a>一文。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131042</code></p><p>商家支付资格问题</p></td><td>您的支付方式出错了。</td><td><p>参阅 <a href="https://www.facebook.com/business/help/2225184664363779">WhatsApp Business 商业账户的账单简介</a>，确认您是否已正确设置账单。常见问题：</p><ul><li>WhatsApp Business 商业账户未绑定支付账户</li><li>额度超出上限</li><li>未设置或启用额度（支付账户）</li><li>WhatsApp Business 商业账户已被删除</li><li>WhatsApp Business 商业账户已停用</li><li>未设置时区</li><li>未设置货币</li><li>MessagingFor 请求（代操作）待处理或已被拒</li></ul></td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131045</code></p><p>证书不正确</p></td><td>由于电话号码注册错误，消息发送失败。</td><td><a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration">注册电话号码</a>，然后重试。</td><td><code>500</code>内部服务器错误</td></tr><tr><td><p><code>131047</code></p><p>再互动消息</p></td><td>距收信人上次回复发信人号码，时间已超过 24 小时。</td><td>请改为向收信人发送<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview">模板消息</a>。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131049</code></p><p>Meta 选择了不送达。</p></td><td>为保持健康的生态系统互动，这条消息未被送达。</td><td>如果您收到此错误代码，并且怀疑是由于该限制所致，请至少等待 24 小时再重新发送模板消息。由于此限制可能在不同时期生效，立即执行此操作只会导致出现另一个错误响应。详情请参阅<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits">每位用户的营销模板消息限制</a>。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131050</code></p><p>用户已停止接收营销消息。</p></td><td>消息无法送达。收信人已选择停止接收商家通过 WhatsApp 发送的营销消息。</td><td>请勿再次尝试向此用户发送消息，因为对方不会收到。如要在 WhatsApp 用户每次停止或恢复接收您向其发送的营销模板消息时收到通知，请订阅 <a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/user_preferences">user_preferences webhook</a>。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131051</code></p><p>消息类型不受支持</p></td><td>消息类型不受支持。</td><td>参阅<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages#message-types">消息</a>，了解受支持的消息类型，然后使用受支持的消息类型重试。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131052</code></p><p>下载影音内容出错</p></td><td>无法下载用户发送的影音内容。</td><td>我们无法下载此 WhatsApp 用户所发消息中包含的影音内容。有关详情，参见此消息被接收时触发的任何<strong>消息</strong> Webhook 中的 <code>error.error_data.details</code> 值。让 WhatsApp 用户使用非 WhatsApp 方式向您发送影音文件。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131053</code></p><p>上传影音内容出错</p></td><td>无法上传消息中使用的影音内容。</td><td>由于一个或多个原因（例如不支持的影音内容类型），我们无法上传影音内容。有关详情，参见消息发送失败时触发的任何<strong>消息</strong> Webhook 中的 <code>error.error_data.details</code> 值。建议您检查造成错误的任何影音文件，并确认这些文件实际上受支持。例如，在 UNIX 中，您可以通过命令行使用文件检查，来确定文件的 MIME 类型：<code>file -I rejected-file.mov</code>然后您可以确认其 MIME 类型是否受支持。参阅<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types">受支持的影音内容类型</a>。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>131057</code></p><p>账户处于维护模式</p></td><td>业务账户处于维护模式</td><td>WhatsApp Business 商业账户目前处于维护模式。其中一个原因可能是账户正在进行<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput">吞吐量</a>升级。</td><td><code>500</code>错误请求</td></tr><tr><td><p><code>132000</code></p><p>模板参数数量不一致</p></td><td>请求中包含的可变参数值数量与模板中定义的可变参数数量不一致。</td><td>请参阅我们的<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview#parameter-formats">模板</a>文档，了解相关参数，并确保请求包含模板需要的所有参数值。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>132001</code></p><p>模板不存在</p></td><td>该模板在特定语言中不存在，或尚未通过审核。</td><td>确保您的模板已通过审核，并且模板的名称和语言设置准确无误。请参阅我们的<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview">模板</a>文档，详细了解模板。</td><td><code>404</code>未找到</td></tr><tr><td><p><code>132005</code></p><p>模板填充文字过长</p></td><td>翻译文字过长。</td><td>查看 WhatsApp 管理工具，确认模板已翻译。请参阅我们的<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality">模板质量</a>文档，了解如何检查模板状态。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>132007</code></p><p>违反模板格式字符政策</p></td><td>模板内容违反了 WhatsApp 政策。</td><td>请参阅我们的<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review">模板审核</a>文档，了解违规的可能原因。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>132012</code></p><p>模板参数格式不一致</p></td><td>可变参数值格式不正确。</td><td>请求中包含的可变参数值未使用模板中指定的格式。请参阅我们的<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview#parameter-formats">模板</a>文档，详细了解模板参数和格式。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>132015</code></p><p>模板已暂停</p></td><td>模板因<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality">低质量</a>而被暂停使用，因此您无法在模板消息中发送此模板。</td><td><a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-management#edit-templates">编辑模板</a>以提高其质量，并在模板通过审核后重试。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>132016</code></p><p>模板已禁用</p></td><td>模板已多次因<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality">低质量</a>而被暂停使用，现已永久禁用。</td><td>使用不同内容新建模板。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>132068</code></p><p>Flows 已被阻止</p></td><td>Flows 处于被阻止状态。</td><td>纠正 Flows</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>132069</code></p><p>Flows 已被节流</p></td><td>Flows 处于节流状态，过去一小时内已发送 10 条使用此 Flows 的消息。</td><td>纠正 Flows</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>133000</code></p><p>注销未完成</p></td><td>之前的注销尝试失败。</td><td>重新<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration#deregister-phone">注销</a>号码后再<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration">注册</a>。</td><td><code>500</code>内部服务器错误</td></tr><tr><td><p><code>133004</code></p><p>服务器暂时不可用</p></td><td>服务器暂时不可用。</td><td>访问 <a href="https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api%3Ffbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExbE9VS2JWNHdDYmhoeGEyTHNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR5fR8pg0B-IicB7-ftrE6-418relABYe1kdgQ5a2bXacuVyTSfzGxYw2C4Z6w_aem_QF3mdEnurygRKixWZdHStg&#x26;h=AT1-HiPjeXGiLt1BiGu1049D_WZ7upc-8sNO1mNYIEEZACB3rt71Yz171vvn4L_RFbrd3KCzjpPyD04aw8m3d2RL5XpZJ5FokjpSwGDAoZ3z0nupqTZS6e4zgm-Xa1D5jKbRobWTbfM">WhatsApp Business 开放平台状态</a>页面，查看 API 状态信息，检查响应中的 <code>details</code> 值，然后重试。</td><td><code>503</code>服务不可用</td></tr><tr><td><p><code>133005</code></p><p>两步验证 PIN 码不一致</p></td><td>两步验证 PIN 码不正确。</td><td>确认请求中包含的两步验证 PIN 码正确。要重置 PIN 码，请禁用两步验证，然后设置新的 PIN 码。请参阅<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#two-step-verification">两步验证</a>。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>133006</code></p><p>需要重新验证电话号码</p></td><td>需要先验证电话号码，才能注册。</td><td><a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/registering-phone-numbers">验证并注册电话号码</a>。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>133008</code></p><p>两步验证 PIN 码尝试次数过多</p></td><td>此电话号码的两步验证 PIN 码尝试次数过多。</td><td>在 <code>details</code> 响应值指定的时间后重试。</td><td><code>400</code>错误请求</td></tr><tr><td><p><code>133009</code></p><p>两步验证 PIN 码尝试过快</p></td><td>两步验证 PIN 码输入过快。</td><td>检查 <code>details</code> 响应值，然后重试。</td><td><code>400</code>无效请求</td></tr><tr><td><p><code>133010</code></p><p>电话号码未注册</p></td><td>电话号码未在 WhatsApp Business 开放平台上注册。</td><td><a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration">注册电话号码</a>，然后重试。</td><td><code>400</code>无效请求</td></tr><tr><td><p><code>133015</code></p><p>请等待几分钟，再尝试注册此电话号码</p></td><td>您当前尝试注册的电话号码近期被删除，但删除尚未完成。</td><td>请等待 5 分钟，再重新尝试发送请求。</td><td><code>400</code>无效请求</td></tr><tr><td><p><code>134011</code></p><p>尚未接受 WhatsApp 支付服务条款</p></td><td>消息发送失败，因为正在等待此 WhatsApp Business 商业账户接受 WhatsApp 支付服务条款。</td><td>使用错误消息中提供的链接接受 WhatsApp 支付服务条款，然后重试。</td><td><code>400</code>无效请求</td></tr><tr><td><p><code>135000</code></p><p>一般用户错误</p></td><td>您的请求参数出现未知错误，因此消息发送失败。</td><td>参阅此端点的<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/overview">参考文档</a>，确认您查询端点所使用的语法是否正确。如果您在响应中继续收到此错误代码，请联系<a href="https://developers.facebook.com/support/">客户支持</a>。</td><td></td></tr></tbody></table>

## WhatsApp 营销消息 API 错误代码

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

<table data-header-hidden><thead><tr><th></th><th></th><th width="161.1015625"></th><th width="220.62890625"></th><th></th></tr></thead><tbody><tr><td>代码</td><td>消息</td><td>详情</td><td>可能的原因和解决方案</td><td>HTTP<br>状态<br>码</td></tr><tr><td><code>100</code></td><td><code>(#100) Invalid parameter</code></td><td><code>Message must be a template message.</code></td><td>您正在尝试发送非模板消息。消息类型必须为 <code>template</code>。请使用营销模板重试。</td><td>400 无效请求</td></tr><tr><td><code>131009</code></td><td><code>(#131009) Parameter value is not valid</code></td><td><code>One or more parameter values are invalid.</code></td><td>您使用的参数可能无效。请确认您使用的是<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/send-marketing-messages">有效参数</a>，然后重试。广告同步可能未完成。请等待 10 分钟，然后重试。如果问题仍然存在，请联系支持。</td><td>400 无效请求</td></tr><tr><td><code>131055</code></td><td><code>(#131055) Method not allowed</code></td><td><code>Only marketing template messages are supported</code></td><td>您可能试图发送非模板消息，或者身份验证或实用型模板。请尝试使用营销模板消息再次发送。</td><td>400 无效请求</td></tr><tr><td><code>134100</code></td><td><code>(#134100) Only marketing messages supported</code></td><td><code>You're only able to send marketing messages on this API.</code></td><td><em>将在图谱 API 23.0 版本中推出。</em>您正在尝试发送实用型或身份验证模板。仅支持 <code>MARKETING</code> 类模板。</td><td>400 无效请求</td></tr><tr><td><code>134101</code></td><td><code>(#134101) Your template is still syncing</code></td><td><code>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.</code></td><td><em>将在图谱 API 23.0 版本中推出。</em>您正在尝试发送尚未完成广告同步的新建模板。广告同步最多可能需要 10 分钟。请等待 10 分钟，然后重试。</td><td>400 无效请求</td></tr><tr><td><code>134102</code></td><td><code>(#134102) Template unavailable for use</code></td><td><code>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.</code></td><td><em>将在图谱 API 23.0 版本中推出。</em>我们无法为您尝试发送的模板完成广告同步，或者您可能不符合使用 WhatsApp 营销消息 API 的资格。<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/onboarding#check-waba-onboarding-status-and-eligibility">检查您的资格状态</a>。如果 WhatsApp Business 商业账户的 <code>marketing_messages_lite_api_status</code>值为 <code>ONBOARDED</code> 且问题仍然存在，请<a href="https://business.facebook.com/direct-support/">联系支持</a>。</td><td>500 内部服务器错误</td></tr><tr><td><code>1752041</code></td><td><code>(#1752041) Duplicate Request</code></td><td><code>Duplicate Request is thrown when a client has already been invited to onboard by any partner.</code></td><td>接入请求限每个业务客户 1 个，仅第一个调用意向 API 的合作伙伴能够成功提交请求。接入客户后，其所有符合条件的 WhatsApp Business 商业账户 (WABA) 都会自动包含在该流程中。如果您收到错误消息，表明已提出过加入请求，则无需采取进一步操作，因为该客户的所有符合条件的 WABA 都将加入，无需执行额外步骤。</td><td>400 无效请求</td></tr></tbody></table>