Все статьи

Бот упирается в лимиты API: как организовать очередь отправки

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

Архивная запись полностью переработана 2 ноября 2026 года.

Определите, что ждёт отправки

Для учебного сервиса есть ответы клиентам и плановые уведомления. У них может различаться срочность, но правило очередности нужно согласовать. Не допускайте, чтобы большая рассылка незаметно вытеснила обычный ответ на свежий вопрос.

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

Учебные состояния отправки
СостояниеДействие системы
ОжидаетДождаться разрешённой попытки
В обработкеИсключить параллельное выполнение
ОтправленоСохранить подтверждённый результат
Требует разбораПоказать ошибку ответственному

Читайте ответ поставщика

MDN описывает HTTP 429 как сигнал слишком частых запросов. Ответ может содержать Retry-After с указанием ожидания. Формат ограничений конкретного API проверяйте в его текущей документации, не перенося численные значения из другого сервиса.

Согласуйте ограниченные повторы с увеличением ожидания там, где это уместно. Ошибка доступа или неверный получатель обычно требуют другого действия, чем временное ограничение. Повторять всё одинаково до бесконечности неудобно и для сервера, и для человека.

Сохраните смысл сообщения

К моменту отправки условия могут измениться. Напоминание по отменённой записи уже не нужно. Для таких задач перед выполнением проверьте актуальное состояние связанной записи и примените согласованное правило отмены.

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

Испытайте очередь в тестовой среде

  1. Подготовьте небольшой набор отличимых задач.
  2. Воспроизведите ограничение разрешённым тестовым способом.
  3. Проверьте время повторной попытки и порядок задач.
  4. Перезапустите обработчик и убедитесь в сохранности очереди.
  5. Отмените связанную запись до отправки напоминания.

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

Предусмотрите сообщение для сотрудника при существенном сбое и порядок ручного разбора. Задача не считается доставленной только потому, что она исчезла с экрана панели.

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

Какие сообщения вашего бота должны проходить раньше плановых уведомлений?