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

国家按地区分组,并显示每个地区已启用国家数量的摘要和一张地图。每行显示国家、其生效的通道顺序、各通道使用的发送方,以及启用/禁用开关。可按状态、地区或通道筛选,也可按国家名称搜索。已禁用的国家会以灰色显示其已选通道,便于查看启用后会使用哪些通道。
开关用于启用或禁用整个国家。如果收件人的电话号码属于已禁用的国家,验证将无法解析到任何通道,创建会以 422 失败。同一收件人上的电子邮件地址不会绕过此限制。启用某个国家时,会保留其通道、顺序和发送方设置。已启用但未选择任何通道的国家会显示 No channels selected,在你于其路由设置面板中选择通道之前,该国的验证都会以 422 失败。
此页面上的更改不会立即保存。开关、地区上的 Enable all 和 Disable all,以及下文的批量操作都会汇总到页面底部的栏中,并显示未保存的更改数量。选择 Save changes 可一并应用这些更改,选择 Discard 则放弃。保存时要么应用全部更改,要么一项都不应用;如果保存会关闭某个国家或启用高风险目的地,系统会先要求确认。
拥有 Verify settings 的写入权限时,你可以一次更改多个国家。勾选这些国家的复选框,或勾选某个地区的复选框以选中该地区的所有国家。更改搜索或筛选条件时,已选内容会保留。选择操作前,请先核对已选数量:
- Status:为所选国家选择 Turn on 或 Turn off。
- Channels:每个通道会显示所选国家中有多少个使用该通道,所选国家设置不一致时,其开关显示为半开状态。打开或关闭某个通道,然后选择 Apply。未改动的通道会保留各国当前的设置,开关旁的撤销按钮可将其恢复原状。更改仅应用于提供该通道的所选国家。
- Channel order:将通道拖拽成 Bird 应尝试的顺序,然后选择 Apply。不提供某个通道的国家会跳过该通道。
开启某个通道时,也会开启所选国家中提供该通道的国家。发送方仍是各国的单独设置,需在路由设置面板中配置。
各国路由
点击国家名称可打开该国的路由设置面板:

- Channel order:拖拽通道以设置 Bird 在该国尝试的顺序,例如先 SMS 再 WhatsApp。验证会按列表依次尝试,直到某次发送成功。
- Per-channel enable:在不禁用整个国家的情况下关闭单个通道。Bird 未在某国开放的通道无法启用;平台按国家设定了该上限。语音通道默认关闭;如需在某国通过电话朗读验证码,请在此为该国开启语音通道。
- Per-channel sender:为该国的邮件、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 泵送欺诈会向你的业务未覆盖的国家的号码触发验证码发送,消耗账户余额。如果你的产品只服务于一组已知市场,请禁用其余国家。Verify 的平台上限提供了另一层限制,但已禁用的国家不会产生投递费用。