Запрос «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 написан, остаётся уменьшить сам повод его срабатывать. Мой минимальный набор правил:
- Держать одну общую точку отправки. Все сообщения бота, включая сценарии n8n и фоновые задачи, идут через одну очередь или один лимитер, а не напрямую в API из разных мест.
- Ставить рассылку на ночь или вне пиков. Рассылка по базе и обычные ответы пользователям делят один лимит, поэтому днём первое съедает второе.
- Не редактировать сообщения слишком часто. Для прогресса обновляйте текст раз в несколько секунд, а не на каждый шаг.
- Объединять уведомления. Вместо десяти сообщений в группу за минуту отправляйте одно с перечнем событий.
- Убирать неактивных получателей. После ошибки о блокировке бота пользователя нужно исключить из следующих рассылок, это экономит запросы.
- Логировать каждый 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 с постоянно работающим процессом: его придётся настраивать, обновлять и оплачивать ежемесячно.