我们为开发者提供三种 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 Gateway API 允许任何企业、应用或网站通过 Telegram 而非传统的短信发送授权码,从而以高效便捷的方式降低成本,同时提升授权码的安全性和送达速度,让 Telegram 的月活跃用户(达 10 亿)能够轻松接收。用户将在 Telegram 内的专属聊天窗口中即时收到包含授权码的消息。
Telegram API#
此 API 允许您构建自定义的 Telegram 客户端。它完全开放,供所有希望在我们平台上创建 Telegram 应用的开发者使用。您可以参考现有 Telegram 应用的开源代码,了解其工作原理。请务必在我们的系统中注册您的应用。
入门#
创建应用程序#
如何获取应用程序标识符并创建新的 Telegram 应用。
用户授权#
如何注册用户手机以开始使用 API。
双因素身份验证#
如果用户启用了双因素身份验证 (2FA),如何登录其帐户并更改密码?
二维码登录#
二维码登录流程
错误处理#
如何正确处理API返回错误。
处理不同的数据中心#
如何连接到最近的数据中心接入点以更快地与 API 交互,以及开发客户端时需要注意的事项。
处理更新#
如何订阅更新并正确处理它们。
处理推送通知#
如何正确订阅和管理它们。
频道、超级群组、巨型群组和基本群组#
如何处理通道、超级组、千兆组、基本组,以及它们之间的区别。
论坛#
Telegram允许创建包含多个不同主题的论坛。
直接消息到频道#
Telegram 支持向频道发送直接消息,还可以使用此功能推荐(甚至是付费)频道帖子。
频道统计#
Telegram 提供频道和超级群组的详细频道统计数据。
调用方法#
调用方法的其他选项。
文件上传和下载#
如何正确传输大批量数据。
分页#
如何从大型对象列表中获取结果。
客户端配置#
MTProto API 具有多个客户端配置参数,可以使用相应的方法获取这些参数。
安全#
秘密聊天,端到端加密#
端到端加密消息传递。
安全准则#
客户端应用程序中需要进行的重要检查。
完美前向保密#
将临时授权密钥绑定到永久授权密钥。
语音和视频通话中的端到端加密#
端到端加密通话。
优化#
客户优化#
提升 API 交互效率的方法。
API 方法#
可用方法列表#
可用高级方法列表。
API TL 模式,JSON 格式#
API 中使用的类型和方法的文本和 JSON 表示。
图层变更日志#
可用架构版本的详细变更日志。
其他文章#
使用 MTProto API 与机器人交互#
如何使用 MTProto API 与机器人协作。
机器人 API 对话 ID#
机器人 API 对话 ID 是一个唯一的 64 位对等 ID 序列,它由用户、聊天、频道和秘密聊天 ID 序列派生而来,并在所有这些序列中保持唯一性。
本页面详细说明了如何将 MTProto 对等 ID 转换为机器人 API 对话 ID,反之亦然。
命令#
机器人提供了一系列命令,用户可以在私下或聊天中使用。
按钮#
用户可以通过按钮或内联按钮与您的机器人进行交互,可以直接从任何聊天中的内联消息进行交互。
菜单按钮#
机器人可以选择显示在文本输入字段旁边的菜单按钮的行为。
内联查询#
用户可以通过任何聊天窗口中的文本输入字段,直接通过内联查询与您的机器人进行交互。
游戏#
机器人可以为用户提供 HTML5 游戏,供用户单人游玩或在群组中相互竞技,以及进行一对一聊天;如何在 MTProto API 中使用游戏。
小程序#
机器人可以为用户提供交互式HTML5 小程序,从而完全取代任何网站。
联盟计划#
开发者可以为其小程序开通联盟计划——允许内容创作者、其他小程序开发者和任何 Telegram 用户推广该小程序,并从他们推荐的人的购买中赚取佣金。
附件菜单#
机器人可以安装附件菜单项,提供方便易用、功能多样的迷你应用程序。
故事#
Telegram 用户和频道可以通过 API轻松发布和查看故事。
类似的频道和机器人#
该 API 提供了一种方法,可以获取主题相似的公共频道和机器人的列表,这些频道和机器人是根据其订阅者群体的相似性选择的。
强调色#
Telegram 用户和频道可以更改个人资料页面和消息的强调色和背景图案!
隐私设置#
Telegram 允许用户指定精细的隐私设置,选择哪些用户可以或不可以以某些方式与他们互动。
搜索和筛选#
Telegram 允许在聊天中查找消息时应用详细的消息筛选器。这使得服务器能够根据文本查询甚至消息类型进行筛选,图形客户端通常利用此功能来实现聊天记录、聊天头像等功能。
民意调查#
Telegram 允许发送投票和测验,成千上万甚至数百万用户可以在聊天和频道中进行投票。
清单#
高级用户现在可以在任何聊天中创建协作清单,以跟踪任务和协调团队,或管理购物清单和待办事项清单。
反应#
Telegram 允许用户使用特定的表情符号对任何消息做出反应,从而触发可爱的 Lottie 动画。
动画信息效果#
Telegram 允许为发送的消息添加炫酷的动画效果。
表情符号类别#
贴纸、自定义表情符号和 GIF 选择界面应提供类别列表,以便按表情符号(列表)或其他条件快速筛选结果。
表情符号状态#
Telegram 允许用户将表情符号或自定义表情设置为状态,显示在聊天和个人资料中的名称旁边。
邀请链接和加入请求#
频道、基本群组和超级群组可以有公开用户名或私人邀请链接:私人邀请链接可以进一步增强,允许每个用户单独申请加入。
频道、超级群组和群组的管理员、封禁用户和默认权限#
如何处理频道、群组和超级群组中的管理员权限、细粒度封禁和全局权限。
讨论组#
频道评论和消息讨论串#
Telegram 允许用户通过消息线程对频道帖子或通用群组消息进行评论。
管理员日志#
超级群组和频道都提供所谓的管理员日志,记录最近的相关超级群组和频道操作,例如管理员修改群组/频道设置或信息、踢出和封禁用户等等。
置顶消息#
Telegram允许将多条消息置顶在特定聊天记录之上。
提及#
Telegram 允许在紧急情况下提及其他用户,并能快速导航到这些提及以便尽快阅读。
定时消息#
Telegram 允许定时发送消息。
实时地理位置#
Telegram 允许在聊天中发送用户的实时地理位置,还可以选择设置接近提醒。
同行数据库#
如何在 API 中使用对等信息。
最小构造函数#
有时,在群聊更新中遇到的用户和频道构造函数可能不包含有关用户的完整信息:如何处理此类构造函数。
账户删除#
如何删除 Telegram 账号。
导入的消息#
Telegram允许从国外聊天应用导入消息和媒体文件。
Telegram 护照#
如何使用 MTProto API 直接与Telegram Passport交互。
Telegram支付#
如何使用 MTProto API 直接与 Telegram Payments 集成。
第三方验证#
为了进一步提高 Telegram 的透明度,官方第三方服务可以为用户帐户和聊天添加额外的验证图标,以防止诈骗和减少虚假信息。
带有消息实体的样式文本#
如何使用消息实体创建样式文本
使用 GIF#
Telegram客户端支持显示GIF动图。
使用贴纸#
Telegram客户端支持显示动画、静态和视频贴纸。
使用自定义表情符号#
Telegram 允许直接在消息中添加自定义动画、静态和视频表情符号。
使用动态表情符号#
图形化的 Telegram 客户端应该将表情符号转换为相应的动画版本。
使用动画骰子#
Telegram 支持发送动态骰子表情符号。
邮件草稿#
如何处理邮件草稿
文件夹#
使用文件夹
顶级同行评级#
如果启用,顶级同行的评分会显示某个类别中常用同行的相关性(例如,经常收到消息的用户、经常使用的机器人、内联机器人、经常访问的频道等等)。
处理文件引用#
如何处理文件引用。
无缝 Telegram 登录#
处理无缝 Telegram 登录 URL 授权请求。
壁纸#
如何使用聊天背景。
通知音#
如何使用聊天通知声音。
信息转录#
如何转录语音留言。
消息翻译#
Telegram 允许翻译聊天消息,Telegram Premium用户甚至可以启用实时聊天翻译。
原生反垃圾邮件系统#
拥有一定数量成员的超级群组管理员可以选择释放 Telegram 自身反垃圾邮件算法的全部主动功能——开启自动垃圾邮件过滤器的全新“激进”模式。
收藏品#
Telegram 用户可以通过用户名让其他人更容易联系他们或找到他们的公开群组和频道:客户还可以将多个Fragment » 收藏用户名分配给他们拥有的帐户、超级群组和频道;Fragment »还允许购买可用于注册 Telegram 帐户的电话号码收藏品。
Telegram Premium#
Telegram Premium 是一项可选的订阅服务,可解锁更多专属的客户端和 API 功能,同时也有助于支持应用的开发。它是 Telegram可持续盈利模式的一部分——由用户驱动,而非广告商或股东。这样,Telegram 才能保持独立运营,并将用户放在首位。
Telegram Business#
用户可以将他们的 Telegram 帐户转换为企业帐户,从而获得营业时间、位置、快速回复、自动消息、自定义起始页、聊天机器人支持等企业功能。
目前,Telegram Premium用户可免费使用所有 Telegram Business 功能。
Telegram 明星#
Telegram Stars 是虚拟物品,用户可以使用它从 Telegram 生态系统内的机器人和小程序购买数字商品和服务,向 Telegram 平台上的内容创作者赠送礼物等等。
订阅#
机器人和频道可以创建订阅,定期向用户收取一定数量的Telegram 星星,以换取内容和服务。
礼物#
用户可以向好友赠送礼物。收礼人可以将礼物展示在个人主页上,或将其兑换成Telegram 星星。Telegram 星星用途广泛,包括支持创作者和在小程序中购买服务。
付费媒体#
内容创作者可以通过在其频道上发布付费照片或视频来获得星星奖励。订阅者只有在向作者付费解锁后才能查看这些内容。
付费信息#
Telegram Stars 可用于向已配置Star Messages »的用户、超级群组和频道发送消息,每发送一条消息都需要付费。
推荐帖子#
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 允许用户通过 Takeout API 导出他们的所有信息。
