DEVELOPER CENTER
Telegram 开发者中心
面向技术团队与独立开发者，提供 Bot API 全栈指南、Webhook 配置教程与自动化消息推送方案。从零开始，将你的创意接入全球加密通讯网络，构建下一代智能交互体验。
Bot API 核心能力
一套简洁却强大的 HTTP 接口，几乎可以驱动你能想象到的任何通讯自动化场景。
消息收发
支持文本、图片、视频、文件、投票、按钮等多种消息类型，并允许精确控制解析模式与通知策略。
实时更新
通过 getUpdates 轮询或 Webhook 推送获取新事件，稳定处理高并发场景下的增量消息流。
内联键盘
创建自定义键盘、回调查询按钮及 URL 跳转，将简单的命令式交互升级为富交互面板。
权限与安全
Bot Token 隔离权限范围，支持白名单、频道管理员绑定和深度链接，确保数据仅被授权接收。
三步创建你的第一个 Bot
无需复杂配置，一分钟启动开发环境
1
获取 Token
在 Telegram 中搜索 @BotFather，发送
/newbot 命令，按提示设置机器人名称与用户名，获取专属 HTTP API Token。2
配置环境
选择 Python、Node.js、Go 等任意语言，安装官方或社区 SDK，设置 Token 环境变量并初始化 Bot 实例。
3
部署上线
设置 Webhook 地址指向你的服务端点，或使用 setWebhook 方法激活推送；随后即可接收消息并返回处理结果。
你能构建的 Bot 类型
从简单应答到企业级工作流，想象力是唯一的限制
快速代码参考
使用 Python 与 python-telegram-bot 库发送第一条消息
import os
from telegram import Bot
from telegram.ext import Application
# 从环境变量读取 Bot Token
TOKEN = os.getenv("TELEGRAM_BOT_TOKEN")
async def start(update, context):
await update.message.reply_text("纸飞机开发者中心欢迎你！")
app = Application.builder().token(TOKEN).build()
app.add_handler(CommandHandler("start", start))
app.run_polling()
from telegram import Bot
from telegram.ext import Application
# 从环境变量读取 Bot Token
TOKEN = os.getenv("TELEGRAM_BOT_TOKEN")
async def start(update, context):
await update.message.reply_text("纸飞机开发者中心欢迎你！")
app = Application.builder().token(TOKEN).build()
app.add_handler(CommandHandler("start", start))
app.run_polling()
👆 以上代码展示了一个最简单的回声机器人骨架，你可以在此基础上扩展业务逻辑。
Webhook 配置与调试
从轮询切换到实时推送，获得更低的延迟与更高的可靠性
🔗 设定 Webhook 端点
使用 setWebhook 方法将你的 HTTPS 服务器地址注册到 Telegram 服务器，一旦有用户向 Bot 发送消息，Telegram 会立即向该地址 POST 一个 Update 对象。
curl -X POST "https://api.telegram.org/bot<YOUR_TOKEN>/setWebhook" \
-H "Content-Type: application/json" \
-d '{"url": "https://your-domain.com/webhook"}'
-H "Content-Type: application/json" \
-d '{"url": "https://your-domain.com/webhook"}'
⚠️ 必须使用 HTTPS 且端口为 443、80、8443 或 8080。自签名证书需额外上传 public.key。
开发者资源一站汇总
官方文档、SDK、社区工具，加速你的开发进程