拨打您的第一个电话

从控制面板拨打一个真实的电话。控制面板中的电话是一个 SIP 客户端，使用与您的电话系统相同的 trunk、来电显示和目的地设置。

通话结束后，您可以在控制面板中或通过 Voice API 查看其记录。

前提条件

开始之前，请确保您已具备以下条件：

• 一个在 Voice 下显示 Phone 的工作区。当您的工作区所在区域支持浏览器呼叫且您拥有 voice:write 和 voice_management:read 权限时，控制面板会显示该选项。
• 一个您拥有的电话号码，以及一部能接听验证电话和测试电话的手机。
• 一个带有可用麦克风的浏览器。

1. 打开电话

在控制面板中选择 Voice > Phone。电话会在浮动窗口中打开，并在您浏览时保持打开状态。

如果您的工作区尚未准备好拨打电话，电话会显示 Finish setup to place calls。其检查清单会列出每个缺失的要求，并链接到相应的操作。创建一个可呼叫的 trunk 并验证来电显示号码即可完成检查清单。

2. 创建可呼叫的 trunk

从检查清单中选择 Create a trunk。输入名称，然后选择 Create trunk。

控制面板在创建 trunk 时会启用外呼功能和会话凭证。该 trunk 还提供浏览器使用的 MD5 摘要。检查清单会将所有 trunk 要求标记为已完成。

3. 验证您的来电显示号码

从检查清单中选择 Verify a number you own。在 Phone number 字段中以 E.164 格式输入您拥有的号码：前导 +、国家代码和国内号码。然后选择 Send verification call。

接听验证电话并听取六位数验证码。在 Verification code 字段中输入验证码，然后选择 Verify caller ID。

控制面板显示 Caller ID verified，移除设置提示，并将该号码添加到电话的 From 行。

4. 启用目的地国家

打开 Voice > Destinations。找到您要呼叫的国家并开启其开关。

拨打到已禁用国家的电话会在平台拨号给运营商之前被拒绝。

5. 拨打电话

在 To 行中输入您已验证的号码，然后选择 Call。如果浏览器请求麦克风权限，请允许。

您的手机响铃并显示已验证的来电显示号码。接听电话并确认双向音频正常。要从控制面板结束通话，请选择 Hang up。

6. 查看通话记录

打开 Voice > Legs。该页面按开始时间降序排列通话，因此您的通话会出现在第一行。选择它可查看接听时间、计费时长以及费率计算完成后的费用。

相同的通话记录也可通过 API 获取：

for await (const leg of bird.voice.legs.list()) {
  console.log(leg.id, leg.status);
}

for leg in client.voice.legs.list():
    print(leg.id, leg.status)

for leg, err := range client.Voice.Legs.List(context.Background(), bird.VoiceLegsListParams{}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(leg.Id, leg.Status)
}

foreach ($bird->voice->legs->list() as $leg) {
    echo $leg->getId(), ' ', $leg->getStatus(), "\n";
}

bird voice legs list

curl -X GET "https://{region}.platform.bird.com/v1/voice/legs" \
  -H "Authorization: Bearer $TOKEN" \
  --url-query "limit=25"

使用通话记录排查未来的呼叫失败。被拒绝的通话会将原因存储在 rejection_reason 中。有关控制面板筛选器、记录字段和 API 访问方式，请参阅通话日志指南。

排查测试电话问题

• 电话仍显示 Finish setup to place calls：使用检查清单中每行的链接完成每个未勾选的要求。
• 电话显示拒绝原因：destination_not_enabled 表示目的地国家已禁用。caller_id_not_verified 表示 From 行中的号码未验证。被拒绝通话参考涵盖了每种原因及其解决方法。
• 通话已连接，但一方没有音频：检查浏览器的麦克风权限以及电话中的麦克风选择器。通话中控制指南介绍了设备选择器。

Voice 故障排查针对任何客户端都适用于相同的症状。

后续步骤

• 从终端测试通话：使用 bird voice tools test-call 拨打相同的电话。
• 设置 SIP 客户端：将 Asterisk、FreePBX、Zoiper 或其他客户端连接到 trunk。
• 配置 SIP trunk：查看可呼叫 trunk 启用的设置及其他准入方式。
• 拨打电话：了解平台如何路由和计价通话。
• 查看通话日志：筛选记录、查看字段、通过 API 检索通话或导出 CSV 数据。
• 订阅语音事件：将通话结果发送到您的系统，而非轮询。