Telegram Bot API 测试工具

Bot API Tester 是一个免费的 Telegram Bot API 在线测试工具，打开浏览器就能直接调用 Telegram Bot API：粘贴 Bot Token，从 Bot API 10.3 的 185 个方法中任选一个，填写按类型生成的参数表单，立即就能看到 JSON 响应。无论是做 Telegram 机器人测试、进行 Bot Token 检测，还是排查某个出错的请求，都不用写代码，也不必安装 Postman。

如何使用 Telegram Bot API 在线测试工具

1. 在 @BotFather 中发送 /newbot 创建机器人并拿到 Token（详见 Telegram Bot Token 获取教程）。
2. 把 Token 粘贴到页面顶部的输入框中，它只会保存在你浏览器的 localStorage 里。
3. 运行 getMe。Token 有效时会返回机器人的 User 对象；返回 401 Unauthorized 则说明 Token 错误或已被撤销。
4. 从 19 个分类中选择方法，或直接搜索方法名；也可以用 URL 锚点直接打开某个方法，例如 telegram-bot-api-tester.html#sendMessage。
5. 填写参数（必填项会有标记），点击“执行”或按 Ctrl+Enter。
6. 在可折叠的 JSON 查看器中查看结果，复制需要的字段。

Telegram 机器人测试的常见场景

• Bot Token 检测。getMe 就是最简单的 Token 检测器：调用一次就能确认 Token 是否有效、属于哪个机器人。
• 获取 chat id。启动 Long Polling（长轮询），给机器人发一条消息，在更新历史中读取 message.chat.id；更新历史会保留最近 100 条更新。群组和频道的做法见 Telegram chat id 获取方法。
• 调试消息和格式。先在这里试好 sendMessage 的 parse_mode、内联键盘和链接预览，再写进代码，参见 用 Bot API 发送消息。
• 管理 Webhook。按照 Telegram Bot Webhook 设置教程 调用 setWebhook、getWebhookInfo 和 deleteWebhook。
• 体验 Bot API 10.x 新功能。富文本消息、临时消息、入群申请查询等新方法和经典方法放在一起，填入 Token 即可调用。

设置了 Webhook 时 getUpdates 无法使用，所以开始 Long Polling 时，测试工具会先调用 deleteWebhook（待处理的更新会保留）。如果你的机器人在生产环境中使用 Webhook，测试结束后记得用 setWebhook 恢复。

测试时常见的错误

• 401 Unauthorized：Token 无效或已被撤销，请到 @BotFather 中查看当前的 Token。
• 400 Bad Request: chat not found：chat_id 写错了，或者机器人无法访问这个聊天（例如还没有被加入群组）。
• 403 Forbidden: bot was blocked by the user：用户已屏蔽机器人，无法再给他发消息。
• 409 Conflict：设置了 Webhook 时调用了 getUpdates，先调用 deleteWebhook。
• 429 Too Many Requests：请求过于频繁，等待 parameters.retry_after 指定的秒数后再试。

隐私：Token 只保存在你的浏览器中

测试工具是一个没有后端的静态页面。Token 保存在浏览器的 localStorage 中，每个请求都从你的浏览器直接发送到支持 CORS 的 api.telegram.org，Token 和 API 流量都不会经过我们的服务器。即便如此，做实验时最好还是单独创建一个测试机器人。

更多工具与参考

在 Swagger 中浏览每个方法的 OpenAPI 3.1 描述，在 Mini App Tester 中测试 Telegram.WebApp JavaScript API，或打开 方法参考 查看参数说明以及 curl、Python、JavaScript 示例。还没有机器人？先阅读 创建 Telegram 机器人教程。