语音常见问题解答

Bird Voice 将电话系统和应用连接到电话网络。使用 SIP 中继、浏览器呼叫和呼叫序列，或接入 AI 语音运行时。通过通话记录、会话和事件跟踪呼叫。

创建工作区，准备可用于呼叫的中继和主叫身份，并启用你要测试的目的地。配置时间取决于访问权限、验证流程和你连接的客户端。首次呼叫指南会引导你完成一次受控的浏览器呼叫。

您需要准备三样东西：一个允许您的设备接入的 SIP 中继（通过 IP 范围或 API 密钥授权）、一个已验证的主叫号码（您作为来电方显示的号码），以及已启用的目的地国家。Bird 会将路由附加到您的工作区，这是第四个前提条件，由 Bird 完成。

不需要。使用浏览器电话或兼容的 SIP 软电话、PBX 或应用。将支持的传输方式、认证和媒体设置与中继配置相匹配。

是的。您可以使用 WebRTC 从仪表板的电话应用拨打电话。

按通话计费，费率取决于目的地国家。每个费率有一个计费增量：最低计费时长，以及之后的进位步长。例如，一个最低计费一分钟、步长为六秒的费率，会将一通 10 秒的通话按整分钟计费。

计费时长从被叫号码接听的那一刻起算，到通话结束为止。请查看适用于你的使用场景的已发布费率组成部分；号码租用和其他已配置的服务与接听通话时长分开计费。

预付费，从您组织的钱包中扣款。Bird 在拨通运营商之前会检查您的余额，因此余额不足的通话会在拨出前以 insufficient_balance 原因被拒绝，而非事后计费。

是的。每个组织有每日语音消费上限，在每个 UTC 日开始时重置。超过限额后，通话将被拒绝并返回 daily_spend_exceeded。具体金额取决于您的套餐，Bird 可以根据请求提高限额。

在通话记录中打开该通话。费用在计费完成后显示在记录上，精确到完整精度，不含税。如需查看多个通话的总费用，可从通话页面将筛选后的通话列表导出为 CSV，或查看您的发票和使用情况。

三个上限：同时进行的呼叫数（并发呼叫数）、每秒可发起的新呼叫数（每秒呼叫数）以及一个 UTC 日内的语音消费金额（每日消费上限）。适用的上限取决于你的账户配置。

通话在建立阶段即被拒绝，运营商不会被拨通。通话记录会标明触发了哪个限制：concurrent_calls_exceeded、calls_per_second_exceeded 或 daily_spend_exceeded。您的电话系统会收到 SIP 503 响应。

请联系支持团队，提供你预期的流量、目的地和消费情况以申请限额审核。在增加生产流量之前确认已批准的限额。

请查看通话记录中的拒绝原因。拨号器可能在远未达到并发通话上限时就触发了 calls_per_second_exceeded，因为这两个限制是独立的。降低拨号速率后重试；立即重试会得到相同的结果。

不需要。SIP 中继将兼容的电话系统连接到 Bird。将中继支持的传输、认证和媒体设置与您使用的客户端匹配即可。

可以。分别配置每个方向。呼入还需要将一个支持呼入的号码指向该中继，并配置交付网关。

可以，前提是其运行时能同时处理 SIP 信令和音频连接。会话应用控制语音、模型和业务操作；Bird 承载电话连接。

指向该中继的号码将回到拒绝路由。重新启用中继不会恢复之前的绑定关系；在恢复流量前请检查号码配置。

Bird Voice 不承载紧急呼叫。请使用专为此需求设计的电话服务。

SIP 中继是您的电话系统与 Bird 之间的连接。SIP（会话发起协议）是电话系统用于建立通话的协议，中继是通话传输的线路。Bird 会为您的工作区分配一个中继地址，您只需将电话系统指向该地址即可。

大多数工作区只需要一个。当您需要为不同站点或系统设置独立的访问规则时，可以创建更多中继，因为 IP 允许列表、允许的 API 密钥和 Digest 设置都是按中继配置的。

