消息与文件收发
发送文本、图片、音视频和文档，接收用户消息及指定事件，适合订阅提醒、客服入口和文件处理工具。
接入要求使用 Bot Token；通过长轮询或 Webhook 接收更新，两者不能同时使用。普通私聊通常由用户先发消息；获得登录授权中的发消息权限后也可联系该用户。
消息与机器人 / Telegram Bot Platform
Telegram 机器人
通过 Bot API 创建消息机器人，为私聊、群组和频道提供通知、交互菜单、管理工具，也能扩展为 Mini Apps、网站登录和支付入口。需要开发者自行部署程序，并按具体功能配置权限。
01 / CAPABILITIES
开放功能
命令、按钮与内联查询
配置命令菜单、回复键盘和回调按钮；用户也可在其他聊天的输入框中调用机器人查询并分享结果。
接入要求内联查询需在 BotFather 中启用；程序需要分别处理消息、回调查询和内联查询事件。
群组与频道管理
在群组或频道中发布内容，处理成员变动、入群申请，以及具备权限时的成员限制和封禁。
接入要求群消息可见范围受隐私模式影响；封禁成员等管理操作需要相应管理员权限，部分成员事件还需要显式订阅。
Mini Apps 网页应用
通过机器人菜单、按钮或链接打开网页应用，使用 Telegram 的主题、用户上下文和界面交互能力。
接入要求开发者自行托管网页并配置入口；服务端应验证 initData，不能直接信任 initDataUnsafe。不同启动方式提供的数据和操作范围不同。
网站与应用登录
用 Telegram 账号登录自己的网站或应用，可按用户同意情况获取基础资料、手机号或机器人发消息权限。
接入要求用机器人代表应用，在 BotFather 登记允许的网站及回调地址并取得客户端凭证；服务端必须验证 ID Token，敏感资料需要相应授权。
商品与服务支付
在机器人中发送账单并处理付款；数字商品使用 Telegram Stars，实物及线下服务可接第三方支付服务商。
接入要求区分数字商品和实物支付流程；数字商品在 Telegram 应用内销售必须使用 Stars，实物支付需完成服务商配置，并处理交付、退款和客户支持。
02 / REQUIREMENTS
接入条件
- 适用主体
- 独立开发者、社区运营者、客服与通知工具开发者、网页应用开发者
- 接入方式
- BotFather 生成的 Bot Token / Mini Apps 启动数据服务端校验 / Telegram Login 的 OpenID Connect 授权码流程，可配合 PKCE
- 申请概况
- 个人可接入，部分功能需额外配置
- 拥有 Telegram 账号，通过 BotFather 创建机器人并保管 Bot Token；本导航不收集凭证，也不代接账号。
- 自行部署处理消息的程序；使用 Webhook 时配置可访问的 HTTPS 地址，并可设置 secret_token 校验回调来源。
- 按聊天类型配置隐私模式、管理员权限和事件订阅，先确认能收到哪些事件，再设计业务流程。
- 提供与实际数据处理一致、用户可访问的隐私政策，并遵守机器人开发者条款。
03 / GET STARTED
开通步骤
- 01
创建机器人
在 BotFather 使用创建功能，填写机器人资料，取得 Token 并存放在服务端配置中。
- 02
先连通基础接口
按官方入门教程调用 getMe，再选择长轮询或 Webhook，确认程序能处理来自自己测试聊天的更新。
- 03
配置目标场景
根据需要启用内联查询、设置群管理员权限，或配置 Mini Apps、登录及支付。
- 04
用测试机器人验证
先使用独立机器人账号；高级场景可使用完全独立的官方测试环境，验证错误重试及权限不足时的行为。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况
基础 Bot 平台免费，额外成本取决于广播规模、支付方案和自己的部署。
- 普通使用仍受频控约束；提高广播速度的付费广播使用 Telegram Stars，并有开通条件。
- 数字商品支付使用 Stars，用户购买价格和开发者收益受税费及平台规则影响；不在此写死兑换价格。
- 实物支付经第三方服务商处理，应核对该服务商的费率、结算与可服务地区。
- 机器人程序及 Mini Apps 的服务器、域名和其他外部服务由开发者自行承担。
使用范围与限制
- 机器人不是个人账号的全量聊天读取接口；普通群组默认隐私模式只提供相关命令和消息。
- 普通机器人不能任意主动联系陌生用户；用户先发消息、加入相关聊天或授予发消息权限等条件会影响触达范围。
- 发送消息、群内发送及广播分别受到频控；出现限流时应依据错误响应重试，具体数值以当前官方说明为准。
- 平台、部分功能及第三方应用可能因客户端、地区和监管等因素不可用；支付还需核对服务商覆盖范围。
- 开发者条款限制超出服务必要范围的数据采集，并要求按适用情形删除用户数据；不要将群聊读取能力描述为无限制采集。
如何进行开发测试
- 正式环境：通过 BotFather 创建的机器人调用正式 Bot API。
- 独立测试机器人：官方建议另建机器人运行测试代码，避免影响已有用户。
- 官方专用测试环境：账号与机器人均与正式环境隔离，使用 Test Bot API；频控不会因此普遍放宽。
- 支付测试：Stars 可在专用测试环境验证；实物支付可按服务商提供的测试模式验证。
接入前再确认
- 未创建机器人、登录用户账号或验证所在地区网络及支付资格。
- Telegram Login 依据当前 OIDC 文档整理，旧 iframe 登录组件文档已归档。
- 官方 FAQ 与较新文档对机器人间消息存在差异，本页未对该能力作出承诺。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。
- 01机器人平台介绍与普通用户账号的区别已核对官方资料 · 2026-10-15
- 02Bot API：消息、更新、Webhook 与管理员方法已核对官方资料 · 2026-10-15
- 03机器人功能、隐私模式与测试环境已核对官方资料 · 2026-10-15
- 04机器人 FAQ：消息频控与付费广播已核对官方资料 · 2026-10-15
- 05Mini Apps：启动入口与启动数据校验已核对官方资料 · 2026-10-15
- 06Telegram Login：允许地址、OIDC 与授权范围已核对官方资料 · 2026-10-15
- 07数字商品与服务的 Stars 支付及测试已核对官方资料 · 2026-10-15
- 08实物商品与服务的第三方支付接入已核对官方资料 · 2026-10-15
- 09机器人开发者条款：地区可用性、隐私与数据采集已核对官方资料 · 2026-10-15
- 10从 BotFather 到 Hello World 官方教程已核对官方资料 · 2026-10-15
- 11BotFather 管理入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明
最近核验 2026-10-15 · 查看核验说明