预验证失败的原因及重试时机
号码状态显示 Failed,原因为 verification_code_not_received 或 verification_rate_limited。前者表示 Bird 在该次尝试中未获取到可用的验证码。后者表示 WhatsApp 限制了验证请求。仅凭其中一个错误并不能说明您不控制该号码。
预验证的作用
WhatsApp 必须先确认您控制某个号码,然后才能通过该号码发送消息。Bird 通过自动语音呼叫或 SMS 请求验证码,并代您提交收到的验证码。
每种接收方式有十分钟的验证码有效期。Bird 在备选方式可用时可以尝试切换,因此整个过程可能超过十分钟。基础设施重试会进一步延长耗时。请以号码的当前状态为准,不要将十分钟视为完成期限。
检查失败的尝试
在 WhatsApp > Numbers 下打开该号码,重试前先查看错误信息。
- Code not received: 检查该号码是否支持相应的接收方式,以及 Bird 能否接收验证呼叫或 SMS。路由或接收问题可能导致验证码无法送达。
- Verification rate limited: 避免重复请求。等待号码页面上显示的重试时间;Meta 在该时间过后仍可能继续限制请求。
如果该号码存在其他连接错误,请先使用电话号码设置排查这些问题。
重试
- 等待 Try again 变为可用。当记录了最后一次请求验证码的时间时,控制台会从该请求起等待两小时,而非从稍后的失败时间起等待两小时。
- 在号码页面上选择 Try again。Bird 将启动另一次验证尝试。您无需先断开该号码。
- 如果再次失败,请记录错误和尝试时间并联系支持团队。在底层接收问题或服务商限制未解决之前,避免反复请求验证码。
重试按钮变为可用并不保证 Meta 会接受下一次请求,也不保证验证码能够送达。
通过语音或 SMS 接收
Bird 在有未使用的语音尝试次数时优先使用语音,也可以在支持的情况下使用 SMS,包括无法准备语音路由时。开始前请检查号码的能力和接收路径。语音能力为流程提供了另一种接收验证码的方式,但并不保证更高的送达率。
后续步骤
- 电话号码设置:连接号码及排查其他故障
- 号码质量与消息发送限制:已连接账户可以发送的内容
- WhatsApp 业务验证:Meta 的独立业务身份审核