Разработка · 8 мин чтения

Too Many Requests Telegram бот: retry_after и лимиты отправки

Запрос «too many requests telegram бот» обычно появляется после первой настоящей рассылки: бот спокойно отвечал десяти пользователям, а на нескольких тысячах в логах пошли ответы 429. Ошибка штатная, Telegram так защищает свои серверы, и бороться с ней нужно не повтором запроса в цикле, а правильной скоростью отправки и уважением к полю retry_after.

Ошибка 429 Too Many Requests: что именно отвечает Telegram

Когда бот превышает допустимую частоту запросов, Bot API возвращает HTTP-код 429 и JSON такого вида:

{
  "ok": false,
  "error_code": 429,
  "description": "Too Many Requests: retry after 12",
  "parameters": {"retry_after": 12}
}

Главное здесь поле parameters.retry_after: количество секунд, которое нужно переждать до следующего запроса. Это не рекомендация, а требование. Если продолжать слать запросы во время паузы, время ожидания растёт, и по моей практике бот может «замолчать» на минуты, а в тяжёлых случаях на часы.

Важная деталь: 429 касается не только sendMessage. Под ограничение попадают editMessageText, answerCallbackQuery, getChat, массовые вызовы getChatMember и любые другие методы. Бот, который при каждом нажатии кнопки редактирует сообщение и запрашивает данные чата, упирается в лимит даже без рассылки.

Лимиты отправки сообщений в Telegram

Точные цифры лежат в официальном FAQ по Bot API, и они меняются, поэтому ниже ориентиры, которые действовали на момент написания статьи (октябрь 2026). Перед запуском проверьте их в документации.

Направление отправки Ориентир по FAQ Telegram Что это значит на практике
В один личный чат около 1 сообщения в секунду Серия ответов одному пользователю идёт с паузой, короткие всплески допустимы
В одну группу не больше 20 сообщений в минуту Бот-модератор или бот с уведомлениями в чат упирается в это первым
Массовая рассылка в целом около 30 сообщений в секунду Рассылка по базе идёт пачками, а не одним потоком на все чаты сразу

Лимиты считаются на токен бота, а не на процесс. Если у вас работают бот на aiogram и сценарий в n8n с одним и тем же токеном, их запросы суммируются. Я это видел на проекте, где основной бот отвечал пользователям, а ночной сценарий в n8n слал отчёты: днём всё работало, а ровно в момент отчёта бот начинал отвечать с задержкой, потому что оба процесса делили один лимит.

Отдельно про цифру 30 в секунду: это потолок, а не рабочая скорость. Для рассылки по базе я закладываю заметно меньше, около 20-25 сообщений в секунду, чтобы оставался запас на обычные ответы бота.

Почему лимит срабатывает неожиданно

Чаще всего причина не в большой базе, а в мелочах:

  • цикл по пользователям без пауз и без ограничения параллелизма, например asyncio.gather на всю базу сразу;
  • редактирование одного сообщения несколько раз в секунду, например для обновления таймера или прогресса;
  • повтор запроса сразу после ошибки без чтения retry_after;
  • уведомления в одну группу от нескольких событий, которые приходят одновременно.

Бесплатный материал

🎁 Полезный скрипт в подарок

Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.

Без спама. Отписка в 1 клик.

Обработка retry_after в aiogram

В aiogram 3 ответ 429 превращается в исключение TelegramRetryAfter из модуля aiogram.exceptions, у которого есть атрибут retry_after. Минимальная обёртка для отправки выглядит так:

import asyncio
from aiogram import Bot
from aiogram.exceptions import TelegramRetryAfter, TelegramForbiddenError


async def send_safe(bot: Bot, chat_id: int, text: str):
    while True:
        try:
            return await bot.send_message(chat_id, text)
        except TelegramRetryAfter as e:
            await asyncio.sleep(e.retry_after + 1)
        except TelegramForbiddenError:
            # пользователь заблокировал бота, повторять бессмысленно
            return None

Две детали, которые я добавляю всегда. Первая: к паузе прибавляю секунду, потому что отправка ровно в момент окончания таймера иногда снова даёт 429. Вторая: ошибку «бот заблокирован» отделяю от лимита, иначе цикл повторов будет бесконечно долбить чат, который уже никогда не ответит. Такого пользователя имеет смысл пометить в базе как неактивного.

