WhatsApp 错误代码说明 - EngageLab | WhatsApp REST API 简体中文

本页汇总 WhatsApp 消息在发送与送达过程中可能出现的错误码，说明每个错误码的含义与处理方式。

错误码分为两类来源，请先确认属于哪一类，再对照下方对应章节：

来源	编号规则
Meta 官方错误码	与 Meta 官方完全一致
EngageLab 平台错误码	由 EngageLab 定义

适用范围：本页仅覆盖消息发送与送达场景。接口调用层面的错误码请查阅消息发送 API 与模板管理 API 文档中的「错误码」章节。

Meta 官方错误码

以下错误码均由 Meta 定义，编号与 Meta 官方保持一致，可参考 Meta 官方文档。

限流与频率限制

此类错误表示触发了发送速率或发送量的限制，消息本身没有问题，等待后重试即可恢复。

代码	含义	说明	处理建议
4	API 调用超限	应用的 API 调用频率已达上限。	降低调用频率或稍后重试。
80007	账号发送频率超限	WhatsApp 商业账号（WABA）的发送频率已达上限。	放慢发送节奏、稍后再发；批量群发建议分批匀速下发。
130429	发送吞吐量超限	已达到单位时间内可发送的消息量上限。	降低瞬时并发发送量后重试。业务需要更高吞吐可联系 EngageLab 技术支持评估升级。
131048	垃圾消息限流	该发送号近期较多消息被用户屏蔽或标记为垃圾消息，已触发发送限制。	在 WhatsApp Manager 查看号码质量评级，优化内容与目标人群精准度后再发送。
131056	对同一用户发送过频	短时间内向同一收件人发送了过多消息。	拉长对同一用户的发送间隔；向其他收件人发送不受影响。
131064	模板分类违规导致发送受限	因模板分类（营销 / 实用通知 / 身份验证）使用不当，账号已达发送上限，模板消息与普通消息均受影响。	核对模板分类与实际用途是否一致。约束期结束后限制自动解除。

账户与权限

此类错误与账号状态、接入配置或合规处罚有关，重试无法解决。

代码	含义	说明	处理建议
0	身份验证失败	接入 Meta 的访问令牌已失效。	属平台接入侧问题，请联系 EngageLab 技术支持处理。
3	功能或权限不足	缺少调用该接口所需的能力或权限。	请联系 EngageLab 技术支持开通对应权限。
10	权限被拒	权限未授予或已被移除。	请联系 EngageLab 技术支持核查权限。
190	访问令牌已过期	接入 Meta 的访问令牌已过有效期。	属平台接入侧问题，请联系 EngageLab 技术支持更新。
200	未提供访问令牌	请求中未携带有效的访问令牌。	属平台接入配置问题，请联系 EngageLab 技术支持。
368	账号因违规被限制	WhatsApp 商业账号因违反平台政策被限制或停用。	核查近期发送内容与模板是否合规；可在 Meta 商务管理平台查看处罚详情并申诉，限制期满后自动解除。
130497	地区发送受限	商业账号被限制向特定国家/地区的用户发送消息。	确认目标号码所属国家/地区是否在允许范围内，详见 WhatsApp 商业消息政策。
131005	访问被拒	调用该接口所需的权限未授予或已被移除。	请联系 EngageLab 技术支持核查权限。
131031	账号被锁定	商业账号因违反平台政策被限制或停用。	请联系 EngageLab 技术支持核查账号状态；亦可在 Meta 商务管理平台查看账号健康状态。
131042	支付 / 账单问题	支付方式或信用额度异常，如未绑定支付账户、信用额度超限或未启用、未设置时区与货币。	在 Meta 商务管理平台检查支付账户、信用额度、时区与货币设置是否完整。
131057	账号处于维护模式	商业账号正在进行维护或升级。	稍后重试。
131063	营销模板在 Cloud API 上被禁用	模板分类为营销类，但账号已在 Cloud API 配置中关闭营销模板发送。	重新启用账号的营销消息开关，或改用实用通知类 / 身份验证类模板。
134011	未接受支付服务条款	商业账号尚未接受 WhatsApp Payments 服务条款。	通过错误信息中的链接接受条款后重试。

发送与收件人

此类错误与本次发送的请求内容、收件人状态或会话窗口有关。

