主叫号码
主叫号码是工作区在外呼时可以呈现的号码。Bird 会在每次呼叫时将 SIP From 请求头与此工作区可以呈现的 Bird 号码及其已验证的外部号码进行比对。呈现不符合使用条件的号码的呼叫会被拒绝。
在 Voice > 号码 下管理主叫号码，该列表显示工作区可用于语音的所有号码。从我们购买的号码和您验证过的号码显示在同一列表中，每个号码一行。同时满足两种条件的号码只出现一次。从我们购买的号码在您持有后即可用于呈现，无需验证电话：持有本身就是证明。以下流程适用于您在其他地方拥有的号码。
每行显示名称、号码及其所属国家/地区、提供商、支持的通话方向及用途。等待验证码的号码显示为验证中；验证码已过期或尝试次数已用尽的号码显示为失败。每页最多包含 25 个号码。选择一行即可打开该号码的页面。
注册号码
- 选择 添加号码 > 验证您持有的号码。
- 以 E.164 格式输入号码：前导
+、国家代码和国内号码。一个号码在工作区中只能注册一次。 - 保存。系统会立即向该号码拨打验证电话。
- 接听电话并记下六位数验证码。
- 在仪表板中输入验证码。您有五次尝试机会，验证码被接受后状态变为 已验证。
来电显示验证不会因验证电话向您的工作区收费。注册仍需要语音管理权限以及账户对注册已验证号码的审批。注册后可在号码详情页为其命名。参见为号码命名。
验证完成后，在 Voice > 目的地 下检查您要拨打的国家/地区。验证流程会尝试启用已验证号码所属的国家/地区，但不可用的国家/地区或设置更新失败可能导致其未被启用。已验证的主叫号码和已启用的目的地是两个独立的要求。
通过 API 注册和验证
注册号码即可发起验证呼叫，然后使用注册返回的 ID 提交验证码。列出主叫号码可找到在仪表板中注册的号码。您还可以重命名或删除主叫号码。读取操作需要 voice_management:read；注册、验证、重命名和删除需要 voice_management:write。API 参考文档包含 SDK、Bird 命令行和 MCP 示例。
如果首次验证呼叫未能启动，提交验证码可能会再次呼叫已注册的号码。您的组织仍须满足注册要求。如果验证码过期或尝试次数用尽，请删除该主叫号码并重新注册，系统会发起新的验证呼叫；然后使用该次注册返回的 ID 提交新验证码。如果验证码被接受但激活返回 412 或 503，所有权仍已证明，该主叫号码显示为 verified 且 outbound_enabled: false。412 表示身份验证未完成（请在控制台中完成），或资格审核或拒绝需要联系支持团队。503 表示资格评估仍在进行中或暂时不可用，请稍后重试。问题解决后，向同一 ID 提交空的验证请求；不要删除后重新注册。
验证后，请检查 Voice 目的地，并在支持且需要时启用该号码的国家/地区。验证过程会尝试启用它，但即使主叫号码验证成功，目的地也可能仍处于禁用状态，拨往该国家/地区的出站通话仍会被阻止。
同一时间只能进行一个验证
当验证提供商已有该号码属于另一个工作区或其他用途的挑战时，注册可能返回 E21036。请等待该验证完成或过期，然后重新注册该号码。为另一个工作区获得的证明不会在您的工作区中验证该号码。
同样的拒绝也适用于号码因其他验证而暂时不可用的情况：已有登录验证码或 Trust Hub 验证正在处理中。如果没有其他工作区正在验证该号码，通常就是这个原因，同样需要等待验证完成或过期。
已在其他地方完成的验证不会阻止您：同一个号码可以在多个工作区中作为已验证的主叫号码，每个工作区分别进行验证。
状态
| 状态 | 含义 |
|---|---|
| 待验证 | 已注册，等待验证码。使用该行的输入验证码完成验证 |
| 已验证 | 验证码已接受。出站通话时可以将该号码显示为主叫号码 |
| 失败 | 验证码已过期或尝试次数已用尽。使用该行的获取新验证码发起新的验证呼叫 |
获取新验证码 会重新注册该号码并拨打新的验证电话。如果第一次电话从未接通且号码仍处于待验证状态，请先移除该主叫号码，然后重新添加。
如果您通过自有工具读取这些值，请匹配您处理的状态，将其他状态视为未处理的状态而非错误。
CLI 验证与送达免责声明
Bird 执行 CLI（主叫线路识别）验证，以确认 A 号码有效并已获授权，然后才能从平台发起外呼。此验证确保号码合法且在客户的控制之下。
但是，当 CLI 不是通过 Bird 获取的号码时，验证不保证 CLI 的端到端送达或呼叫的接通。下游运营商和国际运营商会按照各自的国家法规和流量策略处理，这些不在 Bird 的控制范围内。可能包括：
- 反欺骗和主叫号码认证框架（例如美国的 STIR/SHAKEN、英国 Ofcom 的 CLI 指南）
- 要求 CLI 为本地注册号码或境内号码
- 终端运营商应用的垃圾信息和欺诈过滤
- 针对特定流量类别的限制，例如博彩、金融推广、催收或政治信息
- 拦截使用境内 CLI 的国际呼叫（"origin-based" 限制）
- 禁止发起号码列表和监管机构强制拦截
基于上述原因，Bird 可以验证 CLI，但无法保证 (1) CLI 会被保留并显示给被叫方，或 (2) 呼叫会通过国内中继或国际一级合作伙伴和运营商接通。为最大限度提高 CLI 的送达率和呼叫接通率，我们建议使用通过 Bird 获取的号码，这些号码的配置和路由符合当地监管要求。
为号码命名
名称用于在仪表板和拨号器的 呼出号码 列表中标识号码，不会随呼叫发送。
在 号码 列表中选择该号码以打开其页面，然后设置 名称 并保存。留空则仅显示号码。命名适用于任何状态，不会更改号码或其验证结果。
验证无法接听的号码
必须有人接听验证电话并听取验证码。如果该号码通常连接到无人值守的系统，请临时将其转接到您可以接听的电话，验证后再转回。如果该号码无法接听来电，请联系支持团队。
移除主叫号码
使用号码行上的 移除主叫号码。移除验证会撤销新呼叫的归属证明。通过 Bird 由工作区持有的号码可凭其分配保持可用；失去证明的外部号码会被拒绝，返回 caller_id_not_verified。正在进行的呼叫不受影响，已有的通话记录不会更改。