При HTTP 429 не отправляйте сообщение немедленно повторно. Slack возвращает `Retry-After` в секундах; очередь должна отложить именно ограниченный метод для конкретного workspace, сохранить сообщение и продолжить только после указанного времени. Цикл мгновенных retry увеличивает задержку и способен создать дубли, когда часть ответов потерялась по сети.

Для публикации сообщений Slack указывает общий ориентир — примерно одно сообщение в секунду на канал, при этом существует и workspace-wide предел. Короткие всплески могут пройти, но их точный запас не публикуется и не должен становиться частью расчёта. Проектируйте устойчивый поток, а burst воспринимайте как бонус, а не гарантию.

Очередь должна знать два адреса ограничения

КлючЧто ограничиваетСостояние планировщика
workspace + methodWeb API rate tier для установки приложенияblocked_until из Retry-After
workspace + channelТемп публикации сообщений в каналnext_allowed_at и длина очереди
workspace globalОбщий объём сообщений приложенияСнижение общего concurrency
delivery idПовтор одной бизнес-доставкиsent, retrying или failed

Разделение важно: 429 для `conversations.info` не обязательно блокирует `chat.postMessage`, а ограничение одного workspace не должно останавливать остальные. Slack описывает Web API windows как per method, per app, per workspace. Однако для сообщений дополнительно действует особая политика канала и общий предел workspace.

Обработка ответа сохраняет смысл сообщения

async function deliver(job) {
  const response = await slack.chat.postMessage(job.payload);

  if (response.status === 429) {
    const seconds = Number(response.headers.get('retry-after'));
    await queue.defer(job.id, {
      until: Date.now() + seconds * 1000,
      reason: 'slack_rate_limit',
    });
    return;
  }

  if (!response.ok) throw new RetryableSlackError(response);
  await queue.markSent(job.id, response.ts);
}

Пример условный: официальный SDK может возвращать status и headers через собственный тип ошибки, поэтому адаптируйте ветку к своей библиотеке. Сохраняйте `job.id` до сетевого вызова. Если соединение оборвалось после того, как Slack принял сообщение, повтор без дедупликации может создать вторую копию.

Массовое уведомление часто лучше превратить в сводку

Сто однотипных событий о фоновых задачах редко требуют ста отдельных сообщений. Соберите их за короткое окно по каналу и отправьте одну сводку: число ошибок, период, ссылка на фильтр и несколько примеров. Критическое событие оставьте отдельным, а обновления его состояния пишите в thread или редактируйте исходное сообщение, если это соответствует сценарию.

  • Группируйте по получателю, каналу и типу события, а не только по времени.
  • Не смешивайте предупреждение и восстановление так, чтобы потерялся итоговый статус.
  • Ограничьте размер payload и число Block Kit elements до отправки.
  • Добавьте срок годности: устаревшее оперативное уведомление может быть бесполезно после длинной очереди.

Повтор после 429 отличается от повторной бизнес-команды

Retry-After говорит, когда снова вызвать Slack API, но не решает идемпотентность вашей системы. Стабильный delivery key строится из бизнес-события и назначения. Повторный webhook, restart worker или ручной replay находят существующую запись и продолжают её, а не создают новое сообщение.

Не отмечайте задачу sent до подтверждённого ответа Slack. При неизвестном результате используйте отдельное состояние `uncertain` и политику сверки, если канал допускает поиск по сохранённым метаданным. Бесконечный автоматический retry для permanent error вроде `channel_not_found` только засоряет очередь.

Нагрузочный тест не должен спамить рабочий канал

  1. Создайте отдельный тестовый workspace или закрытый канал.
  2. Поставьте в очередь контролируемую партию с уникальными delivery keys.
  3. Зафиксируйте темп отправки, первый 429 и его Retry-After.
  4. Перезапустите worker во время ожидания и убедитесь, что расписание сохранилось.
  5. Проверьте количество сообщений в Slack и состояний sent — они должны совпасть.

В рабочем мониторинге нужны длина очереди, возраст старейшей задачи, число 429 по workspace/method, доля permanent errors и количество дедуплицированных повторов. Токены, полный текст приватных сообщений и имена закрытых каналов в общий лог не включайте.

Проверенные источники