运营商可以提供某个号码出售，但 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 错误。
预检会改变什么？
会。它会将候选号码发送至 WhatsApp。Meta 可能会在 Bird 的商业账户下创建一个临时条目。
预检不会将号码连接到您的工作区，也不会为购买预留号码。只检查您打算购买的候选号码，因为批量扫描会为未使用的号码留下临时条目。
重试同一检查时复用 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 的自有号码设置无法在该号码的个人账户或 WhatsApp Business 应用注册仍处于活跃状态时完成连接。请先与账户所有者协商解除该注册，然后再尝试连接。
通过预检的号码仍需完成连接流程。确认其状态变为 Connected 后，再将其用作您的品牌发送方。
Bird 托管发送方是用于托管身份验证和实用模板的独立选项。它们不会发送您的自由格式内容，也不会将客户回复接收到您的工作区。
简而言之
先检查再购买。
号码搜索不能确认 WhatsApp 兼容性。请对您打算购买的候选号码运行预检。
不要自行推测 unavailable 的原因。
该号码可能已被注册，也可能不受支持。结果不会区分这些情况。
将预检视为写操作。
预检会将号码发送至 WhatsApp，并可能创建一个临时条目。它不会预留或连接该号码。
对同一检查复用重试键。
幂等重放会返回已存储的结果。该结果描述的是先前的检查，而非最新的可用性保证。