语音验证通过拨打电话并朗读一次性验证码来完成验证——适用于固定电话、无法接收 SMS 的用户，以及短信未送达时的备选方案。它正在作为同一按国家/地区计划中的可订购渠道逐步推出，使用相同的电话号码，并通过相同的校验接口确认。
verify.ts
200 · pending
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
// Send the code, then check it by recipient.
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
const { data } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();当短信无法触达时，语音渠道补位。
语音是 Bird Verify API 上的电话系列渠道：收件人是同一个电话号码，语音成为按国家/地区计划中的一个可订购条目——通常作为 SMS 之后的备选。固定电话用户、无障碍需求以及 SMS 送达率不佳的市场，正是语音验证码发挥价值的地方。
语音验证带来的价值。
作为现有计划中的渠道逐步推出。
- 01
语音合成播报验证码。
验证码通过电话朗读，因此无法阅读短信或没有短信功能的用户也能完成验证。
- 02
可触达固定电话。
语音可在无法接收 SMS 的线路上工作，无需单独集成即可扩大可验证用户范围。
- 03
天然的 SMS 备选方案。
在渠道计划中将语音排在 SMS 之后，随着基于送达状态的自动推进功能逐步推出，当短信未送达时，会话将自动转为电话呼叫。
- 04
相同的收件人，相同的调用。
使用相同的电话号码，调用相同的创建和校验端点。语音只是渠道不同，而非不同的 API。
- 05
相同的验证码保障。
服务端生成、哈希存储的验证码；可配置长度和有效期；按收件人校验，享有与其他渠道完全一致的安全保障。
语音是计划中的一个条目。
在配置中将语音排在 SMS 之后，创建调用无需更改。随着基于送达状态的自动推进功能逐步推出，当前面的渠道未完成时，会话将自动使用语音。
voice-otp.ts
rolling out
await bird.verify.verifications.create({
configuration_id: "vfc_login",
to: { phone_number: "+15551234567" },
}).safe();
// resolved channels: [{ channel: "sms" }, { channel: "voice" }]备选机制如何运作。
将 SMS 排在第一位、语音排在第二位，单次验证将按顺序执行计划。首先尝试 SMS；如果未送达，会话将转为语音通话朗读验证码，且会话中的每个验证码均保持有效，用户可使用任何一个先到达的验证码。基于送达状态的自动推进功能正随送达状态一起逐步推出。
语音 OTP 常见问题
语音验证现在可以使用吗？+
正在逐步推出中。电子邮件、SMS 和 WhatsApp 验证现已可用；语音将作为同一按国家/地区计划中的额外可订购渠道上线，创建和校验调用无需更改。
什么时候应该使用语音 OTP？+
语音可触达固定电话和无法接收 SMS 的用户，当短信未送达时也是强有力的备选方案。对于无法阅读屏幕上验证码的用户，语音也是更具无障碍性的选择。
语音如何与 SMS 配合？+
两者都是通过同一号码寻址的电话系列渠道。在渠道计划中排列它们的顺序（通常 SMS 在前，语音作为备选），单次验证即可在两者之间切换，会话中的每个验证码均保持有效。
我的用户会看到验证码来自谁？+
Authifly，Bird 的验证品牌。它是用户收到的每个验证码上显示的身份标识：邮件来自 otp@verify.authifly.com 或您自己的已验证域名，SMS 和 WhatsApp 均以 Authifly 品牌发送。authifly.com 是一个公开页面，向收件人保证 Authifly 代表企业发送合法的一次性验证码。Bird 是您构建应用的平台；Authifly 是收件人看到的品牌。