Sign inGet Started

国家配置

当你验证一个电话号码时,目的地国家决定了验证码的传递方式:该国可用哪些通道、优先尝试哪个通道、是否允许验证,以及消息默认使用哪种语言。Countries 页面用于管理这些设置,每个国家一行。纯邮件收件人不受此影响:电子邮件地址没有国家属性,因此国家配置仅适用于收件人包含电话号码的验证。

默认情况下,所有国家均已启用并使用 Bird 的平台路由。你可以在此页面关闭不提供服务的国家、调整通道顺序或固定各国的发送方。禁用未使用的目的地还能降低遭受 SMS pumping 的风险。

Countries 页面

Countries 页面,按行列出国家及其通道顺序、发送方和启用开关

每行显示国家、其生效的通道顺序、各通道使用的发送方,以及启用/禁用开关。可按状态或通道筛选,也可按国家名称搜索。已禁用的国家仍以灰色显示其通道顺序,便于查看重新启用后恢复的配置。

开关用于启用或禁用整个国家。如果收件人的电话号码属于已禁用的国家,验证将无法解析到任何通道,创建会以 422 失败。同一收件人上的电子邮件地址不会绕过此限制。重新启用时会清除禁用标记而非固定为 "on",因此该国将恢复使用 Bird 的平台路由。通道顺序和发送方的固定设置在开关切换后保留。

各国路由

点击某行可打开该国的路由设置面板:

国家路由设置面板,包含可拖拽排序的通道、各通道发送方和启用开关

  • 通道顺序:拖拽通道以设置 Bird 在该国尝试的顺序,例如先 SMS 再 WhatsApp。验证会按列表依次尝试,直到某次发送成功。
  • 单通道启用:在不禁用整个国家的情况下关闭单个通道。Bird 未在某国开放的通道无法启用;平台按国家设定了该上限。
  • 每通道发送方:为该国家/地区的邮件、SMS 或 WhatsApp 选择发送方。可以继承配置默认值、选择 Bird 托管的身份,也可以使用已验证的邮件域名、SMS Sender ID,或已连接且拥有已批准身份验证模板的 WhatsApp 号码。每国家/地区的选择优先于配置默认值。国家/地区专属的 SMS Sender ID 不使用默认发送方回退。

WhatsApp 无法发送验证码的地区

Bird 的共享 WhatsApp 发送方无法向埃及、印度、印度尼西亚、马来西亚、尼日利亚、巴基斯坦、沙特阿拉伯、南非或阿联酋发送验证码。WhatsApp 仍会出现在这些国家的通道顺序中,你也可以将其移至顶部,但当 Verify 执行到该通道时发送会被拒绝,验证将继续尝试列表中的下一个通道。

被拒绝的尝试与其他失败一样被记录,原因为 channel_restricted,因此 verify.attempt.undelivered 事件会说明 WhatsApp 未能送达的原因。参见事件与 Webhook。

请确保在这些国家至少启用一个其他通道。如果验证的唯一通道是 WhatsApp,则没有后续通道可继续,创建会以 422 失败。

为什么要禁用国家

SMS pumping 攻击会向你的业务未覆盖的国家的号码触发验证码发送,消耗账户余额。如果你的产品只服务于一组已知市场,请禁用其余国家。Verify 的平台上限提供了另一层限制,但已禁用的国家不会产生投递费用。

后续步骤

页面涵盖内容
发送方与品牌定制共享和品牌发送方,以及验证码消息的外观
发送验证发送和校验调用、按请求的通道覆盖和限制
Verify 概览章节索引及验证的工作原理