Справочник по Bot API
Ограничения и их цифры
Справочник по тем лимитам Telegram Bot API, которые меняют состав возможного: потолки отправки, ограничения на размер файлов, пределы в 64 байта и 64 символа, проверка подписи, которую требует Mini App, и окна, внутри которых сообщение можно отредактировать, удалить или вернуть деньги. На каждой странице точная цифра и работающий пример.
Лимиты и механика Telegram Bot API: что входит в этот раздел
- Страниц справочника
- 50 запланировано, у каждой точная цифра и запускаемый код
- Рамки
- Только лимиты и механика Bot API — это не туториал
- Мягкие лимиты
- Помечены как приблизительные там, где Telegram не публикует точного числа
- Проверяемость
- Каждая цифра сверяется по собственной документации Telegram
As of 2025-10-01, Telegram Bot API 13.4
Как читать этот справочник
У большинства вопросов про Bot API есть точный ответ, и почти ни одна страница из поисковой выдачи его не даёт. Официальная документация — это полный справочник по методам, и она сознательно не объясняет последствий; туториалы пересказывают счастливый путь. И там, и там нет главного: цифры и того, что она делает с архитектурой. Что рассылка на сорок тысяч человек занимает двадцать две минуты, что инлайн-кнопка несёт шестьдесят четыре байта и ни символом больше, что сообщение удаляется в течение сорока восьми часов, а потом уже никогда.
Эти страницы закрывают ровно этот пробел и больше ничего. Каждая берёт один лимит или один механизм, называет его в первом предложении вместе с единицами измерения, объясняет, что он меняет в проекте, и показывает код, который обрабатывает его правильно. Они коротки намеренно. Справочная страница, которую приходится перечитывать, со своей задачей не справилась.
По ним же студия предпочла бы, чтобы о ней судили, а не по портфолио. Лимит проверяется по собственной документации Telegram меньше чем за минуту, и любой, кто писал под этот API, по одному абзацу поймёт, писал ли автор. Это более медленный способ показать, что вы разбираетесь, чем стена клиентских логотипов, и заметно более долговечный.
Там, где лимит не опубликован, а мягкий — частота отправки тут самый ясный случай, — так и написано, без сглаживания. Строить на цифре, которую сам Telegram называет приблизительной, как на договорном обязательстве, — верный способ выпустить то, что работает на тестах и ломается на объёмах, ради которых всё затевалось.
Лимиты частоты и доставка
Потолки, определяющие, как быстро вообще может что-то происходить, и гарантии доставки, определяющие, не произойдёт ли это дважды. Большинство боевых инцидентов в этом ремесле начинается здесь.
Лимит, превращающий рассылку на сорок тысяч подписчиков в двадцатидвухминутную операцию, — это
Внутри одной группы действует куда более жёсткий и совершенно отдельный бюджет — его описывает
Что сервер возвращает при превышении любого из потолков и почему обычный бэкофф делает только хуже, разбирают
Как апдейты вообще доходят до бота и что из двух способов место в продакшене, объясняет
Непроверяемый webhook принимает выдуманные апдейты от кого угодно, и этому посвящён
Почему один и тот же апдейт законно приходит дважды и что это делает с обработчиком платежа, смотрите через
Что на самом деле доказывает успешная отправка — а доказывает она меньше, чем принято считать, — разбирает
Единственный однозначный сигнал о доставке конкретному получателю описывают
Про сам справочник
Почему не читать просто официальную документацию Bot API?
Читать стоит, и эти страницы в неё ссылаются. Официальный справочник описывает, что каждый метод принимает и возвращает, — именно это справочник и должен делать, и это не то же самое, что сказать вам, что потолок отправки делает рассылку к точному времени невозможной, или что в 64 байта данных обратного вызова не влезут дата и идентификатор специалиста. Эти страницы про последствия.
Эти лимиты стабильны или меняются?
Структурные — размеры полезной нагрузки, ограничения на файлы, окно удаления — стабильны годами. Потолки частоты сам Telegram называет приблизительными и применяет адаптивно, поэтому здесь они поданы как цифры, под которые проектируют, а не как константы, на которые закладываются. Значимые изменения отслеживаются на странице изменений.
Код на этих страницах — боевой?
Это форма боевого кода, сведённая к той мысли, ради которой страница написана. Обработка ошибок, которой посвящена страница, показана целиком; та, что к делу не относится, опущена, чтобы пример оставался читаемым. Там, где что-то действительно несущее — сравнение за постоянное время при проверке init data, условная запись при выдаче слота, — это выписано, а не пересказано.
Какие из них реально создают проблемы на практике?
Примерно в таком порядке: потолки отправки, доставка не менее одного раза, 64 байта данных обратного вызова и таймаут перед подтверждением платежа. Первые два дают инциденты на объёме, третий — переделку в середине разработки, а четвёртый — сорванные платежи, которые выглядят как проблема платёжного провайдера и ею не являются.
Что почитать дальше
Каждую сборку каталога формируют описанные здесь лимиты, и все они перечислены в каталог с ценами.
Там, где из-за этих ограничений другая платформа оказывается лучшим ответом, довод изложен в сравнениях.
Про поверхность, где проверка подписи и поведение окна важнее всего, смотрите раздел про Mini Apps.
Квоты сторонних сервисов упираются раньше телеграмовских, и каждая из них описана на страницах интеграций.