Voice 概览
Bird Voice 支持拨打电话号码，并接听您持有号码的来电。您可以通过 SIP 连接电话系统、从浏览器发起通话，或使用序列构建器运行已保存的通话流程。Bird 将通话连接到公共电话网络，即 PSTN。
您的电话系统与 Bird 之间的连接是一条 SIP 中继。SIP（Session Initiation Protocol）负责在电话系统之间建立通话。Bird 会为您的工作区分配一个中继地址，您的电话系统使用该地址发起呼出，Bird 也通过该地址反向将拨入您号码的来电送达。
您不需要电话系统就能拨出第一通电话：仪表板中的电话可以通过您的某条中继直接从浏览器发起呼叫。
您也可以在仪表板中构建序列，然后通过 Create Call API 启动它。接收方接听后，序列会处理语音提示、按键选项和通话路由。
通话如何发起
您的电话系统向中继地址发送 SIP INVITE 以发起呼叫。Bird 在联系运营商之前会检查主叫号码、目的国家、限额和钱包余额。如果呼叫通过检查，Bird 会路由该呼叫并中继音频。每个连接称为一个分段（leg）。当一个分段结束时，Bird 会在 Voice > Legs 下写入其记录，并发出一个 voice_call.ended 事件。
未通过检查的呼叫会在运营商介入之前被拒绝，具体原因会记录在分段记录中。发起呼叫介绍了 Bird 从每次呼叫中读取的内容，被拒绝的呼叫列出了所有拒绝原因及处理方法。
来电如何被接听
工作区持有的每个号码同一时间只有一种应答方式，可在号码本身设置；如果号码未设置，则使用工作区的默认路由：将来电送到您的某个 SIP 中继、转接到您已验证的号码、运行已发布的序列，或拒绝来电。默认路由初始为拒绝，因此未经任何人配置的号码会拒接所有来电。
当来电到达时，Bird 会像处理您发起的通话一样检查账户限额和钱包，然后按号码的接听设置执行操作，并将该设置记录在通话记录中。接听来电介绍了如何将号码指向某种接听方式、转接时对方看到什么，以及如何查看拒绝原因。
首次通话前的准备
使用您自己的 SIP 设备通话时，请完成以下准备。API 通话请遵循 Create Call 前提条件。
- 创建 SIP 中继，开启呼出功能，并允许呼叫者使用该中继：为您自己的设备配置 IP 范围或 API 密钥，为浏览器或 CLI 配置会话凭据。
- 选择合格的主叫号码：使用您的工作区通过 Bird 持有的号码，或注册一个外部号码并通过验证电话进行确认。
- 启用目的地：开启您要拨打的国家。
拨出第一通电话会引导您完成全部三项要求，最终拨出一通真实电话。
查看通话记录需要 voice:read；发起通话需要 voice:write。管理中继、号码路由、主叫号码和序列使用 voice_management 权限。拥有页面访问权限并不意味着可以更改其设置或发起计费通话。
仪表板中的 Voice 应用
| 页面 | 用途 |
|---|---|
| Metrics | 通话量和接通率随时间的变化、通话结果、热门国家，以及呼入与呼出的分布。参见 Voice 指标 |
| Legs | 工作区通话的逐分段记录，以及当月用量汇总 |
| Calls | 相关的通话分段和参与者归组到同一通通话中 |
| Numbers | 工作区可用于语音的每个号码，以及每个号码对来电的处理方式 |
| SIP Trunks | 您的中继、其 SIP 域名、谁可以向其发送流量，以及入站来电送达的位置 |
| Destinations | 工作区可以拨打的国家，默认关闭 |
| Sequences | 构建、预览、发布和检查通话工作流 |
| Phone | 一个浮动电话窗口，通过您的某条中继从浏览器发起通话 |
可见性
一次呼叫可以包含多个通话分段。日志中每个通话分段各有一条记录，无论该分段是否接通、振铃超时还是被拒绝。因此，转接呼叫或多方通话可能有多条记录：
- 通话分段日志：Legs 页面上的逐分段视图。包含状态、双方号码、分段接入的中继、结束时的 SIP 响应、应答和结束时间、计费时长和费用。可对其进行筛选，然后将结果导出为 CSV。
- Voice 事件：
voice_call.initiated、voice_call.answered和voice_call.ended推送到您的端点，使您的系统无需轮询即可获知通话状态。
API 参考列出了支持的公共 HTTP 契约和 SDK 方法。CLI 参考和 MCP 工具参考描述了各自已发布的操作。这些接口可能暴露不同的操作；仪表板操作或 CLI 命令本身并不等同于一个公共 SDK 方法。
限额
您的通话在呼入和呼出两个方向上都受三项上限约束：同时进行的通话数、每秒新建通话数，以及一个 UTC 日内的语音花费。您的 Voice 计划按组织设置并发通话数和每秒通话数上限：按量付费使用默认值，更高的 Voice 档位会提高这两项上限。每日花费限额的设置方式不同。每个工作区在 Voice → Spend limit 下设置自己的限额，并在 Voice → Destinations 下按国家设置，最高不超过您组织的上限；最高档位的 Voice 计划会提高该上限。超出任一上限的通话会在建立时被拒绝，其记录会标明超出的是哪项上限，详见被拒绝的呼叫。各计划的具体数值见 Voice 定价页面；如需升级，请前往 Billing and payments > Overview。
平台通话时长上限为 3 小时。通话达到该时长后，Bird 会挂断双方，因此请将更长的会话拆分为多通通话。运行通话序列的呼叫从 Bird 接受或接收它时开始计时，因此等待拨号和振铃的时间会占用 3 小时中的一部分。状态说明了此类通话在日志中的显示方式。
每秒上限对应请求速率限制中的 voice_call 策略，该页面还说明了如何确定您的有效限额以及如何提高该限额。