Telegram Bot API Toolkit

Three HTML files for testing, documenting, and debugging Telegram bots and Mini Apps — no server, no build, no dependencies. Available at telegram-bot-api.info, just open in a browser.

Bot API Tester

185 methods Long Polling JSON Viewer Dark theme

Interactive tester for all Telegram Bot API 10.3 methods. Paste your bot token, select a method, fill in the parameters — and get instant results. Long polling for real-time updates, collapsible JSON viewer, color-coded update types.

Swagger Documentation

OpenAPI 3.1 185 methods Authorize

Complete Swagger/OpenAPI documentation for Telegram Bot API 10.3. Interactive interface with token authorization, methods grouped by category, links to official docs for each method. Try any method right from the browser.

Mini App Tester

45+ events 13 categories Mock mode RU / EN

JavaScript API tester for Telegram Mini Apps. Live WebApp properties panel, execute all methods (MainButton, HapticFeedback, CloudStorage, BiometricManager, Sensors and more), real-time event log. Mock mode for browser testing. For real testing — just set the link in @BotFather, no self-hosting needed.

How to start

Step-by-step instructions for each tool

Bot API Tester

Open telegram-bot-api-tester.html in your browser
Get a bot token from @BotFather on Telegram
Paste the token in the top field — it saves automatically
Select an API method from the list or search, fill in the parameters
Click "Execute" or press Ctrl+Enter
To receive updates, click "Start" in the Updates panel

No server needed — Telegram Bot API supports CORS, requests work directly from the browser. Token and history are saved in localStorage.

Swagger Documentation

Open telegram-bot-api-swagger.html in your browser
Click the Authorize button and enter your bot token
Select a method from the categorized list
Click Try it out, fill in parameters and Execute

Each method includes a link to the official documentation. Authorization is done once — the token is applied to all requests.

Mini App Tester

Open telegram-mini-app-tester.html in your browser — Mock mode activates
For real testing: create a Mini App via @BotFather with the /newapp command
Set the URL to: https://telegram-bot-api.info/telegram-mini-app-tester.html
Open the Mini App via https://t.me/yourbot/appname
The interface automatically adapts to the Telegram user's theme

No self-hosting needed — files are already available at telegram-bot-api.info. Mock mode emulates Telegram.WebApp for testing directly in the browser. When opened inside Telegram, the real API is used automatically.

Requirements

Minimum to get started

Modern browser

Chrome 80+, Firefox 80+, Safari 14+, Edge 80+. No installation needed.

Bot Token

Get from @BotFather on Telegram. Format: 123456:ABC-DEF...

No dependencies

Each file is a fully self-contained HTML. No npm, webpack, or servers.

Telegram bot guides

Step-by-step guides with copy-paste curl, Python and JavaScript: create a bot, get its token and chat id, set up a webhook, send messages and stay within the limits.

How to Create a Telegram Bot: Step by Step with BotFather and PythonHow to create a Telegram bot step by step: register it with @BotFather, get the token, test it with getMe and send a first message with curl or Python. Telegram Bot API 10.0–10.3: Rich Messages, Ephemeral Messages, Guest Mode and MoreWhat's new in Telegram Bot API 10.0–10.3: guest mode, rich messages, streamed drafts, ephemeral messages, join request queries, with JSON examples. Telegram Bot API Limits: Rate Limits, 429 Errors, File Sizes and Message LengthTelegram Bot API rate limits explained: 30 msg/s, 1 msg/s per chat, 20/min in groups, handling 429 retry_after, plus file size and message length limits. How to Send a Message with the Telegram Bot API (sendMessage)Telegram Bot API send message guide: sendMessage with curl, Python and JavaScript, HTML and MarkdownV2 formatting, inline buttons and error fixes. Telegram Bot Token: How to Get It, Find It Again, Check It and Keep It SafeTelegram bot token guide: get one from @BotFather, find the token of an existing bot, check it with getMe, revoke a leaked token and store it safely. How to Set Up a Telegram Bot Webhook: setWebhook, Secret Token and TroubleshootingSet up a Telegram bot webhook: setWebhook URL requirements, secret_token header check, getWebhookInfo debugging, deleteWebhook and fixes for n8n. How to Get a Telegram Chat ID for a User, Group, Channel or TopicHow to get a Telegram chat ID for a user, group, supergroup, channel or forum topic with getUpdates, plus fixes for an empty result and 409 Conflict. How to Test a Telegram Mini App: From Browser Mock to Real TelegramTest a Telegram Mini App step by step: browser mock mode, localhost via HTTPS tunnel, test environment, DevTools per platform, initData validation.

Guides → · Methods (185) →

Getting started with Telegram bots

What is the Telegram Bot API?

An HTTP-based interface for building Telegram bots. Your code calls methods such as sendMessage on api.telegram.org, with the bot token in the URL, and receives incoming messages as JSON updates via getUpdates or a webhook.

Do I need a server to run a Telegram bot?

Not to get started: long polling with getUpdates works from any computer, even behind NAT. A bot that should always be available needs something that runs continuously, such as a VPS, a container or a serverless function, and webhooks also need a public HTTPS URL.

What is the difference between the Bot API and the Telegram API?

The Bot API is a simple HTTPS and JSON interface for bot accounts. The Telegram API (MTProto) is the protocol behind the Telegram apps and is used to build custom clients that log in as users with an api_id and api_hash. Most bots only need the Bot API.

Can a Telegram bot read all messages in a group?

Not by default. In privacy mode, which is on for new bots, a bot sees only commands meant for it, replies to its messages and service messages. Make the bot an administrator, or turn privacy mode off with /setprivacy in @BotFather and re-add the bot to the group.

Is telegram-bot-api.info an official Telegram website?

No. It is an independent project, not affiliated with Telegram. The tools call the public Bot API directly from your browser, and the authoritative reference is the official documentation at core.telegram.org/bots/api.

Other languages

فارسی · 简体中文 · Türkçe · Español · Português (Brasil) · Tiếng Việt · Bahasa Indonesia · 한국어