# 预验证失败的原因及重试时机

号码状态显示 **Failed**，原因为 `verification_code_not_received` 或 `verification_rate_limited`。前者表示 Bird 在该次尝试中未获取到可用的验证码。后者表示 WhatsApp 限制了验证请求。仅凭其中一个错误并不能说明您不控制该号码。

## 预验证的作用

WhatsApp 必须先确认您控制某个号码，然后才能通过该号码发送消息。Bird 通过自动语音呼叫或 SMS 请求验证码，并代您提交收到的验证码。

每种接收方式有十分钟的验证码有效期。Bird 在备选方式可用时可以尝试切换，因此整个过程可能超过十分钟。基础设施重试会进一步延长耗时。请以号码的当前状态为准，不要将十分钟视为完成期限。

## 检查失败的尝试

在 [**WhatsApp > Numbers**](https://bird.com/dashboard/w/whatsapp/numbers) 下打开该号码，重试前先查看错误信息。

- **Code not received:** 检查该号码是否支持相应的接收方式，以及 Bird 能否接收验证呼叫或 SMS。路由或接收问题可能导致验证码无法送达。
- **Verification rate limited:** 避免重复请求。等待号码页面上显示的重试时间；Meta 在该时间过后仍可能继续限制请求。

如果该号码存在其他连接错误，请先使用[电话号码设置](/docs/guides/whatsapp/phone-number-setup)排查这些问题。

## 重试

1. 等待 **Try again** 变为可用。当记录了最后一次请求验证码的时间时，控制台会从该请求起等待两小时，而非从稍后的失败时间起等待两小时。
2. 在号码页面上选择 **Try again**。Bird 将启动另一次验证尝试。您无需先断开该号码。
3. 如果再次失败，请记录错误和尝试时间并联系支持团队。在底层接收问题或服务商限制未解决之前，避免反复请求验证码。

重试按钮变为可用并不保证 Meta 会接受下一次请求，也不保证验证码能够送达。

## 通过语音或 SMS 接收

Bird 在有未使用的语音尝试次数时优先使用语音，也可以在支持的情况下使用 SMS，包括无法准备语音路由时。开始前请检查号码的能力和接收路径。语音能力为流程提供了另一种接收验证码的方式，但并不保证更高的送达率。

## 后续步骤

- [电话号码设置](/docs/guides/whatsapp/phone-number-setup)：连接号码及排查其他故障
- [号码质量与消息发送限制](/docs/knowledge-base/whatsapp/number-quality-and-messaging-limit)：已连接账户可以发送的内容
- [WhatsApp 业务验证](/docs/knowledge-base/whatsapp/business-verification)：Meta 的独立业务身份审核

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [Connect WhatsApp](/products/whatsapp) (product)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=whatsapp-connect)