Лимиты API — как не сломать бот или автоматизацию

Лимит API редко выглядит как проблема на первом тесте. Он появляется, когда несколько заявок приходят одновременно, менеджер делает повторный клик или запуск включает большую базу. Поэтому лимит — это часть сценария автоматизации, а не ошибка, которую стоит заметить только после 429.

Что проверить до запуска

• сколько объектов приходит в обычный и пиковый час;
• есть ли массовая отправка и как получатели дали согласие на сообщения;
• может ли один входящий объект прийти повторно;
• что уже успел сделать сценарий, если следующий API-вызов временно не принят;
• где команда увидит задержку и как безопасно продолжит обработку.

Telegram Bot API

В текущем Telegram Bots FAQ указаны разные пределы для разных ситуаций:

• в один чат лучше не отправлять больше одного сообщения в секунду в один чат;
• в группу бот не может отправить больше 20 сообщений в минуту в группу;
• для массовых уведомлений разным пользователям действует ориентир около 30 сообщений в секунду без платного ускорения.

При превышении лимита Telegram возвращает 429 и параметр retry_after. Сценарий должен ждать именно это время, а затем продолжать очередь. Повтор нельзя делать вслепую — сначала нужно знать, не было ли сообщение уже принято или создана ли запись в CRM.

ИИ-сервисы и другие API

У ИИ-провайдеров лимиты зависят от проекта, модели, платежного уровня и текущего состояния аккаунта. Перед запуском смотрите official docs и кабинет именно того проекта, который будет платить за запросы. Не переносите цифры из старого гайда в новый workflow.

Для API с платным вызовом или необратимым действием нужны четыре слоя:

1. очередь с ограничением параллельности;
2. постоянный идентификатор операции, чтобы повтор не создал дубль;
3. ограниченное число повторов с паузой и записью причины;
4. понятный статус для человека, если автоматизация не может продолжить сама.

n8n и массовые сценарии

В n8n задержка сама по себе не решает проблему. Для списка объектов разделите их на порции, сохраняйте статус каждой операции и выводите ошибку в отдельный маршрут. Нода Wait подходит для паузы, но не заменяет проверку дубля и readback результата.

Перед включением рассылки или массовой обработки прогоните маленький согласованный набор. Проверьте не только успешную отправку, но и 429, повторную заявку, пустые данные и недоступность внешнего сервиса.