中继的 SIP 域名（从中继页面复制）、用户名 bird，以及密码（即该中继上已授权的 API 密钥的密钥值）。将呼叫发送到 SIP 域名的端口 5060（UDP 或 TCP）或 5061（TLS）。

可以，通过 IP 允许列表、允许的 API 密钥或两者结合。添加您设备发送 SIP 的公共地址，或要求每个通话通过 SIP Digest 使用 API 密钥进行身份验证。两者都在下一次通话时生效。

中继的 SIP 域名会立即停止接受新通话。正在进行的通话将继续，通过该中继产生的通话记录仍保留在您的通话日志中。

您的 PBX 发送呼叫，Bird 以 407 质询响应，然后您的 PBX 使用 Proxy-Authorization 头重新发送呼叫，该头由用户名 bird 和您的 API 密钥的密码计算得出。您的 PBX 发送的是密码的哈希值，而非密码本身。

SHA-256 和 MD5。Bird 默认优先提供 SHA-256，其次是 MD5，您的 PBX 会选择其支持的第一个算法。如果您的设备仅支持 MD5，且无法正确处理以 SHA-256 开头的质询，请将中继设置为仅 MD5。

可以。当中继同时配置了两者时，Bird 会在质询密码之前先检查源地址，因此来自未列入白名单地址的呼叫无论携带什么凭据都会被拒绝。

先将新密钥添加到中继，再将您的设备切换过来，然后撤销旧密钥。撤销或删除密钥会立即移除其在所有允许该密钥的中继上的认证能力。

来电显示号码是你的工作区被允许在外呼中作为主叫号码展示的电话号码。Bird 会在每次呼叫时将你的设备在 SIP From 请求头中填入的主叫号码与此列表进行比对，使用你的工作区的合格身份，包括 Bird 中持有的符合条件的号码和已验证的外部号码。

以国际 E.164 格式添加号码并完成验证流程。接听验证来电并在控制台中输入验证码。使用号码上显示的状态确认其已就绪后再拨打。

如果尝试次数已用完，请点击该号码所在行的

安排通过接收该号码来电的系统来接听验证来电。如果该号码无法接收验证来电，请联系支持团队了解可用的所有权验证方式。

从那一刻起，任何使用该号码的呼叫都会被拒绝，原因为 caller_id_not_verified。已在进行中的呼叫不受影响，使用过该号码的通话记录也保持不变。

话费欺诈的手段是拨打您从未打算呼叫的高费率国家/地区。您启用的国家/地区就是您可能产生费用的范围，因此关闭其他所有国家/地区可以在有人入侵您的电话系统时限制您的风险敞口。

在目的地页面使用搜索框查找国家/地区（支持按名称或两位字母代码搜索），然后开启其开关。更改即时生效。

拨打高风险国家/地区的费用很高，而您所拨号码的运营者会从中获取一部分费用。这些正是攻击者在入侵电话系统后会瞄准的国家/地区。除非您在当地有业务需求，否则请保持关闭状态，并在启用前查看费率。

请联系支持团队为您的账户开通。Available 表示您可以启用；Not supported 表示 Bird 目前无法从您的账户向该国家/地区拨打电话。

可用的国家内部仍可能有路由尚未覆盖的特定目的地。请将通话 ID 提供给支持团队，以调查目的地覆盖范围和拒绝原因。

两个请求头：To（被叫号码）和 From（你作为主叫展示的号码，必须是合格的主叫身份）。两者都必须是完整的国际号码，采用 E.164 格式，即前导 + 后跟国家代码和国内号码。无需自定义请求头。

STIR/SHAKEN 允许运营商对主叫身份信息进行签名。证明级别反映运营商能验证的主叫方和号码的相关信息。它不保证被叫运营商会接通呼叫或移除垃圾标记。

在通话日志中打开该通话。您的电话系统只会看到一个普通的 SIP 503，但具体原因会记录在只有您能查看的通话记录中。详情上方的面板会标明原因并链接到相应的修复设置。

只有在原因消除后才应重试。因 calls_per_second_exceeded 被拒绝的通话，在您降低拨号速率之前重试会得到相同的结果。请先查看拒绝原因再决定是否重试。

