Telegram 上的手机号验证如何运作
Telegram 机器人看不到发送者的手机号,因此在这里验证号码的方式与 WhatsApp 不同。本文介绍完整流程、背后的校验,以及返回给您应用的结果。
WhatsApp 是 Phone-Verif 的第一个渠道,但并非所有人都在那里。Telegram 现已成为第二个渠道:同一套 API,同样的结果,并且默认开启。底层机制并不相同,在提供之前值得先了解清楚。
在 WhatsApp 上,证明来自用户发出的一条消息:它从用户自己的号码发出,这正是 Reverse OTP 的思路。而 Telegram 机器人没有这样的信号。它通过数字账号 ID 识别用户,除非用户主动分享,否则手机号始终保持私密。因此机器人只能主动询问,证明也必须来自发送者之外的其他途径。
用户需要做什么
无需查看或输入验证码,整个流程只需在 Telegram 内点击两次。
1. 打开链接
您的页面会显示二维码或按钮,二者都指向我们的机器人,链接中携带会话令牌。
2. 点击 Start
点击 Start 后,该令牌会交给机器人,机器人将此 Telegram 账号与会话绑定。
3. 分享号码
机器人会显示唯一的按钮“分享我的手机号”。点击后,将发送 Telegram 为该账号生成的联系人名片。
4. 完成
机器人确认后,会话变为已验证状态,您的应用将收到 webhook 和状态结果。
为什么分享的联系人可以作为证明
任何人都可以向机器人发送一串数字,因此手动输入的号码会被直接拒绝:机器人会再次显示该按钮。只有联系人名片会被读取,并且必须通过四项校验,会话才能完成。
必须是用户本人的联系人
名片上的用户 ID 与发送它的账号一致。通讯录里他人的名片会在这一步被拒绝。
必须来自正确的账号
发送者必须是在此会话中点击 Start 的账号,因此名片无法用来完成他人发起的会话。
不能是转发的
从其他聊天转发而来的名片会被拒绝,即使那恰好是发送者本人的名片。
必须是新发送的
名片必须在会话开启之后发送,因此旧名片无法被重放。
任何一项校验未通过的名片都不会产生任何变化:机器人会再次询问,会话保持开启。黑名单中的号码在 Telegram 上同样会被拒绝,与 WhatsApp 上一样。
每个会话只会完成一次
连续点击按钮两次会发出两张联系人名片,重试投递也可能把同一张发送两次。因此,完成会话的操作以原子方式认领:只有一张名片生效,只会产生一个结果、一次 webhook,并且只消耗一个积分。
此外,一个会话只能在一个渠道上完成。默认情况下,会话同时向 WhatsApp、短信和机器人开放,一旦其中之一完成,其他渠道就会拒绝其令牌。锁定到 Telegram 或 WhatsApp 的会话从一开始就会拒绝另一渠道。对任何令牌,机器人链接的跳转行为都相同,因此无法借此探测哪些令牌仍然有效。
一个号码,一个身份
Telegram 和 WhatsApp 对手机号的书写格式不同,因此在其他处理之前,号码会先规范化为统一格式。这一点很重要,因为身份是以号码为键值的。
今天通过 WhatsApp 验证、明天通过 Telegram 验证的用户,会得到同一个 user_id。他们是同一个用户,而不是两个,flow=login 也会据此报告 is_new_user。
我们自己也依赖这一点。在我们自己的登录页面上,Telegram Connect 和 WhatsApp Connect 对同一个号码会进入同一个账号,无论用户先使用的是哪一个。
返回的内容
您的集成读取的状态响应和收到的 webhook 与 WhatsApp 相同,一次验证消耗的积分也相同。phone、login 和 2fa 流程均可使用。
只增加了一项内容。在 flow=phone 下,已验证的 Telegram 会话还会携带一个 telegram 对象,其中包含该账号的 user_id、username、first_name 和 last_name。登录和 2FA 不包含此对象:它们只返回用户 ID 或匹配结果,因为用户名与手机号一样,同样能识别出这个人。
它不能证明什么
已验证的会话只表明这个 Telegram 账号持有这个号码,并不说明现在是谁持有这张 SIM 卡。这是所有基于账号的渠道共有的局限,正如 SIM 卡劫持一文所解释的那样。
所有权校验还取决于 Telegram 在联系人名片上报告的用户 ID。Telegram 的 Bot API 文档没有说明该字段是如何填充的,所以在这里您信任的是平台本身,就像信任 WhatsApp 上的发送者号码一样。
此外还有一些实际限制。用户需要使用 Telegram,而且锁定到 Telegram 的会话没有短信回退。
如何接入
会话默认向 Telegram 开放,因此无需添加任何参数。发送 provider=telegram 可将会话锁定到机器人,发送 provider=whatsapp 则可排除机器人。
curl -X POST "https://api.phone-verif.com/start-verification" \
-H "X-API-Key: $PHONE_VERIF_API_KEY"除非 Telegram 不可用,响应中会在 whatsapp 和 sms 之外包含 telegram 区块。将 qr_code_url 编码到二维码中,并在移动端按钮上使用 direct_link。
{
"whatsapp": { "...": "..." },
"sms": { "...": "..." },
"telegram": {
"qr_code_url": "https://t.phone-verif.com/tg/<token>",
"direct_link": "https://t.me/PhoneVerif_com_bot?start=<token>"
}
}无需账号即可在 Telegram 演示中体验。完整的 API 请参阅集成指南。