代码	含义	说明	处理建议
1	请求无效或服务器错误	请求格式有误，或 Meta 侧出现服务器错误。	对照接口文档检查请求格式；格式无误时稍后重试。
2	服务临时中断	Meta 服务因宕机或过载出现临时问题。	稍后重试。
100	参数无效	请求中包含不受支持、拼写错误或超出长度限制的参数。	对照接口文档检查参数名拼写、取值与长度限制。
130403	商家已屏蔽该用户	你的商业号在 WhatsApp 上屏蔽了该收件人。	请勿重试。先在 WhatsApp Manager 解除对该用户的屏蔽，再重新发送。
130472	消息因营销实验未发送	该收件人被纳入 Meta 的营销消息实验对照组，按实验规则未发送。	无需处理，不代表消息或账号存在问题。
131000	未知发送错误	消息因未知原因发送失败。	稍后重试；持续失败请联系 EngageLab 技术支持。
131008	缺少必要参数	请求中缺少必填参数。	对照接口文档补齐必填参数后重发。
131009	参数值无效	一个或多个参数的取值无效。	对照接口文档检查各参数的取值范围与格式。
131016	服务暂不可用	Meta 侧某项服务暂时不可用。	稍后重试。
131021	收件人与发送号相同	收件人号码与发送号码是同一个号码。	更换为其他收件人号码后重发。
131026	对方无法接收消息	收件人不是 WhatsApp 用户、未接受最新服务条款，或客户端版本过旧。	确认号码已注册 WhatsApp；可通过其他渠道请对方接受最新条款并升级 WhatsApp。
131037	发送号显示名未获批	发送号没有已审批通过的显示名称。	先完成显示名称审批，通过后再发送。
131045	发送号注册异常	消息因发送号码的注册问题而失败。	确认发送号已完成注册；如有异常请重新注册号码。
131047	超出 24 小时客服窗口	距收件人最后一次回复已超过 24 小时，无法再发送自由格式消息。	改用已审核通过的模板消息触达；用户回复后会重新开启 24 小时窗口。
131049	营销消息频率受限	已达到该用户在一定周期内可接收的营销模板消息上限。	至少等待 24 小时后再重发，并控制营销消息的发送频次与内容相关性。
131050	用户已退订营销消息	收件人已选择不再接收你的营销消息。	请勿重试。将该用户移出营销名单，仅发送必要的实用通知类消息。
131051	消息类型不受支持	使用了不支持的消息类型。	对照消息发送 API 文档改用受支持的消息类型。
131052	媒体下载失败	无法下载用户发送的影音内容。	请用户通过其他方式重新提供文件。
131053	媒体上传失败	消息中的媒体文件上传失败。	检查媒体文件的格式与大小是否符合要求后重试。

模板与 Flow

此类错误与模板本身的状态、内容或参数填充有关。

代码	含义	说明	处理建议
132000	模板参数数量不符	传入的变量数量与模板定义的变量数量不一致。	按模板实际的变量个数补齐或删减参数后重发。
132001	模板不存在或未审核通过	模板在指定语言下不存在，或尚未通过审核。	确认模板名称与语言代码拼写完全一致（区分大小写与下划线），且模板状态为「已通过」。
132005	模板译文过长	模板在该语言下的译文超出长度限制。	缩短对应语言的模板文案。
132007	模板内容违规	模板内容违反 WhatsApp 政策。	参照模板审核规范修改内容后重新提交审核。
132012	模板参数格式错误	变量值的格式与模板定义的格式不一致。	按模板定义的参数格式重新填充变量。
132015	模板因质量过低被暂停	模板因质量评分过低被暂停，暂时无法发送。	编辑模板提升质量，待重新审核通过后使用；期间可改用其他已通过的模板。
132016	模板被永久禁用	模板多次因质量过低被暂停，已被永久禁用。	该模板无法恢复，请用不同内容新建模板。
132018	模板参数校验失败	模板中的参数未通过校验。	根据错误信息修正参数配置后重新发送。
132068	Flow 被封锁	所使用的 Flow 处于被封锁状态。	检查并修正 Flow 配置，或改用其他方式触达用户。
132069	Flow 被限流	该 Flow 1 小时内已发送 10 条消息，触发限流。	等待限流窗口结束后再发送。

号码注册与验证

代码	含义	说明	处理建议
133000	注销未完成	之前的注销尝试未成功，导致无法重新注册。	重新执行注销操作，完成后再进行注册。
133004	服务器暂不可用	Meta 服务器暂时不可用。	稍后重试。
133005	两步验证 PIN 码错误	请求中的两步验证 PIN 码不正确。	确认 PIN 码；如已遗忘，可先关闭两步验证再设置新的 PIN 码。
133006	号码需重新验证	号码需先完成验证才能注册。	先完成号码验证，再执行注册。
133008	PIN 码尝试次数过多	PIN 码输入错误次数过多，已被临时锁定。	等待锁定解除后再试。
133009	PIN 码输入过快	PIN 码提交过于频繁。	稍后再试。
133010	号码未注册	该号码尚未在 WhatsApp 商业平台完成注册。	先完成号码注册后再发送。
135000	请求参数未知错误	请求参数存在未知错误。	对照接口文档检查请求语法与参数；持续出现请联系 EngageLab 技术支持。

发送号状态

代码	含义	说明	处理建议
33	发送号已被删除	用于发送的商业号码已被删除。	核对发送号是否正确；如已删除，请改用其他有效发送号或重新注册。
133015	发送号删除未完成	该号码近期被删除，删除流程尚未完成。	等待约 5 分钟后重试。
133016	号码注册次数过多	短时间内对该号码的注册/注销尝试次数过多，号码被临时封锁。	等待封锁解除后再试，期间请勿反复尝试。

EngageLab 平台错误码

代码	含义	说明	处理建议
1	收件人号码无效	收件人号码格式不合法，未通过校验。	检查号码是否为纯数字、带国家码、不含 `+`、空格或连字符，修正后重发。
5000	发送超时	提交消息至 Meta 时超时，本条消息未成功送出。	稍后重试。
5001	账户余额不足	账户余额不足，消息未发送。	前往控制台充值后重新发送；建议开启余额告警。