不是。它表示通话已接通。将已确认的业务事件（如预订或已解决的工单）与通话关联，以评估任务是否成功。

通话进行中尚未完成计费。在通话和计费生命周期结束后读取最终记录；值为空不代表价格为零。

验证签名，使用 webhook 标识进行去重，并容忍乱序到达。根据通话记录核对最终结果。

检查方向字段和报告的筛选条件。流量构成和适用的计费项可能不同。

将已计费的通话及其会话与应用中已确认的结果关联。包含每个相关的通话段，并使用一致的时间范围和完成定义。

五种：Answered（被叫号码已接听）、No answer（振铃超时无人接听）、Failed（呼叫未完成，可能是 Bird 拒绝了呼叫或运营商处理失败）、Rejected（运营商直接拒绝了呼叫）和 Unknown（无法确定结果）。

两者都显示为 Failed。区分它们的是拒绝原因：只有 Bird 拒绝才会附带拒绝原因。带有拒绝原因的失败呼叫指向您或 Bird 一方的设置问题；没有拒绝原因的失败呼叫通常指向您所拨打的号码。

可以。呼叫页面的实时标签页会列出您中继上当前的所有呼叫及其数量。正在进行的呼叫显示为 Ringing（等待对方接听）或 In progress（已接通）。该标签页每隔几秒自动刷新。

总时长从 Bird 收到呼叫起计算，到挂断为止。计费时长从接听起算到挂断为止。两者的差值是无人接听的振铃时间，差值较大时值得检查拨打的号码。未接听的呼叫没有接听时长。请查看适用的费率表了解其他通话组成部分和费用。

三种方式：从呼叫页面下载 CSV（导出与当前筛选条件匹配的所有记录，而非仅当前可见页面）；通过 API 使用具有 voice:read 权限的 API 密钥读取；或使用 Bird CLI 执行 bird voice list 命令。

三种：voice_call.initiated（Bird 已接受呼叫并开始路由）、voice_call.answered（被叫号码已接听）和 voice_call.ended（呼叫结束，附带结果）。未被接听的呼叫不会触发 answered 事件。

使用结束事件获取其报告的状态和时长，然后与通话记录核对最终结果。事件发布可能失败，在接入前被拒绝的请求可能没有通话记录或事件。缺少更新并不能说明通话仍在进行。

是的。事件的传递不保证顺序，因此 answered 可能在 ended 之后到达。请按 timestamp 字段排序，并在后到达但时间戳更早的事件冲突时以先到达的为准。

使用 webhook-id HTTP 请求头进行去重。投递或信令重试可能重复发送同一事件。同一通话和同一生命周期阶段保持相同的 webhook 标识。将缺失的更新与通话记录进行核对。

它们在通话记录中，而非事件中。voice_call.ended 上的 failed 状态不会告诉您是 Bird 还是运营商导致了失败。请在通话日志中打开该通话查看拒绝原因，费用会在通话计费完成后显示。

Bird 无法接入的通话会在 SIP 层被拒绝，此时尚未生成记录。请检查以下四项：中继已设置允许您设备的 IP 范围或 API 密钥；通话来自中继 IP 允许列表中的地址（在 NAT 后面，该地址是路由器的公共地址）；Digest 凭证正确（用户名 bird、正确的 API 密钥值、中继提供的算法）；SIP 域名与中继的域名完全匹配。

在通话记录中打开该通话。详细信息上方的面板会显示原因，并链接到可修复问题的设置。您可以修复的七个原因是：source_not_allowed、caller_id_not_verified、destination_not_enabled、insufficient_balance、daily_spend_exceeded、concurrent_calls_exceeded 和 calls_per_second_exceeded。

某些设备无法正确处理以 SHA-256 开头的挑战。将中继的 Digest 算法设置为仅 MD5，您的 PBX 将收到它能理解的挑战。

检查媒体地址、防火墙规则和支持的编解码器。常见原因是 NAT 将媒体发送到不可达的私有地址。配置客户端的 NAT 或 STUN 处理并验证双向音频。

