Уведомления
Кратко
Система уведомлений информирует пользователей о событиях: новые заявки, сообщения, назначения, смены статусов, напоминания. Уведомления отображаются через иконку колокольчика в шапке с бейджем непрочитанных. Помимо внутренних уведомлений, доступна доставка через email, WhatsApp и Telegram (настраивается для каждого оператора).
Кто имеет доступ
| Роль | Получение уведомлений | Настройка каналов (матрица) | Просмотр в шапке |
|---|---|---|---|
| Администратор | Да | Да (чтение + запись) | Да |
| Руководитель | Да | Да (только чтение) | Да |
| Оператор | Да | Да (только чтение) | Да |
| Сотрудник клиента | Да (ограниченно) | Нет | Да |
Клиенты получают уведомления только о событиях, связанных с их заявками.
Безопасность: Изменять настройки уведомлений (матрицу событий × каналов) может только администратор. Операторы и руководители видят настройки, но не могут их менять — это предотвращает ситуации, когда оператор отключает уведомления и пропускает важные события.
Где найти
- Иконка колокольчика расположена в правой части шапки на всех страницах.
- Бейдж с числом показывает количество непрочитанных уведомлений.
- Нажатие на колокольчик открывает выпадающий список уведомлений.
Как работает
19 типов уведомлений (по категориям)
Заявки:
| Событие | Описание | Получатели |
|---|---|---|
| Новая заявка | Создана новая заявка | Назначенный оператор, супервизор |
| Заявка взята | Оператор взял заявку в работу | Назначенный оператор |
| Заявка завершена | Заявка выполнена | Клиент |
| Заявка переоткрыта | Клиент переоткрыл заявку | Назначенный оператор |
| Оценка готова | Оператор указал оценку времени | Клиент, утверждающий |
| Оценка согласована | Клиент согласовал оценку | Назначенный оператор |
Роли и назначения:
| Событие | Описание | Получатели |
|---|---|---|
| Назначение | Заявка назначена на оператора | Назначенный оператор |
| Переназначение (входящее) | Заявка переназначена на вас | Новый оператор |
| Переназначение (исходящее) | Ваша заявка переназначена | Предыдущий оператор |
| Добавлен участник | Вас добавили как участника | Добавленный пользователь |
| Удалён участник | Вас удалили из участников | Удалённый пользователь |
Сообщения:
| Событие | Описание | Получатели |
|---|---|---|
| Новое сообщение (оператору) | Клиент написал в заявку | Назначенный оператор |
| Новое сообщение (клиенту) | Оператор ответил в заявку | Клиент |
| Упоминание (@mention) | Вас упомянули в сообщении | Упомянутый пользователь |
Мониторинг:
| Событие | Описание | Получатели |
|---|---|---|
| SLA нарушен | Время реакции/решения превышено | Назначенный оператор, супервизор |
| Нет ответа | Заявка без ответа длительное время | Назначенный оператор |
| Напоминание | Срабатывание настроенного напоминания | Адресат напоминания |
Прочее:
| Событие | Описание | Получатели |
|---|---|---|
| Обратная связь | Клиент оставил оценку | Назначенный оператор |
| Автоматизация | Сработал триггер автоматизации | По правилу триггера |
Колокольчик и бейдж
Иконка колокольчика в шапке работает следующим образом:
- Бейдж — красный кружок с числом непрочитанных уведомлений.
- Если непрочитанных нет — бейдж не отображается.
- Число обновляется в реальном времени без перезагрузки страницы.
Выпадающий список
При нажатии на колокольчик открывается панель с уведомлениями:
- Уведомления отсортированы по дате (новые сверху).
- Непрочитанные выделены визуально (фоном или шрифтом).
- Каждое уведомление содержит: тип события, краткое описание, время.
- Нажатие на уведомление открывает связанную заявку.
Отметка о прочтении
Уведомления можно отметить как прочитанные двумя способами:
| Действие | Результат |
|---|---|
| Клик на конкретное уведомление | Это уведомление отмечается прочитанным |
| Кнопка "Отметить все прочитанными" | Все уведомления отмечаются прочитанными |
После прочтения уведомление остаётся в списке, но теряет визуальное выделение. Бейдж обновляется.
Каналы доставки
| Канал | Описание | Условие доступности |
|---|---|---|
| В приложении (in_app) | Колокольчик в шапке, всегда активен | Всегда доступен |
| Bitrix24 IM | Push-уведомления через Bitrix24 мессенджер | Тенант использует Bitrix24 |
| Письмо на email оператора/клиента | Настроен SMTP или email-канал |
Внутренние уведомления (в приложении) работают всегда и не могут быть отключены. Каналы Bitrix24 IM и Email отображаются в матрице только если доступны для вашего тенанта.
Матрица настроек (Настройки → Уведомления)
Администратор управляет уведомлениями через матрицу событие × канал:
- Строки — 19 типов событий, сгруппированных по 5 категориям
- Столбцы — доступные каналы доставки (in_app, Bitrix24, Email)
- Каждая ячейка — переключатель вкл/выкл
Иерархия настроек (3 уровня):
| Уровень | Приоритет | Кто настраивает |
|---|---|---|
| Настройки по умолчанию (системные) | Низший | Зашиты в систему |
| Настройки тенанта | Средний | Администратор (Настройки → Уведомления) |
| Настройки пользователя | Высший | Индивидуальные переопределения |
Пример: системный default для new_ticket — in_app=ON, Bitrix24=ON, Email=OFF. Администратор может включить Email для всех. Отдельный оператор может отключить Email только для себя.
Фильтрация уведомлений
Уведомления приходят только по заявкам, назначенным на оператора (или на его отдел). Системные уведомления (напоминания, назначения) приходят всегда.
Настройка
Для администратора:
- Перейдите в Настройки → Уведомления — откроется матрица событий × каналов.
- Включайте/выключайте переключатели для нужных комбинаций.
- Нажмите Сохранить — настройки применятся ко всем операторам тенанта как defaults.
- Подключение каналов доставки (Bitrix24 IM, Email) — через соответствующие интеграции.
Для оператора:
- Внутренние уведомления включены по умолчанию и не требуют настройки.
- Персональные переопределения настроек пока доступны только через API.
Безопасность уведомлений
Изоляция данных
- Все уведомления строго привязаны к тенанту (
tenant_id). Оператор одного тенанта никогда не увидит уведомления другого. - Идентификатор тенанта берётся из авторизованной сессии, а не из параметров запроса — подмена невозможна.
Контроль доступа
| Действие | Кто может | Почему |
|---|---|---|
| Просмотр настроек уведомлений | Оператор, руководитель, администратор | Прозрачность — видеть что включено |
| Изменение настроек уведомлений | Только администратор | Предотвращает отключение критических алертов |
| Получение уведомлений | Все роли (в рамках своих заявок) | Каждый видит только своё |
| Просмотр колокольчика (in-app) | Все роли | Не отключаемые |
Валидация данных
- Типы событий валидируются по белому списку (19 типов) — невозможно отправить уведомление несуществующего типа.
- Каналы валидируются (
in_app,bitrix24_im,email) — нельзя внедрить произвольный канал. - Email-адреса проверяются через
filter_var()перед отправкой.
Отказоустойчивость
- Каждый канал доставки обёрнут в
try-catch: сбой одного канала не блокирует остальные. - Если Bitrix24 API недоступен — in_app уведомление всё равно будет создано.
- Если SMTP не настроен — email-канал просто не отображается в матрице.
Частые вопросы
Можно ли отключить уведомления полностью?
Внутренние уведомления (колокольчик) отключить нельзя — это гарантирует, что критические события не будут пропущены. Email и Bitrix24 IM можно отключить через матрицу настроек.
Почему я не получаю уведомления о заявке?
Проверьте: 1) назначена ли заявка на вас; 2) не отключил ли администратор данный тип уведомлений в матрице (Настройки → Уведомления); 3) работает ли интеграция с Bitrix24 (для B24 IM уведомлений).
Сколько уведомлений хранится в списке?
В выпадающем списке отображаются последние уведомления. Старые уведомления остаются в базе данных.
Приходят ли уведомления, когда я не в сети?
In-app уведомления накапливаются и отображаются при следующем входе. Email и Bitrix24 IM доставляются независимо от онлайн-статуса.
Получают ли клиенты уведомления на email?
Клиенты получают уведомления внутри портала. Email-доставка клиентам зависит от настройки email-канала тенанта.
Кто может изменить настройки уведомлений?
Только администратор тенанта. Операторы и руководители могут просматривать текущие настройки, но не изменять их.
Может ли оператор одного тенанта видеть уведомления другого?
Нет. Все уведомления строго изолированы по тенанту. Данные одного тенанта полностью недоступны другому.
Связанные статьи
- Канал WhatsApp — настройка WhatsApp для уведомлений.
- Канал Telegram — настройка Telegram-бота.
- Канал Email — настройка email-уведомлений.
- Напоминания — создание напоминаний по заявкам.