Уведомления

ONREZA отправляет уведомления о важных событиях: деплоях, ошибках, биллинге и безопасности. Вы можете настроить каналы доставки и фильтры для каждой категории.

ONREZA доставляет уведомления по трём каналам — email, в панели управления (in-app) и в Telegram — и сортирует их по категориям и приоритету. Ниже описано, как выбрать каналы, настроить фильтры и тихие часы.

Каналы доставки

Email

Уведомления на почту, привязанную к аккаунту:

• HTML письма с брендированным дизайном
• Категорийные шаблоны (деплои, биллинг, безопасность)
• Приоритетные индикаторы (иконки для critical/high)

In-App

Уведомления внутри платформы:

• Real-time доставка через SSE
• Inbox с историей уведомлений
• Индикатор непрочитанных (blue dot)
• Архивация и удаление

Telegram

Уведомления в Telegram через бота ONREZA:

• Мгновенная доставка
• Поддержка форматирования (жирный, ссылки)
• Кнопки быстрых действий

Заметка

Канал Telegram доступен только для пользователей, вошедших через Telegram. При входе через Telegram канал включается автоматически вместо Email.

Категории уведомлений

Категория	Описание	Примеры
Deployment	События деплоев	Сборка завершена, деплой live, ошибка
Health	Здоровье приложений	Health check failed, восстановление
Billing	Платежи и подписки	Оплата прошла, лимит превышен
Security	Безопасность аккаунта	Новый вход, подозрительная активность, API ключи
System	Системные события	Плановые работы, новые функции

События Security

Событие	Приоритет	Описание
security.new_login	Normal	Новый вход в аккаунт
security.suspicious_activity	Critical	Подозрительная активность обнаружена
security.api_key_created	Normal	Создан новый API ключ
security.api_key_revoked	High	API ключ отозван
security.password_changed	Critical	Пароль аккаунта изменён
security.two_factor_enabled	Normal	Двухфакторная аутентификация включена
security.two_factor_enrollment_started	Normal	Начата настройка двухфакторной аутентификации

Приоритеты

Система использует 4 уровня приоритета для классификации важности уведомлений:

Приоритет	Значение	Описание	Поведение
CRITICAL	0	Критические события	Всегда отправляются на все каналы, игнорируют quiet hours
HIGH	1	Важные события	Отправляются даже в quiet hours (кроме email), требуют внимания
NORMAL	2	Стандартные события	Отправляются согласно настройкам пользователя
LOW	3	Информационные	Могут быть отфильтрованы, не требуют немедленного действия

Заметка

Critical уведомления (ошибки сборки, подозрительная активность, изменение пароля) всегда доставляются независимо от ваших настроек.

Настройка каналов

Account → Settings → Notifications → Channels

1. Выберите канал

   Email, In-App или Telegram (если доступен)

2. Включите/выключите

   Toggle для активации канала

3. Сохраните

   Изменения применяются сразу

Осторожно

Отключение всех каналов не рекомендуется — вы можете пропустить критически важные уведомления.

Настройка по категориям

Account → Settings → Notifications → Preferences

Для каждой категории можно настроить:

Настройка	Описание
Каналы	Какие каналы использовать для этой категории
Минимальный приоритет	Отправлять только уведомления с приоритетом >=
Quiet Hours	Время, когда email не отправляется (только In-App)

Пример настройки

Deployment:
  Каналы: Email, In-App
  Мин. приоритет: NORMAL
  Quiet Hours: 22:00 - 08:00

Billing:
  Каналы: Email, In-App
  Мин. приоритет: NORMAL
  Quiet Hours: —

Security:
  Каналы: Email, In-App
  Мин. приоритет: LOW
  Quiet Hours: —

Health:
  Каналы: Email, In-App
  Мин. приоритет: HIGH
  Quiet Hours: —

Quiet Hours (Тихие часы)

Email уведомления не отправляются в указанный период:

• Время указывается в UTC
• In-App уведомления продолжают приходить
• CRITICAL уведомления игнорируют quiet hours

1. Откройте настройки категории
2. Включите “Quiet Hours”
3. Укажите время начала и конца
4. Сохраните

Inbox

В правом верхнем углу интерфейса находится иконка уведомлений:

• Blue dot — есть непрочитанные
• Число — количество непрочитанных

Возможности Inbox:

• Просмотр истории уведомлений
• Отметка как прочитанное (клик)
• Архивация (смахивание или кнопка)
• Удаление
• Переход по action URL

События деплоев

