语音验证通过拨打电话并朗读一次性验证码来完成验证:适用于固定电话用户、无法接收 SMS 的用户,以及短信未能送达时的备选方案。语音验证正作为可订购渠道逐步上线,纳入相同的按国家/地区计费方案,使用相同的电话号码,并通过相同的验证接口确认。
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, error } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();
if (error) throw error;
当短信无法触达时,语音渠道补位。
语音是 Bird Verify API 中电话类渠道之一:收件人使用相同的电话号码,语音作为可订购条目纳入按国家/地区计费方案,通常作为 SMS 之后的备选方案。仅有固定电话的用户、无障碍需求以及 SMS 送达率不佳的市场,正是语音验证码发挥价值的场景。
语音验证带来的价值。
作为现有计划中的渠道逐步推出。
- 01
语音合成播报验证码。
验证码通过电话朗读,因此无法阅读短信或没有短信功能的用户也能完成验证。
- 02
可触达固定电话。
语音可在无法接收 SMS 的线路上工作,无需单独集成即可扩大可验证用户范围。
- 03
天然的 SMS 备选方案。
在渠道计划中将语音排在 SMS 之后,随着基于送达状态的自动推进功能逐步推出,当短信未送达时,会话将自动转为电话呼叫。
- 04
相同的收件人,相同的调用。
使用相同的电话号码,调用相同的创建和校验端点。语音只是渠道不同,而非不同的 API。
- 05
相同的验证码保障。
服务端生成、哈希存储的验证码;可配置长度和有效期;按收件人校验,享有与其他渠道完全一致的安全保障。
语音是计划中的一个条目。
Once voice ships, it slots into the plan the same way any other channel does, and the create call stays the same. As delivery-driven advancement rolls out, the session moves to voice when the channel ahead of it doesn't complete.
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
// resolved channels today: [{ channel: "sms" }] — voice joins as it rolls out
备选机制如何运作。
将 SMS 排在第一位、语音排在第二位,单次验证将按顺序执行计划。首先尝试 SMS;如果未送达,会话将转为语音通话朗读验证码,且会话中的每个验证码均保持有效,用户可使用任何一个先到达的验证码。基于送达状态的自动推进功能正随送达状态一起逐步推出。
Verify 平台的更多功能
一套 API,一组密钥。探索其他功能。