什么是语音 API？

回呼、电话菜单和语音助手使用呼叫平台的不同部分。

语音 API 可以控制什么？

语音 API 可以暴露配置、呼叫控制和报告功能，支持的操作由提供商定义。

配置涵盖中继线、主叫身份、目的地和号码路由。呼叫控制涵盖会话中的行为，例如语音提示或按键输入。报告返回呼叫的状态、时长和其他记录的结果。

不同提供商以不同方式实现呼叫控制。例如，Twilio 的 TwiML 通过返回给 Twilio 的指令描述操作。因此迁移应用程序意味着映射其行为和回调预期，而不仅仅是替换主机名。

读取呼叫的方法不等于发起呼叫的操作。

API 和 SIP 如何协同工作？

应用程序 API 可以配置或控制服务，而 SIP 在其下层建立电话会话。

SIP 是呼叫信令协议，用于创建、修改和终止会话，并协商参与者的连接方式。RTP 承载音频等实时媒体。

这些路径可以独立失败。呼叫可能在振铃，但媒体设置或网络路径阻止了某一方听到对方的声音。除了振铃和挂断之外，还要测试双向音频。

PBX（企业电话路由系统）可以保留自身的呼叫处理逻辑，同时使用提供商的 SIP 中继线。对话式运行时可以使用类似的连接，同时自行提供语音和业务工具。

我可以读取哪些呼叫信息？

通话记录标识该次尝试并报告其观测状态。可用字段取决于操作类型和呼叫所处的阶段。

• 连接： 呼叫是否被接纳、振铃并收到应答。
• 媒体： 参与者是否能听到彼此并进行交互。
• 业务结果： 预期的预约、回呼或支持任务是否完成。

已接听的电话呼叫可能到达真人、语音信箱或另一个自动化系统。仅凭通话记录无法证明客户完成了某项任务。

事件帮助你的应用程序对变化做出响应。处理重复和延迟送达的事件，然后将缺失或不确定的更新与提供商的记录状态进行核对。

如何使用 Bird 构建？

你需要配置外呼，包括一条 SIP 中继线、一个已验证的主叫号码和一个已启用的目的地国家。

配置变更需要具有写入级别的 voice_management。

在中继线上，outbound_enabled 必须为 true。其 domain 是你的 SIP 客户端连接的地址。API 密钥认证将你的密钥列在 allowed_api_key_ids 中；该密钥需要具有写入级别的 voice。更新该列表会替换所有条目，因此请保留其他客户端仍在使用的密钥。

你的主叫号码需要 status: verified，这表示你的工作区已完成验证呼叫。其 phone_number 包含国际号码，含前导 +。

目的地国家需要同时满足 enabled: true 和 status: available。启用某个国家并不意味着不支持的目的地变为可呼叫。

浏览器电话还需要在中继线上设置 session_credentials_enabled: true，并在中继线的 digest_algorithms 列表中包含 MD5。

通话后，您可以查看 status、rejection_reason 和 sip_response_code。列出呼叫段和读取呼叫段操作会返回这些字段。这些操作报告呼叫尝试的情况。您的 SIP 应用负责发起这些尝试。

对于电话菜单，你需要在已连接的应用程序中配置语音提示和按键分支。语音 AI 运行时为对话提供语音、推理和业务工具。