国家配置
当你验证一个电话号码时,目的地国家决定了验证码的传递方式:该国可用哪些通道、优先尝试哪个通道、是否允许验证,以及消息默认使用哪种语言。Countries 页面用于管理这些设置,每个国家一行。纯邮件收件人不受此影响:电子邮件地址没有国家属性,因此国家配置仅适用于收件人包含电话号码的验证。
默认情况下,所有国家均已启用并使用 Bird 的平台路由。你可以在此页面关闭不提供服务的国家、调整通道顺序或固定各国的发送方。禁用未使用的目的地还能降低遭受 SMS pumping 的风险。
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 的平台上限提供了另一层限制,但已禁用的国家不会产生投递费用。