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