FloodWait в Telegram: что это и как избежать

Что такое FloodWait

FloodWait (flood_wait_X) — это временное ограничение от Telegram API, которое срабатывает при превышении лимитов на определённые действия. Параметр X означает количество секунд, на которое заблокировано действие.

Например, FloodWait(300) означает: «подождите 5 минут, прежде чем повторить это действие».

Почему возникает FloodWait

Telegram имеет внутренние rate-limit на каждый метод API. Чаще всего FloodWait появляется при:

• Слишком частых вызовах метода sendMessage (отправка сообщений)
• Быстрых инвайтах в группы (inviteToChannel)
• Массовом поиске пользователей
• Частых запросах к боту или API без пауз

Как правильно обрабатывать FloodWait в коде

В Telethon и Pyrogram FloodWait выбрасывается как исключение. Правильный подход — перехватить его и подождать указанное время:

from telethon.errors import FloodWaitError
import asyncio

try:
    await client.send_message(user, text)
except FloodWaitError as e:
    await asyncio.sleep(e.seconds + 5)  # +5 секунд запас
    await client.send_message(user, text)

Как избежать FloodWait

• Добавляйте паузы между действиями. Минимум 3–5 секунд между отправками сообщений, 30–60 секунд между инвайтами.
• Распределяйте нагрузку на несколько аккаунтов. Вместо 1 аккаунта с 100 действиями используйте 5 аккаунтов по 20.
• Используйте трастовые аккаунты. У них выше встроенные лимиты, FloodWait появляется позже.
• Не игнорируйте FloodWait в коде. Продолжение работы через ошибку ускоряет получение бана.

FloodWait vs бан: в чём разница

FloodWait — временное ограничение, которое снимается автоматически. Бан — постоянная или длительная блокировка аккаунта. FloodWait — предупреждение: если продолжать нарушать лимиты после него, следующим шагом будет уже бан.