Куда приходят уведомления и в каком виде

Инструкция для администратора: где сотрудник увидит оповещение и как оно выглядит. Без технических кодов — только смысл настроек и порядок действий.

Для сотрудников: Чат и коммуникации, Входящие.
Текст писем и сообщений: Шаблоны уведомлений.
Параметры мессенджера (команды, каналы, правила): Настройки модуля «Чат и коммуникации».

1. Главная идея

Одно событие в системе (новый лид, назначение заявки, согласование, напоминание) должно попасть в понятное место:

1. лично — во «Входящие» как рабочая карточка (если событие адресовано человеку);
2. команде — в канал (если есть правило маршрутизации и подписчики);
3. внешне — письмом / Telegram / push (по личным настройкам сотрудника).

Не должно дублироваться:

• служебным сообщением в чате заявки/задачи на вкладке «Разговоры»;
• личным диалогом со служебным отправителем «ради уведомления»;
• отдельным списком «старого колокольчика» в шапке (по умолчанию выключено).

Иконка колокольчика в шапке открывает панель коммуникаций; счётчик берётся из «Входящих» / внимания чата.

В интерфейсе коммуникаций три вкладки:

2. Куда вообще может прийти сообщение

Личная карточка и канал могут существовать параллельно (разный смысл: «мне сделать» vs «команда видит поток»). Дублировать то же самое ещё в чат объекта и в старый колокольчик не нужно.

3. В каком виде показывается уведомление

Личные карточки во «Входящих» делятся по смыслу. От смысла зависят вкладка и то, исчезнет ли карточка после выполнения действия.

В канале событие чаще выглядит как карточка в ленте: кратко что случилось, ссылка открыть объект, иногда — обсудить в ветке. Согласовать или отклонить обычно нужно в исходном модуле (или кнопками на личной карточке, если они есть).

Письмо и внешний мессенджер показывают текст из шаблона (Настройки → Уведомления).

Важно про «Требуется действие»

• Просто открыть и прочитать карточку ≠ выполнить действие.
• Нужно сделать шаг в системе (взять лид, закрыть лид, согласовать…).
• После шага карточка должна уйти из раздела «Требуется действие».

4. Что настраивает администратор, а что — сотрудник

5. Пошаговая настройка (администратор)

Шаг 1. Включите коммуникации

1. Настройки → Основные настройки системы.
2. Включите «Модуль чата включён».
3. Сохраните.

Без этого не будет раздела «Коммуникации», каналов и доставки в чат.

Шаг 2. Проверьте общие параметры центра событий

Настройки → Чат → Общие параметры. В блоке про центр событий обычно есть такие пункты:

Рекомендация: для новых стендов сразу держите Legacy PWA-колокольчик и Notify как сообщения в Разговорах выключенными. Режимы «параллельно» / дублирование Inbox — только на период миграции типов событий. После обновления схемы seed может оставить Источник Inbox = legacy — переключите на целевой режим Event Center после проверки сценариев.

Шаг 3. Настройте команды и каналы

1. Команды — папки в дереве («Заявки», «Согласования», «CRM»…).
2. Каналы — ленты внутри папок.
3. Укажите, кто может писать обычные сообщения (все / только система / администраторы / выбранные роли).

Подробности полей: настройки модуля чата.

Шаг 4. Правила маршрутизации (Inbox и/или канал)

1. Настройки → Чат → Правила маршрутизации событий.
2. Для каждого нужного типа события задайте purpose, destination (одно значение на правило: inbox или channel и т.д.), аудиторию ролей и при необходимости целевой канал. Чтобы событие попало и во «Входящие», и в канал — заведите два правила (или опирайтесь на матрицу seed).
3. При необходимости — условия, политика доставки, snooze/dedupe.
4. Правило активно.

Без правила на канал событие не появится в ленте канала. Личная карточка создаётся отдельным маршрутом (destination = inbox / матрица) — не путайте с подпиской на канал. Подробности полей: настройки модуля чата.

Шаг 5. Текст писем и сообщений

1. Настройки → Уведомления.
2. Откройте шаблон почты или мессенджера.
3. Измените формулировки.
4. Сохраните.

