Набор инструментов для Telegram Bot API

Три HTML-файла для тестирования, документации и отладки Telegram ботов и Mini Apps — без сервера, без сборки, без зависимостей. Доступны на telegram-bot-api.info, просто откройте в браузере.

Bot API Tester

185 методов Long Polling JSON Viewer Тёмная тема

Интерактивный тестер для всех методов Telegram Bot API 10.3. Вставьте токен бота, выберите метод, заполните параметры — и мгновенно получите результат. Long polling для получения обновлений в реальном времени, сворачиваемый JSON-просмотрщик, цветовая подсветка типов обновлений.

Swagger Documentation

OpenAPI 3.1 185 методов Authorize

Полная Swagger/OpenAPI документация для Telegram Bot API 10.3. Интерактивный интерфейс с авторизацией по токену, группировка методов по категориям, ссылки на официальную документацию для каждого метода. Попробуйте любой метод прямо из браузера.

Mini App Tester

45+ событий 13 категорий Mock-режим RU / EN

Тестер JavaScript API для Telegram Mini Apps. Живая панель свойств WebApp, выполнение всех методов (MainButton, HapticFeedback, CloudStorage, BiometricManager, Sensors и др.), лог событий в реальном времени. Mock-режим для браузера. Реальный тест — просто укажите ссылку в @BotFather, свой хостинг не нужен.

Как начать

Пошаговые инструкции для каждого инструмента

Bot API Tester

Откройте telegram-bot-api-tester.html в браузере
Получите токен бота у @BotFather в Telegram
Вставьте токен в поле вверху страницы — он сохранится автоматически
Выберите метод API из списка или через поиск, заполните параметры
Нажмите «Выполнить» или Ctrl+Enter
Для получения обновлений нажмите «Старт» в панели Updates

Сервер не нужен — Telegram Bot API поддерживает CORS, запросы работают прямо из браузера. Токен и история сохраняются в localStorage.

Swagger Documentation

Откройте telegram-bot-api-swagger.html в браузере
Нажмите кнопку Authorize и введите токен бота
Выберите метод из списка по категориям
Нажмите Try it out, заполните параметры и Execute

Каждый метод содержит ссылку на официальную документацию. Авторизация проводится один раз — токен подставляется во все запросы.

Mini App Tester

Откройте telegram-mini-app-tester.html в браузере — заработает Mock-режим
Для реального теста: создайте Mini App через @BotFather командой /newapp
Укажите URL: https://telegram-bot-api.info/telegram-mini-app-tester.html
Откройте Mini App через https://t.me/yourbot/appname
Интерфейс автоматически подстроится под тему Telegram пользователя

Никакой свой хостинг не нужен — файлы уже доступны на telegram-bot-api.info. Mock-режим эмулирует Telegram.WebApp для тестирования прямо в браузере. При открытии внутри Telegram автоматически используется настоящий API.

Требования

Минимум для начала работы

Современный браузер

Chrome 80+, Firefox 80+, Safari 14+, Edge 80+. Никаких установок.

Bot Token

Получите у @BotFather в Telegram. Формат: 123456:ABC-DEF...

Без зависимостей

Каждый файл — полностью автономный HTML. Никакого npm, webpack, серверов.

Гайды по Telegram Bot API

Пошаговые инструкции с готовым кодом на curl, Python и JavaScript: от создания бота в @BotFather до вебхуков, лимитов и новинок Bot API 10.3.

Как создать бота в Телеграм: от @BotFather до первого сообщенияКак создать бота в Телеграм: регистрация в @BotFather, токен, проверка через getMe, первое сообщение на curl и Python, команды и описание бота. Что нового в Telegram Bot API 10.0–10.3: rich-сообщения, эфемерные сообщения и гостевой режимЧто нового в Telegram Bot API 10.0–10.3: rich-сообщения, эфемерные сообщения, гостевой режим, заявки на вступление — с примерами и чек-листом миграции. Лимиты Telegram Bot API: сообщения в секунду, ошибка 429 и размеры файловВсе лимиты Telegram Bot API в одном месте: сообщения в секунду, ошибка 429 и retry_after, платные рассылки, размеры файлов, длина текста и подписи. Как отправить сообщение через бота Telegram: sendMessage, разметка и кнопкиКак отправить сообщение через бота Telegram: sendMessage на curl, Python и JavaScript, parse_mode HTML и MarkdownV2, кнопки и ошибки 400, 403, 429. Токен бота Telegram: как получить, где найти, как проверить и отозватьКак получить токен бота Телеграм в @BotFather, где взять токен уже созданного бота, как проверить его через getMe и что делать, если токен утёк. Вебхук для Telegram-бота: настройка setWebhook, проверка и удалениеКак настроить вебхук Телеграм-бота: требования к HTTPS и портам, setWebhook с secret_token, проверка через getWebhookInfo, удаление и частые ошибки. Как узнать chat id в Telegram: пользователь, группа, канал и тема форумаКак узнать chat id в Telegram через getUpdates: личный чат, группа, супергруппа, канал и тема форума. Форматы id с -100 и что делать с пустым result. Тестирование Telegram Mini App: от браузера до отладки на телефонеТестирование Telegram Mini App по шагам: mock-режим в браузере, HTTPS-туннель для localhost, тестовая среда, DevTools на телефоне и проверка initData.

Гайды → · Методы (185) →

Частые вопросы о Telegram Bot API

Что такое Telegram Bot API?

HTTP-интерфейс, через который ваша программа управляет ботом Telegram. Каждый метод вызывается запросом к https://api.telegram.org/bot<token>/METHOD_NAME, а ответ приходит в JSON с полем ok.

С чего начать разработку Telegram-бота?

Создайте бота в @BotFather и получите токен, проверьте его методом getMe, напишите боту и ответьте ему через sendMessage. Всё это можно сделать за несколько минут прямо в Bot API Tester.

Нужен ли сервер, чтобы начать работать с Bot API?

Для первых экспериментов — нет: запросы можно отправлять из терминала через curl или из браузера. Сервер понадобится, когда бот должен работать круглосуточно или принимать апдейты через вебхук.

Как бот получает сообщения пользователей?

Двумя взаимоисключающими способами: бот сам забирает апдейты методом getUpdates (long polling), или Telegram присылает их на ваш HTTPS-адрес через вебхук. Недоставленные апдейты хранятся до 24 часов.

Telegram Bot API платный?

Нет, Bot API бесплатен. Платными бывают только отдельные возможности, например платные рассылки быстрее 30 сообщений в секунду за Telegram Stars.

Другие языки

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