Тихие часы и дайджест

Тихие часы (Do Not Disturb) — пользовательское расписание, в которое Notifly не эскалирует рядовые уведомления во внешние каналы: email, SMS, звонки, чаты (Slack, Telegram, Discord, Teams, Mattermost), PagerDuty, Opsgenie и вебхуки. Срочное (приоритет не ниже порога) по-прежнему будит, всё остальное ждёт утра и приходит одной сводкой.

Настраиваются в Профиль → Тихие часы (или Cmd/Ctrl+K → «Тихие часы»), а также в Android-приложении: Настройки → Тихие часы. Это одна настройка аккаунта — она действует на всех устройствах.

Как это работает

Настройка	Что значит
Окно (start–end)	Локальное время в вашем часовом поясе. Конец раньше начала — окно через полночь (23:00–08:00)
Дни	Дни недели, по дню начала окна: флажок «пт» = с вечера пятницы до утра субботы
Часовой пояс	IANA-зона (Europe/Moscow, Asia/Yekaterinburg…). Переходы на летнее время учитываются автоматически
Порог срочности	Сообщения с приоритетом не ниже порога приходят и эскалируются как обычно. По умолчанию — 8
Сводка	По окончании окна — одно письмо на email аккаунта и сообщение-сводка в служебном канале вашей ленты

Пока окно тишины активно, воркер доставки пропускает «созревшие» методы эскалации для сообщений ниже порога и помечает их подавленными навсегда. Поэтому в 8:00 не приходит шквал SMS за всю ночь — приходит одна сводка.

Когда именно сообщение считается «ночным»

Решение принимается по моменту, когда эскалация должна была сработать — время создания сообщения плюс таймаут метода. Сообщение 22:50 с таймаутом 30 минут «созрело» в 23:20 — уже в тишине, оно попадёт в сводку. Сообщение 07:45 с тем же таймаутом созреет в 08:15 и уйдёт обычным порядком: это не «догон», а честный таймаут непрочитанного.

Чьи настройки применяются: эскалацию канала настраивает его владелец, поэтому и тихие часы берутся владельца канала.

Push-уведомления

Мгновенный push (WebSocket) сервер доставляет как обычно — тишину на устройстве отрабатывает само приложение по этим же настройкам: Android-приложение показывает уведомления ниже порога без звука, вибрации и режима будильника (с пометкой «тихие часы») и держит копию настроек, чтобы соблюдать тишину и без сети. Сообщения не теряются — они в ленте, как и днём. iOS-приложение так же показывает такие сообщения беззвучно (пока оно открыто — в фоне iOS-приложение уведомлений не получает).

Сводка

Если в окне что-то было подавлено и включена сводка, после конца окна (с запасом в несколько минут) приходит:

• письмо на email аккаунта: число сообщений по каналам, до 10 самых важных заголовков (по приоритету) и ссылка в админку;
• сообщение в служебном канале вашей ленты с той же сводкой (markdown).

Прочитанное к утру в сводку не попадает; если прочитано всё — сводки нет. Сводка уходит ровно один раз за окно.

REST API

# Текущие настройки (у нового пользователя — выключено, 23:00–08:00 MSK)
curl -H "X-Notifly-Key: $TOKEN" https://api.notifly.ru/current/user/quiet-hours

# Сохранить
curl -X PUT -H "X-Notifly-Key: $TOKEN" -H "Content-Type: application/json" \
  https://api.notifly.ru/current/user/quiet-hours \
  -d '{"enabled":true,"timezone":"Europe/Moscow","start":"23:00","end":"08:00",
       "days":[1,2,3,4,5,6,7],"breakthroughPriority":8,"digest":true}'

Тело — объект целиком; поля, которые вы не прислали, сохраняют прежнее значение. Ответ — сохранённый объект в канонической форме ("8:00" → "08:00", дни по возрастанию). Ошибки валидации — 400: неизвестная таймзона, время не HH:MM, начало равно концу, день вне 1..7, пустые дни при enabled: true, порог вне 0..10.

См. также

• Доставка и эскалация — какие методы подавляются и как работают таймауты.
• Окна обслуживания — плановые работы: тишина для каналов и мониторов, а не для человека.
• Android-приложение — где настройки применяются к push.