电话验证 API：OTP、短信与 WhatsApp

Didit 的电话验证提供了一种通过一次性验证码（OTP）验证用户电话号码的可靠方法。该功能为您的身份验证流程增加了一层关键的安全保障，确保用户联系信息真实有效。 在关于解读验证结果的 Academy 课程中，8:08 章节介绍了电话验证和重复检测。

​

工作原理

我们的电话验证解决方案通过简单易用的流程提供全面的电话号码验证。系统将 OTP 验证与高级风险评估相结合，提供大规模可靠的电话验证。

​

验证功能

我们的电话验证服务提供多项核心功能，以增强您的验证流程：

​

OTP 验证

• 安全代码生成：随机生成的一次性验证码
• SMS 投递：快速且可靠地投递至移动设备
• 可配置的超时时间：根据您的安全要求设置过期时间
• 重试选项：允许用户请求新验证码，并配有恰当的速率限制
• 品牌化验证码：SMS 验证码会指明您的品牌，而非发送通用消息，无需额外费用。参见品牌化验证消息。
• 您自己的 WhatsApp 号码：WhatsApp 验证码可以来自您自己的 WhatsApp Business 号码。参见通过您自己的号码发送 WhatsApp 验证码。

​

品牌化验证消息

SMS 验证码可以注明您的品牌，以便用户认出消息来自您：

123456 是您用于 Acme Bank 的验证码

仅品牌名称可自定义。 其余措辞是在各国家/地区移动运营商处登记的标准文本，可防止验证码被作为垃圾短信拦截，并且已翻译为收件人的语言。 品牌化功能是免费的：品牌化验证码与非品牌化验证码的费用相同。 在 Business Console 中设置您的 SMS 发送方名称，路径为工作流的 Phone Verification → Settings 或 White Label → SMS 下。 它属于您的应用，而非归属于单个工作流：它会为您应用发送的每条 SMS 验证码署名，涵盖所有工作流以及通过独立 API 发送的验证码，无论是否开启白标自定义。 验证码采用哪个名称，遵循首个匹配优先原则：

1. POST /v3/phone/send/ 上的 options.sms_sender_name，针对该单条验证码生效。
2. 您的应用的 SMS 发送方名称。
3. 仅在白标发送时（包含白标自定义的工作流，或在 API 上设置了 options.use_white_label_customization: true），使用您的白标公开名称。
4. 否则，验证码发送时不带名称。

发送方名称长度为 1 到 30 个字符：仅限字母、数字、空格和 ’ & - !，且不能全为数字，单词之间使用单个空格。 若名称超出这些规则，API 将在发送任何验证码之前拒绝并返回 400。

• 渠道：该名称会添加到 SMS 消息中，包括作为其他渠道备选方案而发送的 SMS。WhatsApp 验证码使用固定文本发送，不携带该名称；若希望在其上显示您的企业名称，请通过您自己的号码发送。
• 每日变更次数：每个应用每天（UTC 时间）最多可以开始使用两个新名称，同时计入新的发送方名称和新的 sms_sender_name 值。达到上限后，验证码将保留应用当前的名称直至次日，且按请求传入的新名称将以应用的当前名称发送。您之前使用过的名称不会重复计入。
• 投递优先：品牌化问题绝不会阻断验证码发送。如果无法应用某个名称，验证码将使用应用的名称发送，或者不带名称发送。

​

编写您自己的 SMS 文本和发送方 ID

您可以替换 SMS 验证码的文本以及用户看到的发送方。 在 Business Console 的 White Label → SMS 下配置这两项。 与 SMS 发送方名称一样，它们归属于您的应用，并适用于其发送的每条 SMS 验证码，涵盖所有工作流以及通过独立 API 发送的验证码。 您自己的文本按语言分别编写。 当您为发送验证码所用的语言编写了文本时，验证码将采用您的文本发送；所有其他语言则保留 Didit 的翻译文本。 使用 {code} 表示验证码，可选择使用 {brand} 表示您的 SMS 发送方名称，例如 Acme: {code} is your login code for {brand}. 文本必须满足以下要求：

