Telegram API
我们为开发者提供三种 API。机器人 API 可以帮助您轻松创建以 Telegram 消息为交互界面的程序。 Telegram API 和 TDLib 允许您构建自定义 Telegram 客户端，这两类 API 均可免费使用。 最后，网关 API 允许企业、应用或网站通过 Telegram 而不是传统短信发送验证码。
您还可以在网站中添加 Telegram 小部件。
设计师也可以为 Telegram 创建 动态贴纸和表情 或 自定义主题。
机器人 API
此 API 可以把机器人连接到 Telegram 系统。 Telegram 机器人 是一种无需额外手机号码即可创建的特殊账号，它们充当服务器端程序代码与用户之间的交互界面。
使用机器人 API 时，您无需了解 MTProto 加密协议的工作方式。 Telegram 的中间服务器会负责所有加密工作以及与 Telegram API 的通信。 开发者只需要通过简单的 HTTPS 接口与服务器交互，该接口提供了经过简化的 Telegram API。
机器人开发者还可以使用 支付 API， 接收来自全球 Telegram 用户的付款。
TDLib——构建您自己的 Telegram
即使您需要高度自定义，也不必从零开始创建应用。 可以使用我们的 Telegram 数据库开发库 （简称 TDLib）。它是面向第三方开发者的工具，可帮助您轻松构建快速、安全且功能丰富的 Telegram 应用。
TDLib 会负责所有网络实现细节、加密以及本地数据存储， 让开发者可以把更多时间投入到界面设计、响应式体验和精美动画中。
TDLib 支持 Telegram 的全部功能，可以用于 Android、iOS、Windows、macOS、Linux 以及几乎所有其他系统。该开发库完全开源，并兼容几乎所有编程语言。
网关 API
Telegram 网关 API 允许企业、应用或网站通过 Telegram 而不是传统短信发送授权码， 以便在降低成本的同时，提高验证码的安全性和送达速度。 Telegram 的月活跃用户将会在应用内专用聊天中立即收到验证码消息。
Telegram API
此 API 允许您构建自定义 Telegram 客户端，向所有希望在 Telegram 平台创建应用的开发者完全开放。 您可以参考现有 Telegram 应用的 开源代码， 了解具体实现方式。请不要忘记在 Telegram 系统中 注册您的应用。
入门
创建应用
如何获取应用标识符，并创建新的 Telegram 应用。
用户授权
如何注册用户的手机号码并开始使用 API。
两步验证
用户启用两步验证后，如何登录账号以及更改密码。
二维码登录
二维码登录的完整流程。
通行密钥
Telegram 允许在设备上创建通行密钥，通过 PIN、Face ID、指纹等生物识别数据快速登录，无需使用短信验证码。
错误处理
如何正确处理 API 返回的错误。
处理不同的数据中心
如何连接最近的数据中心接入点，以更快地与 API 交互，以及开发客户端时需要注意的问题。
处理更新
如何订阅更新并正确处理更新。
处理推送通知
如何订阅并正确处理推送通知。
频道、超级群组、巨型群组和普通群组
如何处理频道、超级群组、巨型群组和普通群组，以及它们之间的区别。
论坛
Telegram 支持创建包含多个独立话题的论坛。
如果通过 @BotFather 启用了话题功能，机器人也可以使用群组话题。
向频道发送私信
Telegram 支持向频道发送私信，也可以通过此功能推荐频道帖子，包括付费推荐帖子。
频道统计
Telegram 为频道和超级群组提供详细的统计数据。
消息浏览量和已读指标
如何上报已读状态、频道帖子浏览量、消息阅读指标和音乐收听次数。
调用方法
调用 API 方法时可以使用的其他选项。
上传和下载文件
如何正确传输大批量文件和数据。
分页
如何从大型对象列表中分页获取结果。
客户端配置
MTProto API 提供多项客户端配置参数，可通过相应方法获取。
通话
Telegram 支持端到端加密的一对一通话。
群组通话
Telegram 支持端到端加密的群组通话。
安全
私密聊天与端到端加密
端到端加密消息的实现方式。
安全指南
客户端应用必须执行的重要安全检查。
完全前向保密
如何将临时授权密钥绑定到永久授权密钥。
语音和视频通话中的端到端加密
语音和视频通话中的端到端加密。
群组通话中的端到端加密
群组通话中的端到端加密。
私密聊天中的完全前向保密
通过定期更新密钥，为私密聊天提供完全前向保密。
私密聊天中的序列号
如何在私密聊天中分配并解析 seq_no 序列计数器。
优化
客户端优化
提高 API 交互效率和性能的方法。
API 方法
可用方法列表
可用高级 API 方法的完整列表。
API TL 架构及 JSON 格式
API 所使用类型和方法的文本格式与 JSON 格式说明。
层版本变更日志
不同可用架构层版本的详细变更记录。
其他文章
使用 MTProto API 操作机器人
如何通过 MTProto API 与机器人交互。
AI 功能
Telegram 提供多项由 Cocoon 驱动的 AI 功能。Cocoon 是一个以隐私保护为核心的去中心化网络。
机器人 API 对话 ID
机器人 API 对话 ID 是唯一的 64 位对等方标识，由用户、聊天、频道和私密聊天 ID 派生，并在这些类型之间保持唯一。
本页面说明如何在 MTProto 对等方 ID 与机器人 API 对话 ID 之间相互转换。
托管机器人
用户可以直接通过 MTProto API 创建由指定管理机器人控制的托管机器人，无需与 @BotFather 交互。
命令
机器人可以提供一组命令，供用户在私人聊天或其他聊天中使用。
按钮
用户可以通过普通按钮或内联按钮与机器人交互，这些按钮可以直接出现在任何聊天的内联消息中。
菜单按钮
机器人可以设置文本输入框旁边菜单按钮的行为。
内联查询
用户可以直接在任何聊天的文本输入框中，通过内联查询与机器人交互。
游戏
机器人可以提供 HTML5 游戏，让用户单人游玩，或在群组和一对一聊天中进行比赛；本页介绍如何通过 MTProto API 使用游戏。
小程序
机器人可以向用户提供交互式 HTML5 小程序，用于替代传统网站界面。
联盟计划
开发者可以为小程序开启联盟计划，让内容创作者、其他小程序开发者和任何 Telegram 用户推广小程序，并从推荐用户的消费中获得佣金。
附件菜单
机器人可以安装附件菜单入口，为用户提供方便访问且功能丰富的小程序。
编辑机器人信息
用户可以编辑并本地化自己拥有机器人的头像、名称、简介和说明；机器人也可以自行完成这些操作。
AI 机器人
Telegram 机器人为 AI 聊天机器人提供多项专用功能。
访客模式
访客机器人可以在非私密的一对一聊天、群组和超级群组中通过用户名调用，即使机器人不是聊天成员，也可以直接把结果发布到聊天中。
机器人之间的通信 »
启用机器人间通信模式后，机器人可以在群组、私人聊天及其他聊天中接收和发送来自其他机器人的消息。
故事
Telegram 用户和频道可以通过 API 轻松发布和查看故事。
相似频道和机器人
API 可以根据订阅者群体的相似度，获取主题相近的公开频道和机器人列表。
强调色
Telegram 用户和频道可以更改个人资料页面及消息的强调色和背景图案。
隐私设置
Telegram 允许用户设置细致的隐私规则，决定哪些用户可以或不能以特定方式与自己互动。
搜索和筛选
Telegram 支持在聊天中搜索消息时应用详细筛选条件。服务器可以按照文本查询和消息类型进行筛选，客户端通常用它实现聊天媒体库、头像列表等功能。
投票
Telegram 支持发送投票和测验，可供聊天和频道中的成千上万甚至数百万用户参与。
清单
Premium 用户可以在任何聊天中创建协作清单，用于跟踪任务、协调团队、管理购物清单或待办事项。
表情回应
Telegram 允许用户使用指定表情回应消息，并触发相应的 Lottie 动画。
动态消息特效
Telegram 允许为发送的消息添加醒目的动态特效。
表情分类
贴纸、自定义表情和 GIF 选择界面应提供分类列表，以便用户根据表情或其他条件快速筛选结果。
表情状态
Telegram 允许用户把普通表情或自定义表情设置为状态，并显示在聊天和个人资料名称旁边。
邀请链接和加入请求
频道、普通群组和超级群组可以设置公开用户名或私人邀请链接；私人邀请链接还可以要求用户逐一提交加入申请。
频道、超级群组和群组的管理员、封禁及默认权限
如何处理频道、群组和超级群组中的管理员权限、细分封禁以及全局默认权限。
讨论组
群组可以与频道关联为讨论组，让用户讨论频道帖子。
频道评论和消息线程
借助消息线程，Telegram 允许用户评论频道帖子或普通群组消息。
管理员日志
超级群组和频道提供管理员日志，用于记录设置修改、管理员操作、踢出和封禁用户等近期重要操作。
置顶消息
Telegram 允许在指定聊天顶部同时置顶多条消息。
群组成员和管理员标签
群聊成员可以在姓名旁添加标签，用来展示工作职责、学习方向或其他身份信息。
提及
Telegram 支持提及其他用户，并快速跳转到这些提及消息。
定时消息
Telegram 支持定时发送消息。
实时位置
Telegram 允许在聊天中发送实时位置，还可以设置接近提醒。
对等方数据库
如何在 API 中处理对等方信息。
精简构造器
群聊更新中的 user 和 channel 构造器有时不会包含完整信息，本页说明如何正确处理这些精简构造器。
账号删除
如何删除 Telegram 账号。
导入消息
Telegram 支持从其他聊天应用导入消息和媒体文件。
Telegram Passport
如何通过 MTProto API 直接使用 Telegram Passport。
Telegram 支付
如何通过 MTProto API 直接使用 Telegram 支付。
第三方认证
为提高平台透明度，官方第三方服务可以向用户账号和聊天分配额外认证图标，从而防止诈骗并减少虚假信息。
使用消息实体设置文本样式
如何通过消息实体创建带有格式的文本。
使用 GIF
Telegram 客户端支持显示 GIF 动图。
使用贴纸
Telegram 客户端支持显示动态贴纸、静态贴纸和视频贴纸。
使用自定义表情
Telegram 允许在消息中直接使用动态、静态和视频自定义表情。
使用动态表情
图形界面的 Telegram 客户端应把普通表情转换为相应的动态版本。
使用动态骰子
Telegram 支持发送动态骰子表情。
消息草稿
如何处理消息草稿。
文件夹
如何使用聊天文件夹。
常用对等方评分
启用后，常用对等方评分会表示用户、机器人、内联机器人和频道等对象在特定分类中的使用相关度。
处理文件引用
如何处理文件引用。
无缝 Telegram 登录
如何处理无缝 Telegram 登录 URL 授权请求。
聊天背景
如何使用聊天背景。
通知声音
如何使用聊天通知声音。
消息转写
如何把语音消息转写为文字。
消息翻译
Telegram 支持翻译聊天消息，Telegram Premium 用户还可以启用实时聊天翻译。
原生反垃圾系统
达到一定成员数量的超级群组可以启用 Telegram 原生反垃圾算法的强力模式，主动过滤垃圾消息。
收藏品
Telegram 用户可以通过用户名让他人更容易联系自己，或找到公开群组和频道。客户端还可以为账号、超级群组和频道分配多个 Fragment 收藏用户名，并使用收藏号码注册账号。
Telegram Premium
Telegram Premium 是可选订阅服务，可解锁额外的客户端和 API 功能，同时支持 Telegram 持续发展。它由用户推动，而不是依赖广告商或股东，使 Telegram 能保持独立并优先服务用户。
Telegram 商务版
用户可以把 Telegram 账号升级为商务账号，使用营业时间、地点、快捷回复、自动消息、自定义起始页和聊天机器人等商务功能。
大多数 Telegram 商务功能向 Telegram Premium 订阅者开放；关联商务机器人也可以供非 Premium 用户使用。
Telegram Stars
Telegram Stars 是 Telegram 生态系统中的虚拟物品，可用于从机器人和小程序购买数字商品与服务、向内容创作者赠送礼物等。
订阅
机器人和频道可以创建订阅，定期向用户收取一定数量的 Telegram Stars，以换取内容和服务。
受保护内容
用户、机器人、群组和频道可以限制消息转发，以保护内容隐私。该设置还可阻止截图、禁止转发受保护消息，并限制保存帖子中的媒体。
礼物
用户可以向好友赠送礼物。收礼人可以在个人资料中展示礼物，或将其兑换为 Telegram Stars，用于支持创作者和购买小程序服务。
收藏礼物拍卖
为公平分配收藏礼物，新礼物将通过多轮拍卖发布，用户可以使用 Stars 出价。
付费媒体
内容创作者可以在频道中发布付费照片或视频并收取 Stars，订阅者付款解锁后才能查看。
付费消息
Telegram Stars 可以用于向启用了 Star Messages 的用户、超级群组和频道发送付费消息，每发送一条消息都需要支付费用。
推荐帖子
Telegram 为频道管理员提供推荐帖子功能，帮助频道实现内容合作和商业变现。
频道和超级群组助推
Telegram Premium 用户可以为喜爱的频道或超级群组提供助推，解锁发布故事等额外功能。
抽奖和礼物
频道管理员可以发起抽奖，在关注者中随机分发 Telegram Premium 订阅或其他礼物，并获得助推。
操作栏
与 Telegram 用户进行私人聊天或私密聊天时，客户端有时需要在聊天顶部显示操作栏，提供操作按钮或用户相关提醒。
已保存的消息
“已保存的消息”可以收藏消息和媒体，相当于用于存放和转发内容的个人云端空间。
个人资料
Telegram 为个人资料提供大量自定义选项。
主题
Telegram 应用支持创建、分享和同步应用主题。
赞助消息
如果应用允许访问 Telegram 频道内容，就必须支持在频道中展示官方赞助消息。
频道和机器人广告收入
Telegram 提供极具吸引力的广告收益分成机制，频道和机器人所有者可以获得其频道和机器人中广告收入的 50%。
本页面介绍如何提取频道和机器人广告收入，以及查看详细收益统计。
事实核查
Telegram 客户端支持显示由独立事实核查机构添加到消息中的核查说明。
联系人
如何通过 API 使用联系人。
屏蔽列表
如何使用屏蔽列表。
年龄验证
部分法律要求用户在查看受限内容前进行年龄验证，Telegram 通过特殊机器人的主小程序实现此流程。
网页事件
与 HTML5 游戏和支付网关网站交互时，Telegram 应用需要提供相应的 JavaScript API。
深层链接
Telegram 客户端必须注册操作系统处理程序，以处理消息、链接实体和其他应用中出现的 tg:// 与 t.me 深层链接。
数据导出
Telegram API 允许用户通过数据导出 API 导出自己的全部信息。
服务条款
所有第三方客户端应用都必须遵守的服务条款。