跨境王 WhatsApp 发送失败？核对错误与重试结果
WhatsApp 显示发送失败时，先选一条原本就获准发送的消息，核对它从哪个入口发出、当前停在哪个阶段，再判断是否有理由重试。手机应用的回执、API 请求的返回值和异步送达状态不是同一件事，不能用一组固定参数处理所有情况。
下文只核对这条消息与一次有条件的复核，不扩成批量联系人测试。配图为记录与判断流程示意，并非跨境王或 WhatsApp 的实际界面，也不是发送效果实测。
快速导航
选定一条消息与实际入口
- 选一条已经获准发送、实际出现问题的消息。记下原发送时间与时区、收件人代号、文字或媒体类型，以及当前界面显示的状态；记录时不要复制完整手机号、客户正文或访问令牌。
- 确认入口是 WhatsApp 手机应用、WhatsApp Business 应用，还是已经确认的 Business Platform / Cloud API 接入。通过辅助工具操作却不知道底层链路时，先记为“入口尚未确认”，向现有负责人核实，不据品牌名猜 API 类型。
- 保留原消息，暂停重复点击发送。查看当前可见信息，确认是否有原任务仍在等待或现有自动重试正在处理；无法确认，就把这一点写在记录里。
手机应用用户不因一次发送失败就需要申请 API token。辅助工具是否接入某个接口、有没有自动重试入口，也需要按当前实际可见功能确认。
先记录一条原消息的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
分开记录状态与错误
给这条消息建立一份简短记录：原时间、入口、收件人代号、消息类型、当前状态、原样错误、可见关联编号，以及观察时间。没有显示的项目填“不可见”，不要凭猜测补齐。
- 等待或时钟状态：先核这次尝试是否仍在处理，不能直接当成可以重新发送的明确失败。
- 已发送但没有送达证据：记录当前回执或已有状态，不能把未读、未送达和未发出混在一起。
- 明确错误：保存原样错误及发生位置，继续走对应分支。
- 超时或没有结果：先保留“结果未知”，后面需要核原尝试是否已经发生。
API 的 HTTP 状态、业务错误码和异步消息状态要分栏记录。例如 HTTP 403 不能直接译为联系人黑名单，HTTP 503 也不能直接证明账号受限。手机应用没有显示这些信息时，不要求用户寻找一个并不存在的统一错误面板。
分开状态与错误的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
手机应用：核原消息与一次连接条件
在 WhatsApp 或 WhatsApp Business 手机应用中，查看原消息旁的实际标记，以及当前版本已有的消息信息：时钟表示尚未成功发出；单勾、双灰勾、蓝勾对应不同阶段。没有蓝勾，不能单独证明发送失败或对方已屏蔽你。可对照 WhatsApp 消息回执帮助。
接着核一次当前联网情况：设备是否已联网、是否存在当前可见的连接提示，其他已有应用是否也无法连接。若需要调整连接，只改变已经发现的那一项条件，再回来查看同一条原消息，而不是立即复制发送一条新消息。
如果只有一个联系人未收到，记录这个范围，不把现象唯一归因于拉黑或永久不可达。官方列出了多种可能原因，参见 无法发送或接收消息帮助。一次检查后仍无法判明，就保存现象，不靠清数据、重装、退出登录或关闭安全软件来试错。
手机应用有限核对的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
已确认的 API 接入：对齐返回与已有通知
只有当前系统已经确认使用 Cloud API，而且你有相应可见权限时，才使用这一分支。没有权限查看的项目，由现有接口负责人核对，不把 token 或完整客户资料发给他人。
- 从现有记录抄下 HTTP 状态、错误对象的
code、经过脱敏的error_data.details和原时间。它们可能来自请求响应，也可能来自异步失败通知，注明来源。 - 如果原尝试已经返回消息 ID，保留该 ID。请求被接受或拿到 ID 本身不等于已送达。
- 如果现有系统已经保存状态通知，按同一消息 ID、收件人代号和时间关联
sent、delivered、read或failed。不要用另一条消息的通知作为这条消息的结果。 - 看不到状态通知时，写明“该入口当前无可见状态”；不要虚构逐消息查询接口，也不要宣称已经验证送达。
这些状态应按 Meta 消息状态说明 理解；文档说明接口语义，不能证明某个辅助工具已经实现所有通知或面板。
已确认API才走此分支的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
按现有错误码核对明确条件
以下八项用于辨读已经出现的、脱敏的 Cloud API 输出，不是要求制造真实错误或向八个联系人发送测试。记录原样 code、details、时间与本地关联编号，再对照 Meta 错误码说明。手机应用没有使用该接口时，不套用这些码作诊断。
授权、权限、频率与回复窗口
- 190：令牌过期。 由现有授权负责人核有效凭据与该请求，不要求普通手机应用用户申请 token。
- 131005：权限缺失或被移除。 核实际接口权限及当前账号角色，不因此给所有设备开启所有敏感权限。
- 130429：Cloud API 吞吐限制。 按实际限制降低频率并等待，不通过更换账号、IP 或收件人绕过限制。
- 131047：回复窗口之外。 核最近用户来信和当前已批准模板的适用条件。客户服务窗口是该平台规则，不是所有手机应用的重试计时器；政策范围见 WhatsApp Business 官方政策。
前四项错误条件的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
模板参数、媒体与无法送达
- 132001：模板名称、语言或批准状态不符合。 对照这次使用的实际模板记录，不先认定账号被封。
- 132000：模板变量数量不匹配。 核这一条消息的参数个数及与模板的对应关系，由有权限的负责人修正明确差异。
- 131053：媒体上传失败。 按 details 核当前媒体类型和实际文件，不用一个固定大小阈值作为所有媒体的万能修复。
- 131026：消息无法送达。 可能原因不止一个，不能仅凭此码断言收件人未注册、拉黑你或永久不可达。
如果当前输出不是这八项，保留实际码和 details，查对应官方条目或交给现有支持处理。不要把不认识的错误硬分到“安全重试”类别，也不要拿通用 HTTP 429 代替实际业务码解释。
后四项错误条件的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
超时或结果未知：先核原尝试，再决定等待
**工程判断：**客户端超时仅表明没有及时收到结果，服务端仍可能已经处理请求。因此，重复提交可能产生重复消息；这不是对跨境王重试机制的实测结论。
先检查已有原请求记录、已经返回的消息 ID 及相关状态通知。若已有明确送达结果，把它归到已送达；若确有失败记录，保留失败及原因；缺少足够证据时继续记“结果未知”。消息 ID 用于关联已有记录，不保证它是幂等键，也不保证工具会自动去重。
有明确限速或等待条件，就按该条件暂停。没有可核条件时，不把固定几十秒、几分钟写成通用安全间隔。不要反复换账户、收件人或 IP，也不要把“模拟真人”当成规避限制的可靠办法。一次核对仍未知，就停止新增尝试并交付现有证据。
超时先核原结果的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
何时才考虑一次人工确认的重发
重发是有条件的决定，先逐项确认：
- 原尝试已明确失败，不是仍在等待、已经送出待送达或结果未知。
- 已找到并修正这条消息的一处具体原因，例如有权限的负责人修正了模板参数。
- 当前收件人授权、回复窗口、模板及其他发送条件仍满足。
- 没有原任务等待执行或自动重试待处理。无法确认这一项时，先不新增尝试。
- 当前已有可用发送入口，操作者知道这次是新的尝试；不为此假设某个队列菜单或安装工具。
全部成立时，才考虑一次人工确认的重发。任一条件缺失，就把缺项写清，交由现有负责人继续判断，而不是开启无限重试或扩成批量发送。
一次重发的前提的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
复核新旧尝试，不把请求成功当作完成
如果已经按上面条件进行了一次新尝试，记下新时间、新关联编号和本次改变的那一项条件，并与原消息记录并排保存。保留两次记录，不把新 ID 覆盖到原尝试上。
应用用户查看这次尝试对应消息的实际回执或消息信息；已确认 API 用户关联这次新 ID的已有状态通知。只知道请求被接受，仍应记为对应处理中状态，不能直接勾选“已送达”。观察不到状态，记为未知；一次复核仍失败或未知，就停止新增尝试。
这次检查只说明这一条消息在这些条件下的状态，不说明可以安全扩大发送规模，也不证明吞吐、成功率或账号安全性。
复核新旧两次记录的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
写下本次结果与可交付信息
按已有证据记录以下一种结果，并附观察时间：
- 未发出：现有应用状态表明尚未成功发出，继续注明连接或等待条件。
- 请求失败：记录对应 HTTP / 业务错误及脱敏 details，不自行等同于账号封禁。
- 已发送待送达：有相应发送证据，暂缺送达证据。
- 已送达：有与该条消息对应的实际送达回执或状态。
- 明确失败：有对应失败状态或明确失败输出，保留具体原因与处理条件。
- 结果未知：原结果或当前状态不可判明；不是“失败已解决”。
未解决时，通过已有支持入口交付：实际入口、版本、原时间与时区、收件人代号、消息类型、关联 ID、原样错误和一次核对结果。去除 token、完整手机号和客户正文；没有的信息标“不可见”。完成标准是这份有依据的结果记录，不是保证某个固定时限内送达。
记录六种可核结果的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
常见疑问
是否需要重新安装或以管理员身份运行？
一次发送失败不能证明安装出了问题，也不能证明管理员权限会解决消息投递。先按现有入口核这条消息的状态和具体错误；没有确认的安装问题，不把重装、清数据或关闭安全软件列为默认动作。
能离线核对吗？
可以整理已经保存的脱敏记录，但离线记录不能证明后续网络发送或送达。应用连接和 API 状态应按当前实际可见情况核对；没有证据时，不宣称工具离线也能完成消息重试。
一次成功是否证明工具更稳定？
一次有条件复核只提供这条消息的结果。比较产品、保证防封、长期成功率或自动恢复能力，都需要其他证据，不能从一条成功记录推出。
为什么没有蓝勾或得到 131026 仍不能认定被拉黑？
已读、送达和发送是不同阶段；相同未送达现象也可能有不同原因。保留实际标记或完整错误与条件，不以一个标记或错误码唯一判定对方行为，也不把收件人标成永久失败。
常见疑问与交付边界的流程示意，并非跨境王或WhatsApp实际界面，也不表示已实测发送结果。
相关阅读
Need Help
想把文章里的方法直接落到真实业务流程里？
如果你正在做 WhatsApp 获客、名单清洗、跨境社媒触达或云端过滤平台部署，可以查看获取状态、相关资料和咨询信息。