Telegram Bot API 中文教程与在线工具
这里为中文开发者整理了 Telegram(电报)Bot API 的实用教程,并提供可以直接在浏览器中使用的免费工具。你可以按教程创建机器人、获取 Token 和 chat_id、配置 Webhook,再用 Bot API Tester 调用 Bot API 10.3 的全部 185 个方法,或用 Mini App Tester 调试 Telegram.WebApp 接口。
中文教程
从创建第一个机器人到上线部署:每篇教程都附有可直接复制的 curl、Python 和 JavaScript 示例,方法名和参数保留英文原名,方便对照官方文档。
Telegram 机器人教程:从零创建 Telegram 机器人并发送第一条消息
Telegram 机器人教程:在 @BotFather 中用 /newbot 创建机器人并获取 Token,用 getMe 验证,再通过 getUpdates 找到 chat_id,用 curl 和 Python 发出第一条消息,附常见问题排查。
Telegram Bot API 发送消息教程:sendMessage 参数、格式、按钮与错误处理
Telegram Bot API 发送消息中文教程:sendMessage 参数说明,curl、Python、JavaScript 示例,HTML 与 MarkdownV2 格式、内联按钮、群组和频道发送,以及 400、403、429 错误处理。
Telegram Bot Token 怎么获取:获取、查看、验证和撤销机器人 Token
Telegram Bot Token 怎么获取?用 @BotFather 的 /newbot 获取新 Token,在 /mybots 中查看已有 Token,用 getMe 检查是否有效,泄露后及时撤销,并配合 chat_id 接入 n8n 等工具。
Telegram Bot Webhook 设置教程:用 setWebhook 配置 Webhook URL 和 secret_token
Telegram Bot API setWebhook 中文教程:Webhook URL 的 HTTPS 与端口要求、secret_token 请求头校验、用 getWebhookInfo 排错、用 deleteWebhook 切回轮询,以及 409 等常见错误的解决方法。
Telegram chat id 获取教程:查看用户、群组、频道和话题的聊天 ID
Telegram chat id 获取教程:用 getUpdates 查看私聊、群组、超级群组、频道和论坛话题的聊天 ID,讲清负数和 -100 前缀的含义,并排查 result 为空、409 Conflict 等常见问题,附 Python 示例。
免费在线工具
Bot API Tester
在浏览器中调用 Bot API 10.3 的全部 185 个方法:按类型生成的参数表单、getUpdates 长轮询、可折叠的 JSON 查看器,用 getMe 一键检查 Token。
Swagger / OpenAPI
覆盖全部 185 个方法的 OpenAPI 3.1 规范,按 19 个分类整理;用机器人 Token 授权后,可以通过 Try it out 直接发送真实请求。
Mini App Tester
在普通浏览器的模拟(mock)模式下或在 Telegram 内测试 Telegram.WebApp JS API:按钮、弹窗、CloudStorage、生物识别等 12 组方法,并实时记录 45 种以上的事件。
常见问题
Telegram Bot API 是什么?
它是 Telegram 官方提供的基于 HTTP 的机器人接口。程序带上机器人 Token 向 api.telegram.org 发送 HTTPS 请求,就能收发消息、管理群组和频道,响应统一为 JSON 格式。
Telegram Bot API 有中文文档吗?
官方文档(core.telegram.org)以英文为主。本站的中文教程覆盖创建机器人、Token、chat_id、Webhook 和发送消息等最常用的主题,方法名和参数保留英文原名,方便与官方文档对照。
开发 Telegram 机器人需要服务器吗?
开发和测试阶段不需要:用 getUpdates 长轮询,在自己的电脑上就能运行机器人。正式上线需要一台能长期运行程序的服务器;如果使用 Webhook,还需要一个公网可访问的 HTTPS 地址。
用什么编程语言开发 Telegram 机器人?
任何能发送 HTTPS 请求的语言都可以。Python 常用 python-telegram-bot、aiogram 和 pyTelegramBotAPI,Node.js 常用 grammY 和 Telegraf,Go 可以用 telebot 或 go-telegram-bot-api。
在本站工具中输入 Token 安全吗?
Bot API Tester 是纯前端页面:Token 只保存在你浏览器的 localStorage 中,请求直接从浏览器发往 api.telegram.org,不经过本站服务器。建议使用单独的测试机器人,一旦 Token 泄露,可以在 @BotFather 中撤销。