При HTTP 429 не отправляйте сообщение немедленно повторно. Slack возвращает `Retry-After` в секундах; очередь должна отложить именно ограниченный метод для конкретного workspace, сохранить сообщение и продолжить только после указанного времени. Цикл мгновенных retry увеличивает задержку и способен создать дубли, когда часть ответов потерялась по сети.
Для публикации сообщений Slack указывает общий ориентир — примерно одно сообщение в секунду на канал, при этом существует и workspace-wide предел. Короткие всплески могут пройти, но их точный запас не публикуется и не должен становиться частью расчёта. Проектируйте устойчивый поток, а burst воспринимайте как бонус, а не гарантию.
Очередь должна знать два адреса ограничения
| Ключ | Что ограничивает | Состояние планировщика |
|---|---|---|
| workspace + method | Web 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` только засоряет очередь.
Нагрузочный тест не должен спамить рабочий канал
- Создайте отдельный тестовый workspace или закрытый канал.
- Поставьте в очередь контролируемую партию с уникальными delivery keys.
- Зафиксируйте темп отправки, первый 429 и его Retry-After.
- Перезапустите worker во время ожидания и убедитесь, что расписание сохранилось.
- Проверьте количество сообщений в Slack и состояний sent — они должны совпасть.
В рабочем мониторинге нужны длина очереди, возраст старейшей задачи, число 429 по workspace/method, доля permanent errors и количество дедуплицированных повторов. Токены, полный текст приватных сообщений и имена закрытых каналов в общий лог не включайте.