错误和状态消息

本文档提供关于下列错误和状态消息类型的更多信息：

WhatsApp Business API 客户端错误代码
HTTP 状态代码

为解决有关嵌入式注册的疑难问题，请参阅嵌入式注册流程错误。

WhatsApp Business API 客户端错误代码

错误代码	描述
`400`：媒体下载错误	无法下载来自发送者的媒体。
`402`：商家资格 — 支付问题	您的支付方式出现了一个或多个错误，因此消息发送失败。 WhatsApp 账户未绑定支付账户信用额度超出上限未设置或启用信用额度（支付账户） WhatsApp Business 商业帐号已删除账户已遭我方停用未设置时区未设置货币以代理 (OBO) 身份发出的 MessagingFor 请求处于等待中或已驳回在无有效支付方式的情况下超出免费对话次数限制。（此错误类型于 2022 年 2 月 1 日生效）。检查您在 WhatsApp 管理工具中的支付设置，然后重试。
`408`：消息无效	等待时间过长（超过 1 天），因此消息发送失败。如果 WhatsApp Business API 客户端关闭超过一天然后重新启动，便会出现此情况。重新发送消息。
`410`：消息已过期	消息未能在其生存时间 (TTL) 范围内发送。
`429`：达到流量上限	对于传出消息：此电话号码在短时间内发送的消息过多，因此消息发送失败。重新发送失败的消息。对于传入消息：由于流量限制，无法成功下载媒体。要求发送者重新发送消息。
`430`：未签名的证书	您的证书出现错误，因此消息发送失败。从 WhatsApp 管理工具下载新的证书并重新注册。
`432`：证书编号不一致	您的证书出现错误，因此消息发送失败。从 WhatsApp 管理工具下载新的证书并重新注册。
`433`：证书签名无效	如果消息已发送，但公司客户端的证书未使用客户端身份密钥正确签署，便会出现此错误。这可能表示客户端已使用新的身份验证密钥重新注册，但未经过完整的证书创建流程。
`470`：重新互动消息	距离客户上一次回复此号码已超过 24 小时，因此消息发送失败。使用消息模板回复。
`471`：达到垃圾消息流量上限	此电话号码被限制了可发送的消息数量，因此消息发送失败。这可能是因为之前有太多消息被封锁，或被标记为垃圾信息。请在 WhatsApp 管理工具中检查您的质量状态。详情请参阅基于质量的流量限制文档。
`472`：用户的号码作实验用途	此用户的电话号码是作实验用途，因此消息发送失败。跳过此用户，不再向其发送消息。
`480`：用户可能发生更改	使用此电话号码的用户可能发生更改，因此消息发送失败。
`500`：一般性错误	出现未知错误，因此消息发送失败。请稍后再试。
`501`：目前不支持此消息类型。	目前不支持带说明的文档消息。
`1000`：一般性错误
`1001`：消息过长	消息长度超过 4096 个字符。
`1002`：收信人类型无效	有效收信人类型包括： `individual`
`1004`：资源已经存在	媒体文件上传请求可能存在 UUID 冲突，或包含该 UUID 的媒体文件已经存在。
`1005`：访问遭拒	您正在尝试将一个公司电话号码注册为用于 On-Premises API，而此操作不再受支持。请参阅 On-Premises API 弃用。媒体目录不可写入（上传请求），或凭证无效，或证书错误，或应用已过期：需要升级版本，或此帐户的 `button` 消息遭到禁用，或号码已在 WhatsApp 上注册（请参阅迁移电话号码，了解如何将电话号码从 WhatsApp 转移至 WhatsApp Business API）；或如果您的商家是在印度发送商务消息，请确保您已填写所有必填商业简介和商品字段。详情请参阅 https://www.facebook.com/business/help/1104628230079278。
`1006`：未找到资源	未找到文件或资源
`1007`：收信人受到封锁，无法接收消息（已停用）	收信人未在白名单上
`1008`：必要参数缺失	缺失必要的参数。如果您在尝试发送清单消息，则表示您有可能缺失了 `section` 对象的 `title` 部分或 `rows` 的 `ID`。如果您在尝试发送单件商品消息或多件商品消息，则表示您有可能缺失了 `catalog_id` 或 `product_retailer_id`。对于该类型的消息，这些字段均为必要项。
`1009`：参数值无效	输入的参数值类型错误，或存在其他问题。如果您在尝试发送清单消息，请检查每一行的编号是否唯一。如果您在尝试发送单件商品消息，则表示您有可能发送了错误的 `catalog_id`。请返回“电商管理工具”，然后再检查一遍。如果您在尝试发送多件商品消息，请确认每个部分的 `product_retailer_id` 是否唯一。另请确保 `header` 和 `body` 对象均存在且已获配相应值。
`1010`：不需要某个参数	包含不需要的参数。
`1011`：服务未就绪
`1013`：用户无效
`1014`：内部错误	因图像有误（未能正确上传图像）或未找到端点而上传失败您提供的哈希值与用户的最新哈希值不匹配
`1015`：请求过多	客户端已达到流量限制
`1016`：系统过载	如果系统负载过重，则会返回此错误，以让系统从负载中恢复。
`1017`：非主 Master	当您将仅适用于 Master 的请求（如配置设置、获取设置、导入、导出、代码请求和注册等）发送给不是主 Master 的节点时，就会出现此错误。如果 WhatsApp Business API 客户端设置不当或存在内部错误，则可能发生此类情况。重新尝试请求应该可以解决此错误。如果这一操作无法解决此错误，请联系客户服务。
`1018`：非主要核心应用	如果您向其发送请求的核心应用节点不是分片所有者，或正在成为分片所有者，则会出现此错误。当我们在多连接设置中进行分片故障转移时，您可能会看到此错误。大多数情况下，重新尝试请求应该可以解决此错误。如果无法解决，请联系客户支持。
`1021`：用户有误	如果您向自己发送消息，就会出现此错误。要解决此问题，请向不属于您的号码发送消息。
`1022`：未配置 Webhooks 网址	如果您尚未配置 REST API Webhooks 的格式，就会出现此错误。
`1023`：发生数据库错误
`1024`：需要更改密码	您需要更改密码。
`1025`：无效请求	请求无效。
`1026`：接收者无法接收	消息无法送达。查看“我的送达率为什么不是 100%？”常见问题。
`1028`：`user_identity_changed` 系统通知需要确认	您向可能已发生变更的 WhatsApp 用户发送了一条消息，系统已向您发送 `user_identity_changed` 系统通知，正在等待您确认。
`1031`：发送者帐户已被锁定	您的账户因违反诚信政策而遭到锁定，无法发送任何消息。详情请参阅 WhatsApp Business 开放平台政策执行。
`2000`：模板参数数量不一致	所提供的参数数量与预期的参数数量不一致。
`2001`：缺少模板	模板状态未启用，或没有某语言和本地语言的模板。
`2002`：模板获取失败	接收者无法下载模板。
`2003`：缺少模板包	没有特定语言和本地语言的模板。
`2004`：模板参数长度过长	参数长度过长
`2005`：模板中的已填充文字过长	翻译文字过长
`2006`：违反模板空格政策	违反空格政策
`2007`：违反模板格式字符政策	违反格式字符政策
`2008`：不支持模板的媒体格式	不支持所用的媒体格式
`2009`：缺少模板所需组件	缺少模板中的所需组件
`2010`：模板中的已填充网址无效	按钮组件的网址无效
`2011`：模板电话号码无效	按钮组件的电话号码无效
`2012`：模板参数格式不一致	参数格式与已创建模板的格式不一致
`2013`：不支持模板按钮	接收者不支持按钮
`2014`：预期的命名空间为空	当未下载模板消息语言包时，就会发生此错误。
`2015`：版块数量无效	消息请求包含的版块数量低于最小值或高于最大值。请参阅 `section` 对象了解详情。您至少要有 1 个 `section` 对象（最多可拥有 10 个）。
`2016`：行数无效	行数无效。清单消息的每个 `section` 至少须有一个 `rows` 对象。
`2017`：违反字符政策	已违反格式字符政策。
`2023`：商品数量无效	section 对象没有商品，或商品总数超出允许的数量上限。
`2024`：找不到目录编号	您提供的目录编号不存在或不属于您的 WhatsApp Business 商业帐号 (WABA)。
`2025`：目录编号未关联 API 编号	您提供的目录编号尚未与用于发送消息的电话号码绑定。
`2026`：缺少商品	目录中找不到您的请求中提供的某些商品。
`2027`：找不到任何商品	您提供的目录中找不到任何商品。
`2028`：列出的所有商品不合规	仅适用于印度的商家。如果商家发送单件商品消息时缺少及未完整提供电商合规信息，系统会返回此错误。
`2029`：列出的部分商品不合规	仅适用于印度的商家。如果商家发送多件商品消息时缺少及未完整提供电商合规信息，系统会返回此错误。
`2030`：列出的混合商品无效且商品不合规	仅适用于印度的商家。如果商家发送多件商品消息时混有无效商品和缺少合规信息的商品，系统会返回此错误。
`2036`：无效标头结构	当 `header` 对象结构无效时，系统会返回此错误。
`2050`：缺少合规信息	仅适用于印度的商家。当商家未提供任何合规信息时，系统会返回此错误。请参阅商家合规性端点。
`2060`：模板被拒	模板状态为 `REJECTED`，因此您无法发送该模板。
`2061`：模板已暂停	模板状态为 `PAUSED`，因此您无法发送该模板。
`2062`：模板已禁用	模板状态为 `DISABLED`，因此您无法发送该模板。
`2064`：流程编号无效	带有指定编号的流程不存在、不属于您的 WhatsApp Business 商业帐号 (WABA) 或处于无效状态。
`2065` - 无效的流程消息版本	流程消息版本无效。前往流程更新日志查看目前支持的消息版本
`2066` - 无效的流程模式	当发送处于指定草稿模式的 `DRAFT` 状态的流程或发送处于 `PUBLISHED` 状态但以草稿模式发送的流程时返回。
`2067` - 不支持使用草稿模式的流程	无法发送 `DRAFT` 流程，请查阅状态页面，了解是否存在长期问题，如果问题一直存在，请联系支援团队。
`2068`：流程被封锁	流程处于屏蔽状态。如果流程使用端点，且所需设置不完整（例如公钥未上传或无效），系统也可能会返回此错误。请参阅为流程实现端点。
`2069`：流程被节流	流程处于节流状态，过去一小时内已发送了使用此流程的 10 条消息。
`2070` - 无效的流程版本	流程版本无效或过期。前往流程更新日志

如需了解特定于印度商家的电商管理工具错误代码，请参阅这篇 Business 帮助中心文章。

HTTP 状态代码

以下是 WhatsApp Business API 客户端可能会用到的 HTTP 状态代码。

HTTP 代码	描述
`2xx`	成功
`200`	成功 (OK)
`201`	已成功创建（适用于 POST 请求）
`302`	已找到
`4xx`	客户端错误
`400`	请求无效
`401`	未授权
`403`	禁止访问
`404`	未找到
`405`	不得使用此方法。
`412`	先决条件失效
`420`	消息受流量限制
`429`	请求过多
`5xx`	服务器错误
`500`	内部服务器错误
`504`	超时

WhatsApp Business 开放平台 | 云端 API | 本地 API | Business 管理 API