Telegram API
我们为开发者提供三种 API。Bot API允许您轻松创建使用 Telegram 消息作为界面的程序。Telegram API 和 TDLib允许您构建自己的自定义 Telegram 客户端。欢迎您免费使用这两种 API。最后,Gateway API允许任何企业、应用或网站通过 Telegram 发送验证码,而无需使用传统的短信。
您还可以将Telegram Widgets添加到您的网站。
欢迎设计师为 Telegram创建动画贴纸和表情符号或自定义主题。
纸飞机 API
telegram API
入门
创建应用程序
如何获取您的应用程序标识符并创建新的 Telegram 应用程序。
用户授权
如何注册用户的电话以开始使用 API。
双因素身份验证
如果用户启用了 2FA,如何登录用户帐户,如何更改密码。
二维码登录
二维码登录流程
错误处理
如何正确处理API返回错误。
处理不同的数据中心
如何连接最近的DC接入点,以便更快的与API交互,以及开发客户端时需要注意的事项。
处理更新
如何订阅更新并正确处理它们。
处理推送通知
如何订阅并正确处理它们。
频道、超级组、千兆组和基本组
如何处理通道、超级组、千兆组、基本组以及它们之间的区别。
论坛
Telegram 允许创建具有多个不同主题的论坛。
渠道统计
Telegram 为频道和超级群组提供详细的频道统计数据。
调用方法
调用方法的附加选项。
上传和下载文件
如何正确传输大量数据。
分页
如何从大量对象列表中获取结果。
客户端配置
MTProto API 有多个客户端配置参数,可以使用适当的方法获取。
安全
秘密聊天,端到端加密
端到端加密消息传递。
安全指南
您的客户端应用程序中需要进行的重要检查。
完美前向保密
将临时授权密钥与永久授权密钥绑定。
语音和视频通话中的端到端加密
端到端加密通话。
优化
客户端优化
增强 API 交互的方法。
API 方法
可用方法列表
可用的高级方法列表。
API TL-schema,作为 JSON
API 中使用的类型和方法的文本和 JSON 表示。
可用图层列表
可用架构版本的列表。
其他文章
使用 MTProto API 与机器人协作
如何使用 MTProto API 与机器人合作。
命令
机器人提供了一组命令,可供用户私下或聊天时使用。
按钮
用户可以通过按钮甚至内联按钮与您的机器人进行交互,直接从任何聊天中的内联消息进行交互。
菜单按钮
机器人可以选择文本输入字段旁边显示的菜单按钮的行为。
内联查询
用户可以通过内联查询与您的机器人进行交互,直接从任何聊天中的文本输入字段进行。
游戏
机器人可以为用户提供 HTML5 游戏,供其单独玩或在群组和一对一聊天中相互竞争;如何在 MTProto API 中使用游戏。
小程序
机器人可以为用户提供交互式HTML5 迷你应用程序,以完全取代任何网站。
联盟计划
开发人员可以为他们的小程序开设联盟计划——允许内容创建者、其他小程序开发人员和任何 Telegram 用户推广它并从他们推荐的人的购买中赚取佣金。
附件菜单
机器人可以安装附件菜单项,提供方便访问、功能多样的迷你应用程序。
故事
Telegram 用户和频道可以通过 API轻松发布和查看故事。
类似频道
API 提供了一种方法来获取类似主题的公共频道列表,这些频道是根据订阅者群的相似性进行选择的。
强调色
Telegram 用户和频道可以更改其个人资料页面和消息的强调色和背景图案!
隐私设置
Telegram 允许用户指定细粒度的隐私设置,选择哪些用户可以或不能以某种方式与他们互动。
搜索和过滤器
Telegram 允许在聊天中查找消息时应用详细的消息过滤器。
这使得服务器能够根据文本查询甚至消息类型进行过滤。此功能通常由图形客户端使用,以实现聊天图库、聊天头像等功能。
民意调查
Telegram 允许发送民意调查和测验,聊天和频道中的数千甚至数百万用户可以进行投票。
反应
Telegram 允许用户使用特定的表情符号对任何消息做出反应,从而触发可爱的洛蒂动画。
动画消息效果
Telegram 允许为您发送的消息添加壮观的动画效果。
表情符号类别
贴纸、自定义表情符号和 GIF 选择 UI 应该提供一个类别列表,以便通过表情符号(列表)或其他标准快速过滤结果。
表情符号状态
Telegram 允许用户设置表情符号或自定义表情符号作为状态,以在聊天和个人资料中显示在其姓名旁边。
邀请链接和加入请求
频道、基本组和超级组可能有公共用户名或私人邀请链接:私人邀请链接可以通过每个用户的加入请求进一步增强。
频道、超级群组和群组的管理、禁止和默认权限
如何处理频道、群组和超级群组中的管理员权限、细粒度禁令和全局权限。
讨论组
频道评论和消息线程
借助消息线程,Telegram 允许对频道帖子或通用群组消息进行评论。
管理日志
超级群组和频道都提供所谓的管理日志,即最近相关的超级群组和频道操作的日志,例如代表管理员修改群组/频道设置或信息、用户踢出和禁止等等。
置顶消息
Telegram 允许在特定聊天中固定多条消息。
提及
Telegram 允许在出现紧急事项时提及其他用户,并快速导航到这些提及以便尽快阅读。
预定消息
Telegram 允许安排消息。
实时地理位置
Telegram 允许在聊天中发送用户的实时地理位置,并可选择设置接近警报。
对等数据库
如何在 API 中处理对等信息。
最小构造函数
有时,群聊更新中遇到的用户和频道构造函数可能不包含有关用户的完整信息:如何处理此类构造函数。
帐户删除
如何删除 Telegram 帐户。
导入的消息
Telegram 允许从国外聊天应用程序导入消息和媒体。
电报护照
如何使用MTProto API 直接使用Telegram Passport 。
电报支付
如何使用 MTProto API 直接使用 Telegram Payments。
带有消息实体的样式文本
如何使用消息实体创建样式文本
使用 GIF
Telegram 客户端支持显示 GIF。
使用贴纸
Telegram 客户端支持显示动画、静态和视频贴纸。
使用自定义表情符号
Telegram 允许直接在消息中包含自定义动画、静态和视频表情符号。
使用动画表情符号
图形电报客户端应该将表情符号转换为各自的动画版本。
使用动画骰子
Telegram 支持发送动画骰子表情符号。
邮件草稿
如何处理邮件草稿
文件夹
使用文件夹
最高同行评级
如果启用,顶级同行的评级表明某个类别中经常使用的同行的相关性(经常发送消息的用户、经常使用的机器人、内联机器人、经常访问的频道等)。
处理文件引用
如何处理文件引用。
无缝电报登录
处理无缝电报登录 URL 授权请求。
壁纸
如何使用聊天背景。
通知声音
如何使用聊天通知声音。
消息转录
如何转录语音消息。
消息翻译
Telegram 允许翻译聊天信息,Telegram Premium用户甚至可以启用实时聊天翻译。
原生反垃圾邮件系统
拥有一定数量成员的超级群组的管理员可以选择释放 Telegram 自己的反垃圾邮件算法的全部主动能力——为自动垃圾邮件过滤器打开新的积极模式。
收藏品
Telegram 用户可以通过用户名方便其他人联系他们或找到他们的公开群组和频道:客户端还可以为自己拥有的账户、超级群组和频道分配多个Fragment » 收藏品用户名; Fragment »还允许购买可用于注册 Telegram 账户的电话号码收藏品。
Telegram 高级版
Telegram Premium 是一项可选订阅服务,可解锁更多专属客户端和 API 端功能,同时支持应用的开发。它是 Telegram可持续盈利模式的一部分——由用户驱动,而非广告商或股东。这样,Telegram 可以保持独立,并将用户放在首位。
电报业务
用户可以将他们的 Telegram 帐户转变为商业帐户,从而可以使用营业时间、位置、快速回复、自动消息、自定义起始页、聊天机器人支持等商业功能。
目前,Telegram Business 的所有功能均免费提供给Telegram Premium订阅用户。
电报之星
Telegram Stars 是虚拟物品,用户可以从 Telegram 生态系统内的机器人和小程序购买数字商品和服务,向 Telegram 平台上的内容创作者发送礼物等等。
订阅
机器人和频道可以创建订阅,定期向用户收取一定数量的Telegram Stars以换取内容和服务。
礼物
用户可以向好友发送礼物。收礼人可以将礼物展示在个人资料页面上,或将其兑换成Telegram 星星 »。Telegram 星星用途广泛,包括支持创作者和购买小程序服务。
付费媒体
内容创作者可以通过在其频道上发布付费照片或视频来获得星星。订阅者只有向作者付费解锁后才能查看此类帖子。
频道和超级组合的提升
Telegram Premium用户可以授予他们最喜欢的频道额外的功能,比如通过给予他们提升来发布故事的能力。
赠品和礼物
Telegram频道管理员可以推出赠品活动,在其关注者中随机分发Telegram Premium订阅和其他礼物,以换取提升。
操作栏
有时,当通过私人或秘密聊天与 Telegram 用户互动时,必须在聊天顶部显示一个操作栏,提供方便的操作按钮或有关用户的通知。
已保存的消息
“已保存消息”聊天允许用户为消息和媒体添加书签:它是您可能想要发送或转发的任何消息或媒体的个人云存储。
轮廓
Telegram 为您的个人资料提供了许多自定义选项!
主题
Telegram 应用支持生成、共享和同步应用主题。
赞助信息
如果您的应用允许访问 Telegram频道的内容,则您必须在 Telegram 频道中包含对官方赞助消息的支持。
频道和机器人广告收入
Telegram 拥有社交媒体史上最慷慨的奖励系统之一。Telegram 频道和机器人所有者现在可以获得其频道和机器人中展示的广告收入的50% 。
本页介绍了提取频道和机器人广告收入的方法,以及查看详细的收入统计数据。
事实核查
Telegram 客户端支持显示独立事实核查人员添加到消息中的事实核查。
联系方式
使用 API 中的联系人。
阻止列表
使用阻止列表。
附近的用户和聊天
如何使用基于地理位置的功能,如 geochats 和附近用户功能。
Web 事件
与 HTML5 游戏和支付网关网站交互时,Telegram 应用程序应公开以下 JS API。
深层链接
Telegram 客户端必须通过注册操作系统处理程序来处理消息、链接实体和其他应用程序中遇到的特殊tg://
和深层链接。t.me
取出
Telegram 的 API 允许用户通过外卖 API 导出自己的所有信息。