Рассылка пачками

Повтор после 429 это страховка, а не способ отправки. Основная защита: сразу слать с заведомо безопасной скоростью. Для aiogram это пачки по 25 сообщений с паузой в секунду:

async def broadcast(bot: Bot, chat_ids: list[int], text: str):
    batch_size = 25
    for i in range(0, len(chat_ids), batch_size):
        batch = chat_ids[i:i + batch_size]
        await asyncio.gather(*(send_safe(bot, cid, text) for cid in batch), return_exceptions=True)
        await asyncio.sleep(1)

Если внутри пачки один запрос получил 429, он ждёт свой retry_after отдельно, но остальные соседи уже ушли. Для сотен тысяч получателей этот вариант стоит доработать общей паузой на весь процесс: при первом 429 останавливать всех, а не только того, кто его получил. Тогда бот не продолжает давить на сервер, пока один из запросов ждёт.

Готовые лимитеры есть в сторонних пакетах для aiogram, но я предпочитаю собственную обёртку из 15 строк: её поведение понятно целиком, и при смене версии библиотеки ничего не ломается.

Очередь рассылки на PHP и MySQL для обычного хостинга

Не каждому боту нужен aiogram и отдельный сервер. Если уведомления шлёт сайт на WordPress или форма с Tilda через PHP-обработчик, всё решается на обычном хостинге: хватит PHP, MySQL и cron. Отправлять сообщения прямо из обработчика формы я не советую: при всплеске заявок обработчик упрётся в 429 и потеряет уведомления. Правильнее положить сообщение в таблицу, а отправлять отдельным скриптом по cron.

Таблица очереди:

CREATE TABLE tg_queue (
  id INT AUTO_INCREMENT PRIMARY KEY,
  chat_id BIGINT NOT NULL,
  message TEXT NOT NULL,
  status ENUM('new','sent','failed') NOT NULL DEFAULT 'new',
  next_try_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  attempts TINYINT NOT NULL DEFAULT 0,
  INDEX idx_pick (status, next_try_at)
);

Скрипт-отправитель, который запускается по cron раз в минуту и работает около 50 секунд:

<?php
$token = 'ВАШ_ТОКЕН';
$pdo = new PDO('mysql:host=localhost;dbname=base;charset=utf8mb4', 'user', 'pass');

function tg_send($token, $chatId, $text) {
    $ch = curl_init('https://api.telegram.org/bot' . $token . '/sendMessage');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => ['chat_id' => $chatId, 'text' => $text],
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 20,
    ]);
    $raw = curl_exec($ch);
    curl_close($ch);
    return json_decode($raw, true);
}

$until = time() + 50;
while (time() < $until) {
    $row = $pdo->query("SELECT * FROM tg_queue WHERE status='new' AND next_try_at <= NOW() ORDER BY id LIMIT 1")->fetch(PDO::FETCH_ASSOC);
    if (!$row) { break; }

    $res = tg_send($token, $row['chat_id'], $row['message']);

    if (!empty($res['ok'])) {
        $pdo->prepare("UPDATE tg_queue SET status='sent' WHERE id=?")->execute([$row['id']]);
    } elseif (($res['error_code'] ?? 0) == 429) {
        $wait = (int)($res['parameters']['retry_after'] ?? 5) + 1;
        // откладываем всю очередь, а не одно сообщение
        $pdo->prepare("UPDATE tg_queue SET next_try_at = DATE_ADD(NOW(), INTERVAL ? SECOND) WHERE status='new'")->execute([$wait]);
    } elseif (!empty($res['error_code'])) {
        // API ответил ошибкой, повторять бессмысленно
        $pdo->prepare("UPDATE tg_queue SET status='failed', attempts=attempts+1 WHERE id=?")->execute([$row['id']]);
    } else {
        // ответа нет или он не разобран: таймаут, обрыв сети, ошибка шлюза
        $attempts = (int)$row['attempts'] + 1;
        if ($attempts >= 5) {
            $pdo->prepare("UPDATE tg_queue SET status='failed', attempts=? WHERE id=?")->execute([$attempts, $row['id']]);
        } else {
            $pdo->prepare("UPDATE tg_queue SET attempts=?, next_try_at = DATE_ADD(NOW(), INTERVAL ? SECOND) WHERE id=?")->execute([$attempts, 60 * $attempts, $row['id']]);
        }
    }
    usleep(50000);
}

