Harbor组织工作区生产环境沙盒
发送代理
API 密钥 · 客户运营团队ALAlex Lee 管理员权限已更新
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, error } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();
if (error) throw error;
您的账户
确认是您本人。
输入发送至以下号码的验证码
+1 ••• ••• 4567示例验证码
482691
验证码已验证
发送验证码，确认接收者身份。
当短信无法触达时，语音是能送达的渠道。
语音是 Bird Verify API 中的电话类渠道：收件人是相同的电话号码，语音作为按国家/地区计划中的可订购条目，通常作为 SMS 之后的备用渠道。固定电话用户、无障碍需求以及 SMS 送达率不佳的市场，正是语音验证码发挥作用的场景。
语音验证带来了什么。
即将作为现有计划中的渠道上线。
- 01
语音合成的验证码。
验证码在通话中被朗读出来，因此无法阅读短信或没有短信功能的用户也能完成验证。
- 02
可触达固定电话。
语音适用于无法接收 SMS 的线路，无需单独集成即可扩大可验证的用户范围。
- 03
天然的 SMS 备用方案。
在渠道计划中将语音排在 SMS 之后，这样当基于送达率的自动推进上线后，短信未送达时会话会自动转为电话呼叫。
- 04
相同的收件人，相同的调用。
使用相同的电话号码，调用相同的创建和检查端点。语音只是渠道不同，而非不同的 API。
- 05
相同的验证码安全保障。
服务端生成的哈希验证码；可配置长度和有效期；按收件人检查，具备其他渠道提供的所有安全保障。
语音是计划中的一个条目。
语音上线后，将以与其他渠道相同的方式加入计划，创建调用保持不变。当基于送达率的自动推进上线后，如果前序渠道未完成，会话会自动转至语音。
voice-otp.ts
rolling out
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
// resolved channels today: [{ channel: "sms" }] — voice joins as it rolls out
备用机制如何运作。
将 SMS 排在第一位、语音排在第二位，单次验证会按顺序执行计划。先尝试 SMS；如果未送达，会话转为语音通话朗读验证码，且会话中的每个验证码都保持有效，用户可以使用先到达的那个。该自动推进已在当前上线的渠道中生效：失败的渠道会推进会话，每次尝试的送达计时器在未收到送达状态时也会推进。语音上线后将作为可订购渠道加入计划。
规模扩展
不失控。
在工作区中组织团队，控制 API 访问权限，通过审计日志追踪变更。
Harbor组织有效
审计日志
生产环境- 工作区
- 生产环境
- 资源
- 发送代理
- 读取权限读写
团队 客户运营操作者角色 管理员结果 成功时间 9 月 22 日，09:42:18 UTC
成功