运营商可以提供某个号码出售，但 WhatsApp 可能不接受它。在下单之前检查候选号码，可以避免为无法通过预期设置流程连接的号码付费。
如何运行 Bird 的号码预检？
在购买之前，使用 bird whatsapp numbers precheck 对候选号码执行检查。
bird whatsapp numbers precheck +31612345678以国际格式提供号码，以 + 开头并附上国家代码。API 请求将号码放在 phone_number 中。您不需要已经拥有该号码。
端点为 POST /v1/whatsapp/numbers/precheck。使用已登录的 CLI 或具有 whatsapp_management:write 的 MCP 授权，具体要求见命令参考。
| 标志 | 用途 |
|---|---|
--example | 查看不含凭据的请求体 |
--dry-run | 查看解析后的请求但不发送 |
--response-schema | 查看响应字段 |
MCP 客户端通过 whatsapp_numbers_precheck 调用相同的操作。
available 和 unavailable 分别表示什么？
available 表示检查未发现连接该号码的障碍。unavailable 表示 WhatsApp 拒绝了该号码。
| 结果 | 对购买候选号码的操作建议 |
|---|---|
available | 继续购买流程，注意该结果不会预留号码 |
unavailable | 跳过该候选号码，选择其他号码 |
unavailable 号码可能已在 WhatsApp 上注册，也可能是 WhatsApp 无法服务的号码。结果不会区分这些原因，因此不要仅凭结果推断具体原因。
请求失败与 unavailable 结果不同。在将候选号码视为不可用之前，先处理返回的 API 错误。
预检会预留号码吗？
不会。预检不会将号码连接到您的工作区，也不会为购买预留号码。在您下单之前，其他人可能抢先获取 available 号码。
只检查您打算购买的候选号码，不要批量扫描号码列表。
重试同一检查时复用 Idempotency-Key。在 Bird 的三小时响应窗口内，相同的键会返回已存储的结果，而不会再次向 WhatsApp 发起请求。
Idempotency-Replay 响应头标识该重放。响应窗口结束后，相同的键可以触发一次新的检查。
预检在购买号码的流程中处于哪个环节？
在下单之前，检查运营商可用性和 WhatsApp 接受状态。
- 使用
bird numbers available list --country-code US搜索号码。 - 使用
bird numbers available get重新检查所选候选号码。 - 对该候选号码运行 WhatsApp 预检。
- 仅在
available之后下单，使用bird numbers orders create。
运营商可用性复查返回 404 表示您需要另一个候选号码。在下单之前，请在控制台中完成所需的组织验证。
pending 订单仍需运营商完成配置。在依赖该号码之前，等待订单完成交付。
可以检查我已经拥有的号码吗？
不可以。预检适用于您计划从 Bird 购买的号码，不适用于您已持有的号码，也不适用于共存号码。要连接您已拥有的号码，请使用 Bird 的自有号码设置。
如果该号码的个人 WhatsApp 注册仍处于活跃状态，该设置无法连接此号码。已在 WhatsApp Business 应用上使用的号码可通过共存方式连接。确认号码状态变为 Connected 后，再将其用作您的品牌发送方。
Bird 托管发送方是用于托管身份验证模板和实用模板的独立选项。它们不会发送您的自由格式内容，也不会将客户回复接收到您的工作区。
简而言之
先检查再购买。
号码搜索不能确认 WhatsApp 兼容性。请对您打算购买的候选号码运行预检。
不要自行推测 unavailable 的原因。
该号码可能已被注册，也可能不受支持。结果不会区分这些情况。
不要将结果视为预留。
该检查不会预留或连接号码。请在结果仍有效时尽快下单。
对同一检查复用重试键。
幂等重放会返回已存储的结果。该结果描述的是先前的检查，而非最新的可用性保证。