• 包含 {code} 且仅出现一次，不得包含除 {code} 和 {brand} 之外的任何占位符；
• 不得包含链接：运营商会拦截携带链接的验证码；
• 在包含 8 位验证码和 30 个字符名称的情况下，可容纳于单条 SMS 中：最多 160 个字符，若包含基本拉丁字母以外的字符（例如西里尔字母、阿拉伯字母或表情符号），则最多 70 个字符。

您自己的发送方 ID 长度为 3 到 11 个字符，仅使用字母、数字和空格，且不能全为数字，例如 AcmeBank。 它会在 Didit 启用了自定义发送方 ID 的国家/地区使用，这些国家/地区的运营商无需预先登记即可接受发送方名称；在所有其他国家/地区，您的验证码将以 Didit 的发送方发出。 如需申请需要登记发送方的国家/地区，请联系支持团队。

• 投递优先：当验证码在无法承载您的文本或发送方 ID 的路由上重试发送时，它将采用 Didit 的文本发送，并附带您的 SMS 发送方名称及 Didit 的发送方，以确保验证码始终能成功送达。

​

通过您自己的号码发送 WhatsApp 验证码

默认情况下，WhatsApp 验证码来自 Didit 的 WhatsApp Business 号码。 您可以改为连接您自己的 WhatsApp Business 号码，以便用户接收来自您的企业名称和号码的验证码。 在 Business Console 中连接号码，路径为工作流的 Phone Verification → Settings → WhatsApp number，然后选择 Connect WhatsApp number。 系统会打开登录窗口：登录管理您 WhatsApp Business 号码的企业账户，然后选择 WhatsApp Business 账户及用于发送的号码。 随后，Didit 会登记该号码用于发送，并创建其验证消息。 编辑该验证消息需要具备与编辑 SMS 发送方名称相同的自定义配置编辑权限。 该号码属于您的应用，而非归属于单个工作流：连接成功后，它将发送该应用发送的每一条 WhatsApp 验证码，涵盖所有工作流以及通过独立 API 发送的验证码。

• 批准：新的验证消息需要获得批准后该号码才能发送验证码，通常在几分钟内完成。在此之前，卡片会显示该号码处于等待批准状态，期间验证码将继续通过 Didit 的号码发出。
• 消息文本：WhatsApp 上的验证消息使用您用户对应语言的标准文本：包含验证码、安全提示和复制按钮。该文本无法编辑，但发送方显示为您的企业。
• 投递：若验证码无法在 WhatsApp 上投递，将通过 SMS 发送，并以您的 SMS 发送方名称署名。
• 计费：您的号码发送的消息费用将计入您的 WhatsApp Business 账户，因此 Didit 仅对这些验证码收取验证费（$0.02）。通过 SMS 发送的验证码则照常计费。
• 需要处理：若该号码无法继续发送（例如其访问权限已从您的企业账户中移除），验证码将重新通过 Didit 的号码发出，卡片会提示您重新连接该号码。
• 可随时在同一卡片中断开。验证码将重新通过 Didit 的号码发出；该号码及其验证消息将保留在您的 WhatsApp Business 账户中。

​

电话号码分析

• 格式验证：确保电话号码符合正确的国际格式
• 运营商检测：识别与该号码关联的电信运营商
• 号码类型：区分移动电话、座机和 VoIP 号码
• 国家/地区验证：核验电话号码是否符合预期的国家/地区格式

​

风险评估

• 临时号码检测：识别用于逃避追踪的临时号码
• 虚拟号码识别：标记可能属于虚拟或基于 VoIP 的号码
• 活动监控：追踪多次验证尝试中的可疑模式
• 黑名单检查：对照内部曾被滥用的号码名单进行核对

​

定价

电话验证按每条已发送消息计费，采用透明的按量付费模式： 您的套餐折扣仅适用于 $0.02 的 Didit 费用；运营商费用按成本直接转嫁，不享受任何折扣。请参阅折扣。 我们支持多种投递渠道，费用各不相同（可用性因国家/地区而异）： → 电话验证定价