语音 OTP
逐步推出中一个可以听到的验证码, 专为 SMS 无法触达的用户而生。
语音验证通过拨打电话并朗读一次性验证码来完成验证:适用于固定电话用户、无法接收 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;
Your account
Confirm it’s you.
Enter the code sent to
+1 ••• ••• 4567Example verification code
深受构建世界级软件团队的日常信赖
查看更多客户故事当短信无法触达时,语音渠道补位。
语音是 Bird Verify API 中电话类渠道之一:收件人使用相同的电话号码,语音作为可订购条目纳入按国家/地区计费方案,通常作为 SMS 之后的备选方案。仅有固定电话的用户、无障碍需求以及 SMS 送达率不佳的市场,正是语音验证码发挥价值的场景。
语音验证带来的价值。
作为现有计划中的渠道逐步推出。
- 01
语音合成播报验证码。
验证码通过电话朗读,因此无法阅读短信或没有短信功能的用户也能完成验证。
- 02
可触达固定电话。
语音可在无法接收 SMS 的线路上工作,无需单独集成即可扩大可验证用户范围。
- 03
天然的 SMS 备选方案。
在渠道计划中将语音排在 SMS 之后,随着基于送达状态的自动推进功能逐步推出,当短信未送达时,会话将自动转为电话呼叫。
- 04
相同的收件人,相同的调用。
使用相同的电话号码,调用相同的创建和校验端点。语音只是渠道不同,而非不同的 API。
- 05
相同的验证码保障。
服务端生成、哈希存储的验证码;可配置长度和有效期;按收件人校验,享有与其他渠道完全一致的安全保障。
语音是计划中的一个条目。
语音功能上线后,它会像其他渠道一样纳入验证计划,创建调用方式保持不变。当基于送达状态的自动推进机制启用后,如果排在前面的渠道未能完成送达,会话将自动切换到语音渠道。
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
// resolved channels today: [{ channel: "sms" }] — voice joins as it rolls out
备选机制如何运作。
将 SMS 设为第一顺位、语音设为第二顺位,一次验证即可按顺序执行整个计划。系统先尝试 SMS;如果未送达,会话将切换为语音通话,向用户朗读验证码。会话中的每个验证码均保持有效,用户可以使用最先收到的那个。这种自动推进机制已在当前上线的渠道中生效:渠道发送失败时会话自动前进,每次尝试的送达计时器在未收到送达状态时也会推动会话前进。语音将在上线后作为可选渠道加入验证计划。
触达每位用户,通过最有效的渠道。
语音与邮件、SMS 和 WhatsApp 一同作为渠道纳入相同的按国家/地区计费方案,在同一组端点上提供语音备选验证。