Skip to content
技术
阅读约 6 分钟2026年11月6日

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 请参阅集成指南。