28 октября 2026 г.
Скрипт работал неделю, а сегодня падает с FLOOD_WAIT, и непонятно: сломался он, забанили вас или надо просто подождать. Разбираю, что этой ошибкой говорит Telegram, как прочитать в ней время ожидания, что сделать прямо сейчас и как перестроить задачу, чтобы ошибка не возвращалась.
Ошибка FLOOD_WAIT в Telegram означает одно: одинаковых запросов к сервису было слишком много подряд, и повторить их разрешат через указанное время. Число в конце имени ошибки - это секунды ожидания. Ничего не сломалось и никого не забанили: сервис попросил подождать.
Проверено: 28 октября 2026.
Меня зовут Анастасия Майер, я архитектор контент-заводов и инженер по искусственному интеллекту: 20 систем под ключ в 10 нишах. В этих системах скрипты каждый день разбирают заявки, тянут статистику и будят менеджера, когда креатор сорвал сдачу ролика. FLOOD_WAIT я ловила на каждом из них, обычно в первый же день после запуска новой связки.
Разберу, что сервис говорит этой ошибкой, как прочитать время ожидания, чем она отличается от ошибки доступа, что сделать сейчас и как переписать задачу, чтобы вы её больше не видели.
Почему появляется ошибка FLOOD_WAIT в Telegram
Коротко: это штатная защита от слишком частых обращений. Документация Telegram относит её к группе ошибок с кодом 420 и описывает так: превышено допустимое число попыток вызвать тот же метод с теми же параметрами.
Полный текст выглядит как FLOOD_WAIT и число через подчёркивание. Описание из официальной базы ошибок переводится дословно: подождите столько-то секунд перед повторением действия. Ответ на вопрос «сколько ждать» уже лежит в самой ошибке.
Прилетает она по трём причинам, и все три бытовые:
- Цикл без паузы. Скрипт в один проход обходит сотню чатов или сообщений и бьёт в сервис без остановки. Первые запросы проходят, дальше включается защита.
- Повторный запуск после падения. Скрипт упал, вы его перезапустили, он пошёл с начала и повторил те же запросы. Ожидание от этого не сокращается.
- Два процесса на одних доступах. Запущено две копии: одна на компьютере, вторая на сервере, и обе ходят в сервис от одного аккаунта. Лимит они выедают вдвое быстрее.
У третьего случая есть сценарий пожёстче. Документация описывает ошибку AUTH_KEY_DUPLICATED: если сервер видит, что авторизованная сессия шлёт запросы параллельно с двух соединений, сессия отзывается и входить придётся заново. Забытая копия скрипта на старом ноутбуке - это не только лишние запросы, но и риск потерять сессию целиком.
У Bot API, где бот работает по токену, свои пределы по частоте отправки сообщений, и при их превышении приходит ошибка 429. Цифры живут в официальном FAQ для ботов и меняются, поэтому за ними идите по ссылке в конце статьи.
Путать это ограничение с остальными дорого: чинят тогда не то. Коды в классификации говорят разное:
- 420 - частота. Запросов слишком много, ждите указанные секунды. Код и доступы в порядке.
- 401 - доступы. Сессия отозвана или истекла, авторизация заново.
- 400 - сам запрос. Параметры не те: неверный номер, пустое поле, битое значение.
- 404 - объекта нет. Метод указан неправильно, то есть собран не тот адрес.
- 303 - запрос надо повторить в другой дата-центр, его номер лежит в тексте ошибки.
Практический вывод: увидели 420 - не меняйте ключи, не перевыпускайте токен и не переписывайте адрес. Там всё цело. Если у вас как раз ошибка доступа или битый адрес на api.telegram.org, это другой разбор, он у меня отдельной статьёй - что делать, когда api.telegram.org не работает. Откуда вообще берутся ключи клиентского доступа и чем они отличаются от токена бота, разобрано в статье про то, как получить api id и api hash Telegram.
Как исправить ошибку FLOOD_WAIT: по шагам
Коротко: выждать названное время, остановить лишние копии, добавить паузу и обработку ошибки, разбить задачу на порции.
Шаг 1. Найдите в логе полный текст ошибки. Нужна строка целиком вместе с числом, одного слова FLOOD_WAIT мало. Это ваше время ожидания в секундах. Бывает тридцать секунд, бывает несколько часов, и от этого зависит, ждать или перестраивать задачу.
Шаг 2. Остановите все процессы на тех же доступах. Не только упавший. Проверьте сервер, свой компьютер, запуск по расписанию и тестовую копию: пока вторая копия долбит сервис, пауза продлевается.
Шаг 3. Выждите названное время и не трогайте скрипт. Повторный запрос до конца паузы её не укорачивает. Документация называет FLOOD_WAIT предписанной паузой, и закрыть её можно только одним способом - дать ей пройти.
Шаг 4. Добавьте обработку этой ошибки в код. Поймали FLOOD_WAIT, прочитали число, подождали столько секунд, повторили запрос. Без этого ограничение превращается в падение, хотя сервис честно сказал, что делать.
Шаг 5. Поставьте паузу между обращениями и разбейте работу на порции. Задача вроде «обойти двести чатов» выполняется с задержкой между шагами. Обработали двадцать элементов - записали, где остановились, после паузы продолжили с этого места. Иначе каждый перезапуск начинает с начала и упирается в ту же стену.
Шаг 6. Оставьте один процесс на одни доступы и перезапустите. Одна копия, один запуск по расписанию. Если задач правда несколько, разводите их по разным ботам с отдельными токенами. После запуска смотрите лог: ошибка должна уйти или гаситься паузой автоматически.
Отдельный случай - когда ожидание измеряется часами. Это сигнал, что задача собрана неправильно. Обычно оказывается, что скрипт тянет то, что уже лежит у вас в таблице, или перечитывает всю историю вместо новых сообщений. Как собирать такую автоматизацию руками нейросетей, без программиста, я разбираю в вайбкодинге для контент-заводов: день на переписывание окупается тем, что скрипт перестаёт останавливать работу команды.
Частые ошибки и что они значат
Коротко: по тексту ошибки видно, во что вы упёрлись. Пять частых случаев.
- FLOOD_WAIT и число - запросов слишком много, подождите указанные секунды и повторите. Доступы в порядке.
- SLOWMODE_WAIT и число - в чате включён медленный режим, ограничение на отправку именно туда. Пауза в коде тут не поможет, это настройка чата.
- AUTH_KEY_DUPLICATED - запросы идут параллельно с двух соединений, сессия отозвана. Найдите вторую копию скрипта и авторизуйтесь заново.
- 429 от Bot API - бот отправляет сообщения чаще, чем позволяют лимиты ботов. Растяните рассылку по времени, пределы смотрите в FAQ для ботов.
- FLOOD_PREMIUM_WAIT и число - то же ожидание, но документация отмечает: подписка Premium его снимает.
Самая дорогая ошибка в списке даже не в коде, а в поведении: молча проглотить FLOOD_WAIT и пойти дальше. Скрипт тогда выглядит рабочим, лог чистый, а треть заявок не собрана, и через неделю вы принимаете решения по дырявой таблице.
Если не получилось
Коротко: ищите вторую копию, не ускоряйте ожидание обходными путями и смотрите на задачу целиком.
- Пройдите по всем местам, где может быть запущен ваш код: сервер, компьютер, планировщик, тестовая копия, чужой ноутбук. В девяти случаях из десяти виновата забытая копия.
- Посмотрите, что запрашивает скрипт. Если он каждый раз перечитывает всю историю, чинить надо логику, пауза тут не спасёт.
- Не сокращайте ожидание сменой адреса, новыми ключами или другим номером: ограничение привязано к доступам и к методу, а правилами сервиса такие попытки не предусмотрены.
- Если ошибка ведёт себя странно со стороны самого Telegram, пишите в официальную поддержку ботов. Изменения в лимитах публикуются в канале BotNews.
Подбираетесь к автоматизации и выбираете, что собрать первым, - посмотрите разбор с чего начать автоматизацию контента.
Частые вопросы
Коротко: ответы на то, что спрашивают сразу после первого FLOOD_WAIT.
Меня забанили? Нет. Ограничение по частоте снимается само по истечении указанного времени.
Можно ли ускорить ожидание? Честного способа нет. Остаётся подождать и уменьшить частоту запросов.
Почему вчера работало, а сегодня нет? Выросло количество данных или кто-то поднял вторую копию. Начните с поиска копий.
Это ограничение на компьютер или на доступы? На доступы и на конкретный метод с конкретными параметрами. Смена машины не поможет.
Не хотите разбираться сами
Коротко: автоматизацию можно отдать, разбор задачи бесплатный.
Пока скрипт один, FLOOD_WAIT стоит вам пятнадцати минут и одной паузы в коде. Когда скриптов пять и падают они по очереди, эти пятнадцать минут превращаются в день раскопок каждую неделю. Посчитайте: сколько стоит ваш день и сколько стоит один раз собрать это нормально.
Хотите отдать задачу целиком - собираем ботов и обвязку под ваш процесс в ИИ-разработке. Нужно сначала понять, что чинить первым, - приходите на бесплатный созвон на 20 минут или на консультацию.
Я, Анастасия Майер, собираю такие инструменты каждую неделю и выкладываю рабочие связки в Telegram-канале, а чужие задачи мы разбираем в клубе Майер. Поставьте паузу и обработку ошибки один раз, и про FLOOD_WAIT вы больше не вспомните.
Источники
- Документация Telegram: Error handling - группа ошибок 420 FLOOD: превышено допустимое число попыток вызова метода с теми же параметрами; FLOOD_WAIT_X требует ожидания X секунд, описание из базы ошибок - подождать указанное число секунд перед повторением действия; SLOWMODE_WAIT_X про медленный режим в чате; FLOOD_PREMIUM_WAIT_X снимается подпиской Premium; коды 303, 400, 401, 404 и ошибка AUTH_KEY_DUPLICATED при параллельных соединениях одной сессии. Проверено 28 октября 2026.
- Документация Telegram: Bots FAQ - лимиты рассылки у ботов, ошибка 429 при их превышении и совет растягивать рассылку по времени. Проверено 28 октября 2026.