电报 API
我们为开发者提供三种类型的 API。Bot API 让你可以轻松创建使用 Telegram 消息作为界面的程序。Telegram API 和 TDLib 允许您构建自定义的 Telegram 客户端。欢迎免费使用这两个API。最后，Gateway API允许任何企业、应用或网站通过Telegram发送验证码，而非传统短信。
你也可以在网站上添加 Telegram 小部件。
设计师欢迎为Telegram制作动画贴纸和表情符号或自定义主题。
机器人API
这个API允许你将机器人连接到我们的系统。Telegram机器人是特殊账户，无需额外电话号码即可设置。这些账户作为服务器上运行代码的接口。
使用这个协议时，你无需了解我们的 MTProto 加密协议——我们的中介服务器将为你处理所有加密和与 Telegram API 的通信。你通过一个简单的HTTPS接口与该服务器通信，该接口提供了Telegram API的简化版本。
机器人开发者还可以利用我们的支付API接受来自全球Telegram用户的付款。
TDLib——打造你自己的Telegram
即使你追求最大的定制化，也不必从零开始创建你的应用。试试我们的 Telegram 数据库库（简称 TDLib），这是一个面向第三方开发者的工具，方便快速、安全且功能丰富的 Telegram 应用。
TDLib负责所有网络实现细节、加密和本地数据存储，这样你就能投入更多时间在设计、响应式界面和精美动画上。
TDLib 支持所有 Telegram 功能，使得在任何平台上开发 Telegram 应用都变得轻松。它可以在Android、iOS、Windows、macOS、Linux以及几乎所有其他系统上使用。该库是开源的，几乎兼容任何编程语言。
网关API
Telegram网关API允许任何企业、应用或网站通过Telegram发送授权码，而非传统短信——这是一种强大且便捷的方式，既能降低成本，又能提升代码的安全性和向Telegram 10亿月活跃用户的传输速度。用户将在Telegram内的特殊聊天中即时收到带有代码的消息。
Telegram API
该 API 允许您构建自定义的 Telegram 客户端。所有希望在我们平台上创建 Telegram 应用的开发者均可完全开放。欢迎你研究现有Telegram应用的开源代码，了解这里的运作方式。别忘了在我们的系统中注册你的申请。
入门
创建应用程序
如何获取你的应用标识符并创建一个新的 Telegram 应用。
用户授权
如何注册用户手机以开始使用 API。
双因素认证
如果用户启用了双重认证，如何登录他们的账户，如何更改密码。
二维码登录
二维码登录流程
错误处理
如何正确处理 API 返回错误。
处理不同数据中心
如何连接最近的数据中心接入点以加快与API的交互，以及开发客户端时需要注意的事项。
处理更新
如何订阅更新并正确处理。
处理推送通知
如何订阅并正确管理它们。
通道、超群、giga群和基本群
如何处理通道、超级组、超级组、基础组，以及它们之间的区别。
论坛
Telegram 允许创建包含多个不同主题的论坛。
直信给频道
Telegram支持向频道的直接消息，这些消息也可用于建议（甚至付费）频道帖子。
频道统计
Telegram 提供了频道和超级组的详细频道统计数据。
调用方法
调用方法的额外选项。
上传和下载文件
如何正确传输大量数据批次。
分页
如何从大量对象列表中获取结果。
客户端配置
MTProto API 拥有多个客户端配置参数，可用相应方法获取。
安全性
秘密聊天，端到端加密
端到端加密消息。
安全指南
客户申请中需要进行的重要核查。
完美前进保密
将临时授权密钥绑定为永久授权密钥。
语音和视频通话中的端到端加密
端到端加密通话。
优化
客户端优化
提升API交互的方法。
API 方法
可用方法列表
一份可用的高级方法列表。
API TL-schema，作为 JSON
API中使用的类型和方法的文本和JSON表示。
层变更日志
详细的可用模式版本更新日志。
其他文章
与机器人合作，使用 MTProto API
如何使用MTProto API与机器人合作。
机器人API对话框ID
机器人API对话框ID是从用户、聊天、频道和秘密聊天ID序列中推导出的单一、唯一64位对等ID序列，保持所有这些序列的独特性。
本页面说明了如何将MTProto对等ID转换为机器人API对话框ID，反之亦然。
指挥
机器人提供一组命令，用户可以在私密或聊天中使用。
按钮
用户可以通过按钮甚至内联按钮与你的机器人互动，直接从任何聊天中的内联消息中进行。
菜单按钮
机器人可以选择文本输入栏旁菜单按钮的行为。
内联查询
用户可以通过内联查询直接在任何聊天中的文本输入栏与你的机器人互动。
游戏
机器人可以为用户提供HTML5游戏，供玩家单人游玩或在小组和一对一聊天中相互竞争;如何在MTProto API中使用游戏。
迷你应用
机器人可以为用户提供互动式HTML5迷你应用，完全替代任何网站。
联盟项目
开发者可以为他们的迷你应用开设联盟计划——允许内容创作者、其他迷你应用开发者以及任何Telegram用户推广该项目，并从推荐的客户购买中获得佣金。
附件菜单
机器人可以安装附件菜单条目，提供便捷且多功能的迷你应用。
故事
Telegram用户和频道可以轻松通过API发布和查看故事。
类似频道和机器人
该API提供了一种方法，可以根据订阅者基础的相似性筛选出主题相似的公共频道和机器人列表。
点缀色
Telegram用户和频道可以更改个人资料页和消息的重音色和背景图案！
隐私设置
Telegram允许用户自定义细致的隐私设置，选择哪些用户可以以特定方式与他们互动，哪些不可以。
搜索与筛选
Telegram允许在寻找聊天信息时应用详细的消息过滤。 这使得服务器能够根据文本查询甚至类型过滤消息，这一功能常被图形客户端用来实现聊天画廊、聊天头像等功能。
民调
Telegram支持发送投票和测验，数千甚至数百万用户在聊天和频道中投票。
清单
高级用户现在可以在任何聊天中创建协作清单，以跟踪任务和协调团队——或管理购物和待办事项。
反响
Telegram允许用户用特定表情符号对任何消息做出反应，触发可爱的乐蒂动画。
动画消息效果
Telegram允许你为发送的消息添加壮观的动画效果。
表情符号分类
贴纸、自定义表情和GIF选择界面应提供类别列表，以便通过表情符号列表或其他条件快速筛选结果。
表情符号状态
Telegram允许用户将表情符号或自定义表情符号作为状态，在聊天和个人资料中显示在姓名旁边。
邀请链接和加入请求
频道、基础组和超级群组可以有公开用户名或私密邀请链接：私密邀请链接可以通过按用户加入请求进一步增强。
频道、超级群组和群组的管理员权限、封禁权和默认权限
如何处理频道、群组和超级群组中的管理员权限、细致封禁和全局权限。
讨论组
频道评论和消息线程
Telegram 支持在频道帖子或群组消息下评论，这得益于消息线程。
管理员日志
超级群组和频道都提供所谓的管理员日志，记录近期相关的超级群组和频道操作，比如修改组/频道设置或管理员提供的信息、用户踢出和封禁等。
置顶消息
Telegram 允许在特定聊天内容上置顶多条消息。
提及
Telegram允许在紧急小鸭事件时提及其他用户，并快速导航到这些提及，以便尽快阅读。
定时消息
Telegram 支持安排消息。
实时地理定位
Telegram 允许在聊天中发送用户的实时地理位置信息，并可选择设置接近警报。
对等数据库
如何在API中处理对等信息。
最小制造商
有时，群聊更新中遇到的用户和通道构建器可能不包含用户的完整信息：如何处理此类构建器。
账户删除
如何删除Telegram账号。
导入消息
Telegram 允许从外国聊天应用导入消息和媒体。
电报护照
如何直接使用 MTProto API 操作 Telegram Passport。
电报支付
如何使用 MTProto API 直接使用 Telegram 支付。
第三方验证
为了进一步提升 Telegram 的透明度，官方第三方服务能够为用户账户和聊天群分配额外的验证图标——以防止诈骗并减少虚假信息。
带有消息实体的样式文本
如何用消息实体创建有样式的文本
与GIF合作
Telegram客户端支持显示GIF。
使用贴纸
Telegram客户端支持显示动画、静态和视频贴纸。
使用自定义表情符号
Telegram 允许在消息中直接添加自定义的动画、静态和视频表情。
使用动画表情符号
图形Telegram客户端应将表情符号转换为相应的动画版本。
使用动画骰子
Telegram支持发送动画骰子表情。
消息草稿
如何处理消息草稿
文件夹
文件夹操作
顶级同行评级
如果启用，顶级对等节点的评分显示了某一类别中常用对等节点的相关性（如频繁消息用户、常用机器人、内嵌机器人、频繁访问频道等）。
处理文件引用
如何处理文件引用。
无缝Telegram登录
处理无缝Telegram登录URL授权请求。
壁纸
如何处理聊天背景。
通知声
如何处理聊天通知音效。
消息转录
如何转录语音留言。
消息翻译
Telegram支持聊天消息的翻译，Telegram高级用户甚至可以启用实时聊天翻译。
本地反垃圾邮件系统
拥有一定成员数量的超级群组管理员可以选择释放Telegram自有反垃圾邮件算法的全部主动能力——开启新的“激进模式”来自动过滤垃圾邮件。
收藏品
Telegram用户可以通过用户名方便他人联系他们或查找他们的公开群组和频道：客户端还可以为自己拥有的账户、超级群组和频道分配多个Fragment 收藏用户名;Fragment 还允许购买可用于注册Telegram账户的电话号码收藏品。
Telegram高级版
Telegram Premium 是一项可选的订阅服务，可解锁更多独家客户端和 API 端功能，同时支持应用开发。这是Telegram可持续变现的一部分——由用户驱动，而非广告商或股东。这样，Telegram 可以保持独立，优先考虑用户。
电报业务
用户可以将 Telegram 账户转换为企业账户，享受营业时间、位置、快速回复、自动消息、自定义启动页面、聊天机器人支持等商业功能。
目前，所有Telegram商务功能对Telegram高级订阅者免费开放。
电报明星
Telegram Stars是虚拟物品，允许用户在Telegram生态系统内的机器人和小应用购买数字商品和服务，向Telegram平台上的内容创作者发送礼物等。
订阅
机器人和频道可能会创建订阅，定期向用户收取一定数量的 Telegram 星币以换取内容和服务。
礼物
用户可以向朋友发送礼物。礼物的收礼人可以在个人资料页上展示，或将其转换为Telegram星。Telegram Stars 可用于多种用途，包括支持创作者和购买迷你应用中的服务。
付费媒体
内容创作者可以通过在其频道上发布付费照片或视频来接受星星奖励。订阅者只有在付费给作者解锁后才能查看此类帖子。
付费消息
Telegram Stars 可用于向用户、超级群组和频道发送消息，这些频道已配置 Star 消息“，每发送一条消息都要付费。
推荐帖子
Telegram为频道管理员提供了强大的变现功能：推荐帖子。
通道和超群提升
Telegram Premium 用户可以为自己喜欢的频道提供额外功能，比如通过提升来发布故事。
赠品与礼品
Telegram频道管理员可能会发放赠品，随机分发Telegram Premium订阅和其他礼品，以换取提升。
动作条
有时，在通过私密或秘密聊天与Telegram用户互动时，需要在聊天顶部显示动作栏，提供方便的操作按钮或用户相关通知。
保存的消息
“保存消息聊天”允许用户收藏消息和媒体：这是一个个人云存储，存放你想发送或转发的任何消息或媒体。
简介
Telegram为你的个人资料提供了多种定制选项！
主题
Telegram应用支持生成、共享和同步应用主题。
赞助信息
如果您的应用允许访问Telegram频道内容，您必须在Telegram频道中支持官方赞助消息。
频道和机器人广告收入
Telegram拥有社交媒体历史上最慷慨的奖励系统之一。Telegram频道和机器人所有者现在可以从其频道和机器人中展示的广告中获得50%的收入。
本页介绍了提取频道和机器人广告收入的方法，以及查看详细的收入统计数据。
事实核查
Telegram客户端支持显示由独立事实核查员添加到消息中的事实核查。
联系人
在API中与联系人合作。
黑名单
使用黑名单。
附近用户与聊天
如何使用基于地理定位的功能，如地理聊天和附近用户功能。
年龄验证
有些法律要求观看受限内容需要年龄验证：Telegram通过特殊机器人的主迷你应用实现了这一点。
网络活动
在与HTML5游戏和支付网关网站交互时，Telegram应用应公开以下JS API。
深度链接
Telegram客户端必须通过注册操作系统处理器来处理消息、链接实体及其他应用中遇到的特殊和深度链接。tg://t.me
外卖
Telegram的API允许用户通过外卖API导出所有信息。