Telegram Bot API 怎么用,机器人可以做什么?

Telegram Bot API 是 Telegram 为开发者提供的三类 API 之一,用来把运行在你自己服务器上的程序接入 Telegram。它的核心特点是:机器人是特殊账号,不需要额外手机号即可设置;你通过一个简单的 HTTPS 接口与 Telegram 的中转服务器通信,不需要了解 MTProto 加密协议的细节。如果你想让程序以 Telegram 消息作为交互界面,Bot API 是三者中最直接的入口。

Bot API 的定位

根据 core.telegram.org 的说明,Telegram 提供三类面向开发者的 API:

API 用途 适合谁
Bot API 把机器人接入 Telegram 系统,用消息作为程序界面 想快速做机器人、不想碰底层加密的开发者
Telegram API / TDLib 构建自定义的 Telegram 客户端 想做完整客户端、需要最大定制化的开发者
Gateway API 让企业、应用或网站通过 Telegram 发送验证码,替代传统短信 需要下发授权码的业务方

Bot API 的关键机制是“中转”:你不需要知道 MTProto 加密协议如何工作,Telegram 的中转服务器会替你处理所有加密和与 Telegram API 的通信。你与这台服务器之间只通过一个简化的 HTTPS 接口交互。这大幅降低了接入门槛——只要能用 HTTPS 发请求,就能驱动一个机器人。

机器人账号有什么特点

  • 机器人是特殊账号,不需要额外的手机号就能设置。
  • 它本质上是“运行在你服务器某处的代码”的对外接口,用户看到的是一个 Telegram 账号,背后是你的程序。
  • 适合的场景是:把 Telegram 消息当作程序的交互界面,例如接收指令、推送通知、做对话式服务。

机器人能做什么:支付能力

Bot 开发者还可以使用 Telegram 的 Payments API,接收来自全球 Telegram 用户的付款。也就是说,机器人不只是收发消息的界面,还能承载收款流程——这对做付费服务、订阅或数字商品的开发者是一个可用的能力。

怎么开始

  1. 明确你要做的是机器人,而不是客户端。 如果你的目标是让用户在你的自定义 Telegram 客户端里聊天,应该看 TDLib;如果只是想让程序通过 Telegram 消息与用户交互,选 Bot API。
  2. 设置机器人账号。 机器人无需额外手机号,按官方 Bot API 文档的流程创建即可。
  3. 在你的服务器上写代码。 代码通过 HTTPS 接口与 Telegram 的中转服务器通信,不需要自行实现 MTProto 加密。
  4. 按需接入 Payments API。 如果机器人涉及收款,再引入支付能力。

选择时的判断条件

  • 只想快速做出一个能用消息交互的机器人 → Bot API。
  • 要做功能完整、高度定制的 Telegram 客户端 → TDLib / Telegram API。
  • 业务方想用 Telegram 替代短信下发验证码 → Gateway API。

官方说明中明确表示,欢迎开发者免费使用 Bot API 和 Telegram API。至于 Payments API 涉及的具体费率、结算方式,以及 Gateway API 的计费细节,资料中未给出,需要以官方对应页面为准。

core.telegram.org
We offer three kinds of APIs for developers. The Bot API allows you to easily create programs that use Telegram messages…