Событие	Приоритет	Описание
deployment.started	LOW	Деплой запущен
deployment.building	LOW	Сборка началась
deployment.build_success	LOW	Сборка успешна
deployment.build_failed	CRITICAL	Ошибка сборки
deployment.live	NORMAL	Деплой активен
deployment.failed	CRITICAL	Ошибка деплоя
deployment.stopped	NORMAL	Деплой остановлен
deployment.rolled_back	NORMAL	Откат выполнен

События биллинга

Событие	Приоритет	Описание
billing.payment_succeeded	NORMAL	Платёж прошёл
billing.payment_failed	CRITICAL	Ошибка платежа
billing.invoice_created	LOW	Счёт создан
billing.invoice_paid	NORMAL	Счёт оплачен
billing.invoice_overdue	HIGH	Счёт просрочен
billing.trial_ending_soon	HIGH	Trial заканчивается
billing.trial_ended	HIGH	Trial закончился
billing.limit_approaching	NORMAL	Приближение к лимиту
billing.limit_exceeded	HIGH	Лимит превышен
billing.subscription_cancelled	NORMAL	Подписка отменена
billing.subscription_suspended	CRITICAL	Подписка приостановлена
billing.card_expiring_soon	HIGH	Карта скоро истечёт
billing.card_expired	CRITICAL	Карта истекла

События здоровья

Событие	Приоритет	Описание
health.check_failed	HIGH	Health check не прошёл
health.recovered	NORMAL	Приложение восстановлено

Системные события

Событие	Приоритет	Описание
system.maintenance_scheduled	NORMAL	Плановые работы
system.feature_announcement	LOW	Новые функции

API

Получить уведомления

GET /v1/notifications?archived=false&limit=20

Query параметры:

• archived — true для архива, false для inbox
• unreadOnly — только непрочитанные
• category — фильтр по категории
• priority — фильтр по приоритету (CRITICAL, HIGH, NORMAL, LOW)
• limit, offset — пагинация

Проверить непрочитанные

GET /v1/notifications/has-unread

Возвращает { hasUnread: true/false } — используется для blue dot.

Пометить как прочитанное

POST /v1/notifications/:id/read

Архивировать

POST /v1/notifications/:id/archive

Архивировать все

POST /v1/notifications/archive-all

Удалить

DELETE /v1/notifications/:id

Удалить все архивные

DELETE /v1/notifications/delete-all-archived

Счётчики и настройки

GET /v1/notifications/has-unread
GET /v1/notifications/inbox-count
GET /v1/notifications/preferences
PUT /v1/notifications/preferences/channel
PUT /v1/notifications/preferences/category

Web Push

GET /v1/notifications/vapid-key
POST /v1/notifications/push-subscription
GET /v1/notifications/push-subscription
DELETE /v1/notifications/push-subscription/:id

Real-time уведомления

Dashboard обновляет Inbox через real-time соединение приложения. Для внешней автоматизации используйте REST endpoints выше: GET /v1/notifications, GET /v1/notifications/has-unread и GET /v1/notifications/inbox-count.

Дефолтные настройки

При регистрации устанавливаются настройки в зависимости от способа входа:

Email регистрация:

Категория	Каналы	Мин. приоритет
Deployment	Email, In-App	NORMAL
Health	Email, In-App	HIGH
Billing	Email, In-App	NORMAL
Security	Email, In-App	LOW
System	Email, In-App	NORMAL

Telegram регистрация:

Категория	Каналы	Мин. приоритет
Deployment	Telegram, In-App	NORMAL
Health	Telegram, In-App	HIGH
Billing	Telegram, In-App	NORMAL
Security	Telegram, In-App	LOW
System	Telegram, In-App	NORMAL

Совет

Security имеет минимальный порог LOW — вы получите все уведомления о безопасности. Health имеет HIGH — только важные события мониторинга.

Troubleshooting

Не приходят email уведомления

1. Проверьте папку спам
2. Проверьте что канал Email включён
3. Проверьте настройки категории — возможно фильтр по приоритету
4. Проверьте quiet hours — возможно сейчас тихие часы

Не вижу уведомления в Inbox

1. Проверьте что канал In-App включён
2. Обновите страницу
3. Проверьте фильтр категорий в настройках

Слишком много уведомлений

1. Повысьте минимальный приоритет для шумных категорий
2. Отключите канал Email для информационных событий
3. Настройте quiet hours для ночного времени

См. также

• API Tokens — управление токенами
• Настройки — обзор настроек аккаунта