Telegram Gateway API 是什么,如何用它发送验证码?

Telegram Gateway API 是 Telegram 官方提供的三种开发者接口之一，用途很明确：让企业、应用或网站把原本通过传统短信发送的授权码（验证码），改为通过 Telegram 发送。它适合已经有用户使用 Telegram、希望降低短信成本并提升送达速度的业务方。根据 core.telegram.org 的说明，用户会在 Telegram 内的一个专用聊天里即时收到验证码消息，而不是收到一条短信。

三种 Telegram API 的分工

要理解 Gateway API 的定位，先看它和另外两种接口的区别：

三者可以免费使用（官网原文为 "You are welcome to use both APIs free of charge"，指 Bot API 与 Telegram API/TDLib）。Gateway API 的说明段落被截断，其计费细节在现有资料中未完整给出，因此不能直接推断它同样免费——实际使用前应以官方页面为准。

Gateway API 解决什么问题

传统短信验证码有三个常见痛点：按条计费导致成本随规模上升、跨运营商送达存在延迟或丢失、以及短信本身容易被拦截或伪造。

Gateway API 的思路是把验证码投递到用户已有的 Telegram 账号里。官网给出的价值点包括：

• 降低成本：相比传统短信，发送方式更省
• 提升安全性：验证码走 Telegram 通道
• 提升送达速度：用户即时收到
• 覆盖面：Telegram 月活用户规模达 10 亿（官网表述为 "1 billion monthly active users"）

用户侧的体验差异也很直接：验证码不是出现在手机短信收件箱，而是出现在 Telegram 内一个专门的聊天中，打开 Telegram 就能看到。

用它发送验证码的基本流程

官网资料只给出了用途和用户侧体验，没有提供完整的接入步骤和接口字段。因此这里只描述可确认的流程框架，具体参数需查阅官方文档：

1. 确认业务场景：你的应用或网站需要一个向用户发送授权码的环节，且目标用户中有相当比例使用 Telegram。
2. 接入 Gateway API：作为企业、应用或网站接入该接口（官网表述为 "allows any business, app or website to send authorization codes through Telegram"）。
3. 触发发送：在用户需要验证身份时，由你的系统发起验证码发送请求。
4. 用户接收：用户在 Telegram 的专用聊天中即时收到包含验证码的消息。
5. 用户回填：用户把验证码填回你的应用或网站完成验证。

需要提醒的是，第 2、3 步的具体接口地址、鉴权方式和请求格式，现有资料未涉及，接入时应以 core.telegram.org 的 Gateway API 文档为准。

什么时候该选它，什么时候不该

适合考虑 Gateway API 的情况：

• 目标用户群体中 Telegram 使用率高
• 短信成本在整体支出中占比明显
• 对验证码送达速度和到达率有较高要求

需要谨慎的情况：

• 用户群体基本不用 Telegram——验证码发出去也没人收得到
• 业务要求验证码必须走电信通道（例如某些合规或风控要求）
• 需要先确认 Gateway API 的实际计费方式，现有资料未给出完整价格信息

一个务实的做法是把它作为短信的补充通道而非唯一通道：对已绑定 Telegram 的用户优先走 Telegram，其余用户仍走短信，这样既拿到成本和速度收益，又不牺牲覆盖率。

常见卡点

• 把 Gateway API 和 Bot API 混为一谈：Bot API 是用来做机器人的，Gateway API 专用于发送授权码，两者用途不同。
• 默认它免费：官网明确说 Bot API 和 Telegram API/TDLib 免费，但 Gateway API 的说明被截断，计费情况需另行确认。
• 忽略用户前提：Gateway API 的送达依赖用户有 Telegram 账号，没有账号的用户收不到验证码。
• 跳过官方文档直接开发：现有资料不含接口细节，动手前应先读 core.telegram.org 上的 Gateway API 页面。