可以加密。Bird 支持在端口 5061 上使用 TLS 进行 SIP 信令传输，因此呼叫建立过程在传输中是加密的。端口 5060 上的 UDP 和 TCP 则不加密。请根据您的安全需求选择相应的传输方式。

每个事件都经过 HMAC 签名。在处理负载之前，请使用端点密钥验证签名，并在需要时从控制面板轮换该密钥。

语音记录遵循已配置的服务区域。请查看适用于你部署的数据处理和保留条款；仅靠 API 端点路由并不能描述所有处理或存储位置。

使用获准密钥的 voice 写入权限认证呼叫，使用 voice 读取权限读取通话记录。单独的 voice_management 作用域覆盖配置操作。中继还会应用其已配置的密钥规则和来源规则。

具体原因会记录在通话记录中，只有您才能查看。向 SIP 层返回通用的 503 可以防止探测您中继的人了解到哪些中继、号码和目的地存在。

认证和安全文档位于信任中心 trust.bird.com。数据处理协议、隐私声明和可接受使用政策发布在 bird.com/legal。如需供应商调查问卷，请联系您的 Bird 客户团队处理。

呼叫序列控制电话通话中的提示、按键选择和录音。自动化流程协调更广泛的业务流程。请将这两种工作流及其发布决策分开管理。

可以。将语音或录音提示与按键输入相结合，并为识别到的数字、超时和未匹配输入设置分支。

不是。按键采集读取的是 DTMF 数字。自然语言语音代理需要具备语音和轮次管理能力的对话运行时。

使用已发布版本的通话会保持该版本的不可变内容。新通话使用新发布的版本。草稿测试通话在每次转换时读取最新保存的序列，可以观察到草稿编辑。

不是。它表示任务已被接受。振铃、接听和最终通话结果需要分别跟踪，并将不确定的重试关联到同一操作。

不是。电话菜单遵循预定义的选项，如按键数字。AI 语音对话则解读语言并通过对话运行时生成回复。两者都需要完整的呼叫路由和结果处理设计。

支持 SIP 的运行时可以通过 Bird 连接，前提是其信令、认证和媒体行为兼容。在迁移流量之前，先用双向真实通话验证集成。

不能。MCP 允许经授权的软件代理操作账户工具。实时语音助手还需要音频、语音处理、轮次控制和对话应用。

通过应用的授权工具连接这些操作。将返回的状态视为唯一事实来源，并在执行变更前要求客户进行相应确认。

将呼叫接通率和完成率与任务成功率分开衡量。跟踪已确认的业务结果、转人工率和观察到的失败原因；仅凭通话转写文本或已接听的电话无法证明转化。

不会。需要配置号码的呼入路由。拒绝路由是一种明确的处理结果，而非自动连接到团队或坐席。

可以，通过你配置用于接收来电的呼叫应用或 SIP 运行时。号码、呼入中继、网关和会话运行时都需要就绪。

检查两条关联的通话分支。核实已验证的目标、已启用的目的地、可用路由和适用的账户限制。

不能。路由记录的是所选的处理行为。通话状态和相关事件会告诉你该行为是否成功。

转接会在来电分支之外创建一条外呼分支。请参阅已发布的费率和通话的最终计费组成部分。

不需要。仪表板电话使用浏览器和已配置的 Bird SIP 中继线。

仪表板电话用于拨打外呼电话。请将来电路由到专门用于接听的电话系统或应用程序。

可以。使用键盘发送 DTMF 按键信号，例如 IVR 菜单或分机选择。

浏览器通话按语音通话承载和计费。请查看目的地的公开费率并检查最终通话记录。

不可以。Bird Voice 不支持紧急呼叫。

不会。录音是工作流中需要明确配置的环节。决定要捕获哪个支持的音源，以及何时开始和停止捕获。

音频捕获和语音转写是两个独立操作。在需要时请求转写，并检查其处理结果。

可以。语音处理可能在电话通话结束后才完成。请将通话结果与产物处理状态区分开来。

不是。一个会话可以关联多个通话分段，每个分段可能有各自的产物。请检查来源通话和捕获标识。

将其作为对话证据使用。在执行该操作的业务系统中确认预订、订单变更或付款。