Это влияет на текст, не на вкладку во «Входящих». См. Шаблоны уведомлений.

Шаг 6. Настройка браузерных Push-уведомлений (Web Push / VAPID)

Браузерные уведомления позволяют сотрудникам получать всплывающие оповещения на рабочем столе даже при свернутом браузере. Для их работы используется международный стандарт VAPID (RFC 8292).

Разница между Web Push и мобильным Push:

• Web Push (Браузер / PWA): работает через прямые push-серверы браузеров (Google FCM для Chrome/Яндекс.Браузера, Mozilla Autopush для Firefox, Apple WebPush для Safari). Для каждого сервера АСК генерируется собственная пара VAPID-ключей (публичный и приватный) и контактный email администратора.
• Мобильный Push (ASK Mobile на Android): доставляется через Legarus Push Gateway (push.legarus.ru, UnifiedPush / ntfy). Настраивается отдельно от VAPID браузера (см. шаг 6а ниже). Если у пользователя активно приложение с регистрацией mobile push, браузерный Web Push на это же мобильное устройство обычно не отправляется, чтобы не дублировать сигнал.

Как настроить VAPID для вашего сервера АСК:

Способ 1 (через пользовательский веб-интерфейс — рекомендуется):

1. Откройте Настройки → Системные настройки (или /settings/).
2. Перейдите на вкладку «Уведомления».
3. В блоке «Браузерные Push-уведомления (Web Push / VAPID)» нажмите кнопку «Сгенерировать новые VAPID ключи».
4. Поля Публичный VAPID-ключ и Приватный VAPID-ключ заполнятся автоматически.
5. В поле «Контактный email администратора» укажите ваш рабочий email (например, admin@your-company.ru).
6. Нажмите «Сохранить».

Примечание: при изменении или первичной генерации VAPID-ключей браузеры пользователей автоматически обновят подписку при следующем открытии страницы системы.

Способ 2 (через консоль сервера): Вы можете сгенерировать и сразу сохранить ключи одной командой:

.venv/bin/python manage.py generate_vapid_keys --save --email admin@your-company.ru

Способ 3 (через конфигурационные файлы / переменные окружения): Если вы настраиваете сервер через .env или config/prod_settings.py, добавьте переменные:

WEBPUSH_VAPID_PUBLIC_KEY="<сгенерированный_публичный_ключ>"
WEBPUSH_VAPID_PRIVATE_KEY="<сгенерированный_приватный_ключ>"
WEBPUSH_VAPID_ADMIN_EMAIL="admin@your-company.ru"

Сгенерировать ключи для вставки в конфиг можно командой:

.venv/bin/python manage.py generate_vapid_keys

Шаг 6а. Мобильный Push (ASK Mobile)

Нужен, если сотрудники пользуются ASK Mobile. Подробные команды и пример prod_settings.py — в INSTALL.md репозитория ask (раздел «Мобильные push / Legarus Push Gateway»). Кратко:

