拨打您的第一个电话

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

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

前提条件

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

一个在 Voice 下显示 Phone 的工作区。当您的工作区所在区域支持浏览器呼叫且您拥有 Write 级别的 Voice 访问权限时，控制台会显示该选项。
一个您拥有的电话号码，以及一部能够接听验证和测试电话的手机。
一个麦克风正常工作的浏览器。

1. 打开电话

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

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

2. 创建可用于呼叫的中继

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

控制台在创建中继时会启用出站呼叫和会话凭据。该中继还会提供浏览器使用的 MD5 摘要。检查清单会将所有中继要求标记为已完成。

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 > Calls。页面按开始时间排列通话，最新的在前，因此您的通话会出现在第一行。选择该记录以查看接听时间、计费时长以及费率计算完成后的费用。

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

for await (const call of bird.voice.list({ status: ["ringing", "in_progress"] })) {
  console.log(call.id, call.status);
}

for call in client.voice.list(status=["ringing", "in_progress"]):
    print(call.id, call.status)

for call, err := range client.Voice.List(context.Background(), bird.VoiceListParams{
	Status: []bird.VoiceCallStatus{"ringing", "in_progress"},
}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(call.Id, call.Status)
}

foreach ($bird->voice->list(['status' => ['ringing', 'in_progress']]) as $call) {
    echo $call->getId(), ' ', $call->getStatus(), "\n";
}

bird voice list

{
  "name": "voice_list"
}

curl -X GET "https://{region}.platform.bird.com/v1/voice/calls" \
  -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 或其他客户端连接到中继。
配置 SIP 中继：查看可用于呼叫的中继启用的设置以及其他准入方式。
拨打电话：了解平台如何路由和计价通话。
查看通话日志：筛选记录、查看字段、通过 API 检索通话或导出 CSV 数据。
订阅语音事件：将通话结果发送到您的系统，无需轮询。

相关资源