WhatsApp 验证将验证码作为身份验证模板消息发送到用户的 WhatsApp 账户——内容丰富、带有 Authifly 品牌标识，并通过用户已在使用的应用送达。它是同一按国家/地区计划中的可排序渠道，因此一次验证可以优先使用 WhatsApp，同时将 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();计划中的一个渠道，而非新的集成。
WhatsApp 是 Bird Verify API 上的一个电话系列渠道：接收方是同一个电话号码，创建和验证调用不变，WhatsApp 只是按国家/地区渠道计划中的一个可排序条目。在转化效果好的地方将其排在 SMS 之前，其他地方则保持 SMS 优先。
WhatsApp 验证带来了什么。
按国家/地区计划中的可排序渠道。
- 01
身份验证模板消息送达。
验证码以 WhatsApp 身份验证模板消息的格式发送——这是平台专门为一次性验证码保留的格式。
- 02
相同的接收方，相同的调用。
使用相同的电话号码，调用相同的创建和验证端点。WhatsApp 是渠道，而非不同的 API。
- 03
按国家/地区可排序。
在 WhatsApp 效果最佳的国家/地区，将其排在 SMS 之前；其余地区保持 SMS 优先。
- 04
SMS 作为备选保留。
电话号码目标携带其完整的电话系列计划，因此 SMS 排在 WhatsApp 之后。随着基于送达的自动推进功能上线，WhatsApp 优先的验证会在同一会话中自动切换到 SMS。
- 05
相同的验证码安全保障。
验证码通过加密随机源生成，仅以 HMAC 形式存储；长度和有效期可配置；按接收方进行验证。WhatsApp 继承了其他渠道的所有安全保障。
优先使用 WhatsApp，SMS 紧随其后。
渠道顺序在配置中设定，因此选择 WhatsApp 优先只需更改配置，无需更改代码。创建调用保持不变。
whatsapp-otp.ts
200
await bird.verify.verifications.create({
configuration_id: "vfc_login",
to: { phone_number: "+15551234567" },
}).safe();
// resolved channels: [{ channel: "whatsapp" }, { channel: "sms" }]WhatsApp OTP 常见问题
WhatsApp 验证现在可用吗？+
是的。WhatsApp 作为首发渠道与电子邮件和 SMS 一同推出——在按国家/地区计划中作为可排序条目，创建和验证调用无需更改。语音是目前仍在逐步推出的渠道。
为什么选择 WhatsApp 验证而不是 SMS？+
WhatsApp 身份验证模板消息带有品牌标识，并在许多用户日常使用的应用中送达。在 WhatsApp 使用率高的市场，将其排在 SMS 之前，可以在用户偏好的渠道上触达他们，同时 SMS 仍作为备选。
如果用户没有 WhatsApp 怎么办？+
电话号码目标携带其完整的电话系列渠道计划，因此 SMS 排在 WhatsApp 之后。随着基于送达的自动推进功能上线，WhatsApp 优先的验证会在同一会话中切换到 SMS，且该会话中的每个验证码在验证通过、过期或用完尝试次数之前都保持有效。
用户看到验证码来自谁？+
Authifly，Bird 的验证品牌。它是用户收到的每个验证码上的身份标识：电子邮件来自 otp@verify.authifly.com 或您自己的已验证域名，SMS 和 WhatsApp 均带有 Authifly 品牌。authifly.com 是一个公开页面，向收件人说明 Authifly 代表企业发送合法的一次性验证码。Bird 是您构建应用的平台；Authifly 是收件人看到的品牌。