1. На Gateway создайте instance (create_gateway_instance) и получите client_id / client_secret / instance_id.
2. В config/prod_settings.py (или env) задайте как минимум:
3. MOBILE_PUSH_ENABLED = True
4. LEGARUS_PUSH_GATEWAY_URL / LEGARUS_PUSH_RELAY_URL (обычно https://push.legarus.ru)
5. LEGARUS_PUSH_GATEWAY_CLIENT_ID / LEGARUS_PUSH_GATEWAY_CLIENT_SECRET
6. LEGARUS_PUSH_VAPID_PUBLIC_KEY — глобальный VAPID с Gateway (не instance-ключ из вывода команды)
7. рекомендуется ASK_INSTANCE_ID
8. Запустите отдельный Celery-воркер очереди push (celery-push). Без него мобильные push глушатся backlog’ом обычных задач.
9. Перезапустите Gunicorn и Celery после смены настроек.
10. Проверьте: вход в ASK Mobile → разрешение уведомлений → тестовое событие (сообщение / карточка ACTION) → push на устройство.
11. На период cutover с режимом доставки parallel убедитесь, что path-A MOBILE_PUSH для карточек Event Center действительно планируется (регрессия закрыта в линейке ASK Mobile / ask 1.2.7).
12. При logout / удалении профиля в приложении регистрация push отзывается; для просроченной сессии push не должен уходить.

Не путать с шагом 6 (VAPID Web Push для браузера): это два разных контура.

Шаг 7. Подпишите сотрудников на каналы

Сотрудник подписывается сам в Коммуникации → Каналы, либо при внедрении выполняется массовая подписка (см. чек-лист в настройках чата).

Шаг 8. Подскажите сотрудникам личные настройки

1. Настройки доставки — галочки почта / Telegram / push по уровням важности.
2. Показать вкладку «Входящие» и кнопку Скрыть для информационных карточек.

Инструкция для пользователя: Уведомления и личные настройки.

6. Типичные сценарии

Новый лид должен быть у менеджеров во «Входящих»

1. Модуль чата и центр событий включены.
2. При создании лида система создаёт карточку «Требуется действие» получателям по правилам CRM.
3. После «взять в работу» или «закрыть лид» карточка исчезает из «Требуется действие».
4. При желании добавьте правило в канал CRM, чтобы команда видела поток в ленте.

Поток заявок в канале без личной карточки каждому

1. Создайте / проверьте канал в команде «Заявки».
2. Включите правило маршрутизации на нужный тип события.
3. Подпишите нужных сотрудников.
4. Личные карточки во «Входящих» появятся только у тех, кому событие адресовано персонально (исполнитель, согласующий и т.п.) — это отдельная логика от канала.

Переход со старого колокольчика на новые «Входящие»

1. Убедитесь, что Legacy PWA-колокольчик и Notify как сообщения в Разговорах выключены.
2. Научите людей смотреть вкладку «Входящие» и колокольчик в шапке (панель коммуникаций).
3. При необходимости прогоните очистку старых служебных сообщений notify в разговорах: python manage.py cleanup_notify_conversation_messages (параметры и dry-run — в help команды; выполняйте на стенде по регламенту сопровождения).
4. Старая история system.Notification остаётся в архиве истории уведомлений как read-only; новые события туда не пишутся.
5. Дальше — ужесточение режимов центра событий («только Event Center Inbox», «только центр событий») по типам.

7. Частые вопросы

Почему во «Входящих» пусто, а кажется, что «уведомление где-то ещё»?

Проверьте: не включён ли Legacy PWA-колокольчик или Notify как сообщения в Разговорах (оба должны быть выкл.). Также убедитесь, что Источник Inbox не «только старый», и что Event Center включён. Событие могло уйти только во внешний канал (почта / Telegram), если личная карточка для этого типа/роли не создаётся.

Почему карточка «Требуется действие» не исчезает?

Действие не выполнено в системе (например, лид не взят и не закрыт). Прочтение недостаточно.

Почему в канале пусто, а во «Входящих» карточка есть?

Нет активного правила маршрутизации на канал, или сотрудник не подписан на канал. Личная карточка и канал настраиваются отдельно.

Где править текст «Вам назначена заявка»?

Настройки → Уведомления — шаблон. Это не меняет вкладку во «Входящих».

8. Чек-лист внедрения

1. Включён модуль чата.
2. В общих параметрах: Event Center вкл.; Legacy PWA-колокольчик и Notify как сообщения в Разговорах — выкл.
3. Есть нужные команды и каналы.
4. Правила маршрутизации активны.
5. Сотрудники подписаны на каналы.
6. Тексты в Настройки → Уведомления согласованы с компанией.
7. Сотрудникам показано, где Настройки доставки и вкладка «Входящие» (включая Скрыть).
8. Проверен сценарий «нужно действие» (например, лид): карточка появляется и пропадает после взятия / закрытия; не появляется в чате объекта как служебное сообщение.
9. Если нужен ASK Mobile: MOBILE_PUSH_ENABLED + Gateway credentials + воркер celery-push RUNNING; тестовый push на устройство; Web Push на том же телефоне не дублирует app.

См. также

• Настройки модуля «Чат и коммуникации»
• Шаблоны уведомлений
• ASK Mobile (пользователь)
• Входящие (пользователь)
• Каналы (пользователь)
• Уведомления (пользователь)
• Mobile API overview