Пауза usleep(50000) ограничивает темп сверху примерно 20 сообщениями в секунду, на практике выходит меньше, а при 429 откладывается вся очередь: так бот не продолжает бить в лимит другими сообщениями. Скрипт не требует VPS, он работает на тарифе обычного хостинга, если там разрешён cron и расширение curl. Если несколько копий скрипта могут пересечься, добавьте блокировку, например через GET_LOCK в MySQL, иначе одно сообщение уйдёт дважды.

Этот вариант я использую для уведомлений о заявках с сайта. Если нужна полноценная рассылка по базе подписчиков со сценариями, кнопками и сегментами, уже имеет смысл бот на aiogram, потому что там нужны асинхронность и фоновые задачи. Под такие задачи я делаю разработку Telegram-ботов от 30 000 ₽.

Как не упираться в ограничения Telegram при рассылке

Когда обработчик 429 написан, остаётся уменьшить сам повод его срабатывать. Мой минимальный набор правил:

  1. Держать одну общую точку отправки. Все сообщения бота, включая сценарии n8n и фоновые задачи, идут через одну очередь или один лимитер, а не напрямую в API из разных мест.
  2. Ставить рассылку на ночь или вне пиков. Рассылка по базе и обычные ответы пользователям делят один лимит, поэтому днём первое съедает второе.
  3. Не редактировать сообщения слишком часто. Для прогресса обновляйте текст раз в несколько секунд, а не на каждый шаг.
  4. Объединять уведомления. Вместо десяти сообщений в группу за минуту отправляйте одно с перечнем событий.
  5. Убирать неактивных получателей. После ошибки о блокировке бота пользователя нужно исключить из следующих рассылок, это экономит запросы.
  6. Логировать каждый 429 вместе со значением retry_after. Если оно выросло с нескольких секунд до десятков, значит, вы продолжали слать запросы во время паузы.

Что делать в n8n

В n8n узел Telegram при ответе 429 завершится ошибкой, если не настроен повтор. Для рассылки я ставлю цикл по пачкам и узел ожидания между ними, а на самом узле отправки включаю повтор при ошибке с паузой больше типичного retry_after. Читать значение из ответа точнее, но для простых сценариев хватает консервативной паузы. Автоматизацию такого рода я делаю как автоматизацию в n8n.

Лимиты и поведение Telegram Bot API меняются, поэтому перед запуском рассылки я сверяюсь с актуальной документацией Telegram.

Частые вопросы

Сколько ждать после ошибки 429 в Telegram-боте?

Столько, сколько указано в поле retry_after ответа, плюс небольшой запас в секунду. Значение приходит в секундах и зависит от того, насколько сильно превышен лимит. Если слать запросы во время паузы, время ожидания увеличивается.

Можно ли отключить лимиты, купив что-то у Telegram?

Официально платные возможности для массовой отправки существуют, но условия меняются, поэтому их нужно смотреть в документации Bot API на день запуска. Для обычных проектов хватает правильной очереди: она дешевле и не зависит от тарифов.

Почему лимит срабатывает, если пользователей мало?

Лимит считается по запросам, а не по числу получателей. Частое редактирование сообщений, несколько процессов с одним токеном и уведомления в одну группу дают 429 даже на базе из пары сотен человек.

Нужен ли отдельный сервер для очереди рассылки?

Нет, для уведомлений с сайта хватает PHP, MySQL и cron на обычном хостинге. Отдельный сервер понадобится для бота на aiogram с постоянно работающим процессом: его придётся настраивать, обновлять и оплачивать ежемесячно.

Есть задача?

Обсудим в мессенджере

Расскажите, что нужно сделать — отвечу в течение 4 часов в рабочее время. Первая консультация бесплатно.

Продолжая пользование настоящим сайтом Вы выражаете своё согласие на обработку Ваших персональных данных (файлов куки) с использованием Yandex.Metrika.
Понятно