Уведомления и метки приложения

Типы уведомлений

Приложение отправляет уведомления в следующих случаях:

• новое сообщение в чатах, каналах или от ботов;
• сообщение было изменено или удалено другим участником;
• входящий звонок;
• пропущенный звонок;
• событие в Smart App.

Счётчик непрочитанных событий

Если событие не было просмотрено, на значке приложения в операционной системе отображается числовая метка (счётчик).

Безопасность уведомлений

Push-уведомления не содержат текста сообщений. При получении уведомления приложение устанавливает защищённое соединение с сервером, загружает содержимое сообщения, расшифровывает его и только затем отображает пользователю.

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

Уведомления не поступают, если вы активны в любой из сессий приложения. Например, если вы читаете сообщения в веб-версии на компьютере, мобильное устройство не будет получать уведомления.

Включение и отключение уведомлений для чатов, тегов или приложения

Для управления уведомлениями:

• в чатах и каналах — вызовите контекстное меню или откройте свойства чата/канала;
• в чатах с тегами (веб/десктоп) — перейдите в Настройки → Теги;
• для всего приложения — откройте Настройки в мобильном приложении (Android) или на ПК. Для iOS и Android также можно настроить уведомления через системные настройки ОС, а для веб-версии — через настройки сайта в браузере.

Проверка уведомлений в панели администратора

Администратор корпоративного сервера может проверить статус уведомлений пользователя через панель администратора:

1. Найдите пользователя в разделе Пользователи.
2. Откройте Активации и выберите сессию на нужном устройстве. В разделе Device Meta проверьте параметры:
   • permissions.notifications — статус уведомлений в браузере (веб) или мобильной ОС (iOS/Android);
   • pushes — статус Push-уведомлений в десктоп-версии или мобильном приложении (кроме iOS, где управление осуществляется через ОС).
3. Значение false означает, что уведомления отключены, true — включены.

За доставку уведомлений отвечают следующие серверы:

• Региональный транспортный сервер (RTS), если пользователи зарегистрированы на нём или на корпоративном сервере (CTS).
• Транспортный сервер предприятия (ETS), если пользователи зарегистрированы в специальном приложении-клиенте для ETS.
  
  

  Для работы уведомлений специального брендированного приложения-клиента для ETS на устройствах Huawei и Honor администратор должен:

  • Настроить push-сервис HMS в консоли разработчика App Gallery
  • Настроить push-сервис HMS на ETS

❓Связанные вопросы:
• Массово не работают уведомления на многих устройствах

Настройка уведомлений в мобильном приложении

Чтобы управлять уведомлениями, перейдите в меню Настройки > Настройки уведомлений. Здесь можно:

• включить или отключить звуки при получении/отправке сообщений;
• скрыть или отобразить текст уведомлений с помощью настройки Показывать превью сообщения.

Настройка уведомлений для чата или канала в приложении

Чтобы настроить уведомления для конкретного чата или канала:

• нажмите и удерживайте чат или канал, затем выберите Уведомления;
• либо откройте свойства чата/канала и переключите тумблер Уведомления.

Настройка уведомлений приложения в ОС Android

Для корректной работы уведомлений включите их в настройках системы:

• Настройки > Уведомления > выберите приложение > убедитесь, что уведомления разрешены.

Для работы уведомлений на Bluetooth-устройствах (Android 12+) предоставьте приложению разрешение Устройства поблизости.

На Android 8 и выше доступны каналы уведомлений. При первичной установке приложения настройки каналов выставляются автоматически:

• включены уведомления в каналах eXpress и Voex;
• отключён звук в каналах Sync, Media и Прочее — иначе возможны дублирующие уведомления (например, при воспроизведении голосовых сообщений).

Пример корректной настройки каналов на устройствах Samsung

1. Настройки > Экран блокировки > Уведомления > Включено, а также отключите Скрыть содержимое.
2. Настройки > Приложения > выберите приложение > Уведомления > первый канал:
   • Отображение уведомлений — включено;
   • Оповещение — включено;
   • Отображение во всплывающем окне — выключено;
   • Индикаторы на значках — включено.
3. Второй канал:
   • Отображение уведомлений — включено;
   • Оповещение — включено;
   • Отображение во всплывающем окне — включено;
   • Индикаторы на значках — включено.
4. Канал Voex:
   • Отображение уведомлений — включено;
   • Оповещение — включено;
   • Отображение во всплывающем окне — включено;
   • Индикаторы на значках — выключено.

❓ Связанные вопросы:
• Уведомления на Android не работают, хотя всё настроено

Настройка звуков уведомлений приложения в ОС Android

Изменить звук уведомлений можно только на Android 8 и выше:

• Настройки > Уведомления > выберите приложение > Каналы уведомлений > измените звук для первых двух каналов.
• На Samsung: Уведомления > Дополнительные параметры > включите Управление категориями уведомлений для приложений.

Настройка меток на значке приложения в ОС Android

Управление метками на значке приложения зависит от версии Android и производителя устройства. Возможные пути настройки:

• Настройки > Уведомления и строка состояния > Значки приложений;
• Настройки > Уведомления > Значок уведомления на значке приложения;
• Настройки > Уведомления > Метки на значках приложений.

Если приложение отсутствует в списке, попробуйте изменить режим меток с чисел на точки.

❓ Связанные вопросы:
• На значке приложения метка непрочитанных сообщений, хотя все сообщения прочитаны

Учтите, что уведомления приходят без текста из чата, если он был создан, пока приложение было закрыто или сразу после включения мобильного устройства.

Настройка уведомлений в мобильном приложении

Чтобы настроить звуки входящих и исходящих сообщений, перейдите в Настройки > Настройки уведомлений в мобильном приложении.

Настройка уведомлений для чата или канала в приложении

1. Нажмите и удерживайте чат или канал, затем выберите кнопку уведомлений.
2. Либо откройте свойства чата/канала и переключите тумблер Уведомления.

Настройка уведомлений приложения в iOS

1. Откройте Настройки > Уведомления > выберите приложение.
2. Здесь можно отключить Показ миниатюр, чтобы текст сообщений не отображался в уведомлениях.
3. Убедитесь, что выбран хотя бы один способ отображения (Заблокированный экран, Центр уведомлений или Баннеры). Иначе отправитель не получит подтверждения доставки.

❓Связанные вопросы:
• Уведомления на iOS не работают, хотя всё настроено
• Сообщения отображаются недоставленными, хотя получателю на iOS они приходят
• Все уведомления на iOS приходят как «Новое сообщение»

Настройка звука уведомлений приложения в iOS

1. Перейдите в Настройки > Звуки, тактильные сигналы > Уведомления по умолчанию.
2. Чтобы отключить звук в режиме Не беспокоить, в настройках режима выберите Тишина > Всегда.

Настройка меток на значке приложения в iOS

1. Откройте Настройки > Уведомления > выберите приложение.
2. Включите опцию Наклейки.

❓Связанные вопросы:
• На значке приложения метка непрочитанных сообщений, хотя все сообщения прочитаны

⚠️ Уведомления в приложении Aurora приходят только при активной работе приложения. В настоящее время ведутся доработки этой функции.

Настройка уведомлений для чатов и каналов в приложении

Чтобы включить уведомления для конкретного чата или канала:

1. Откройте свойства нужного чата или канала.
2. Найдите параметр Уведомления.
3. Переключите тумблер в активное положение.

Чтобы уведомления eXpress поступали в браузер, проверьте следующие пункты.

Настройка уведомлений веб-приложения

Чтобы выключить или включить звуки сообщений внутри приложения, откройте Настройки > Уведомления.

Настройка уведомлений для чата или канала в приложении

Включите уведомления для конкретного чата или канала: для проверки этой настройки щелкните правой кнопкой мыши на чате или канале и далее нажмите кнопку уведомлений. Либо откройте свойства чата или канала и переключите тумблер Уведомления.

Разрешите уведомления для сайта веб-приложения в браузере

Предоставьте сайту веб-приложения разрешение на отправку уведомлений:

Браузер	Как разрешить уведомления
Apple Safari	Меню Safari > Настройки > Веб-сайты > адрес веб-приложения > Уведомления > Разрешить Меню Safari > Настройки > Веб-сайты > Автовоспроизведение > Всегда А также: меню Apple > Системные настройки > Уведомления > адрес веб-приложения > Показывать уведомления, там же отключите функцию Не беспокоить
Chromium	Настройки > Конфиденциальность и безопасность > Настройки сайтов > Уведомления
Google Chrome	Настройки > Конфиденциальность и безопасность > Настройки сайтов > Уведомления
Microsoft Edge	Настройки > Файлы cookie и разрешения сайтов > Уведомления
Mozilla Firefox	Настройки > Приватность и защита > Разрешения > Уведомления
Opera	Настройки > Настройки сайта > Уведомления
Vivaldi	Настройки > Приватность > Уведомления
Yandex	Настройки > Сайты > Уведомления > От прочих сайтов

❓Связанные вопросы:
• Веб-приложение перестаёт присылать уведомления спустя время

Настройка уведомлений десктоп-приложения

Щелкните значок приложения в области уведомлений (системном лотке) правой кнопкой мыши и установите флажок Уведомления или в приложении откройте Настройки > Уведомления и включите тумблер Уведомления. Там же можно выключить или включить звуки сообщений внутри приложения.

Настройка уведомлений для чата или канала в приложении

Включите уведомления для конкретного чата или канала: для проверки этой настройки щелкните правой кнопкой мыши на чате или канале и далее нажмите кнопку уведомлений. Либо откройте свойства чата или канала и переключите тумблер Уведомления.

Разрешите уведомления для десктоп-приложения в ОС

Предоставьте десктоп-приложению разрешение на отправку уведомлений в настройках операционной системы:

ОС	Как разрешить уведомления
macOS	Меню Apple > Системные настройки > Уведомления > ищем приложение > Допуск уведомлений, там же отключите функцию Не беспокоить
Linux	Ubuntu: Приложения > Параметры > Уведомления Astra Linux: Параметры системы > Персонализация > Уведомления > Настройка приложений > найдите приложение > Включить уведомления.
Windows (Windows 10, Windows 11)	Параметры > Система > Уведомления и действия (Уведомления) > ищем приложение > Вкл. Чтобы выключить отображение содержимого уведомлений на экране блокировки: Параметры > Система > Уведомления и действия (Уведомления) > выберите приложение > включите Скрывать содержимое при появлении уведомлений на экране блокировки.

❓Связанные вопросы:
• Нет уведомлений приложения в Manjaro Linux
• Нет уведомлений приложения для Windows 10/11, хотя всё настроено

Настройка меток на значке десктоп-приложения

ОС	Как разрешить уведомления
macOS	Меню Apple > Системные настройки > Уведомления > ищем приложение > Допуск уведомлений, там же включите Наклейка на значке
Windows (Windows 10, Windows 11)	Параметры > Персонализация > Панель задач > Показывать эмблемы на кнопках панели задач. Учтите, что эмблемы не отображаются на маленьких кнопках панели задач Windows.

❓Связанные вопросы:
• На значке приложения метка непрочитанных сообщений, хотя все сообщения прочитаны

Дополнительная индикация значка десктоп-приложения

ОС	Дополнительная индикация значка десктоп-приложения
macOS	При поступлении нового сообщения значок приложения в Docker подпрыгивает несколько раз. Чтобы это выключить, в меню Apple выберите Системные настройки > Универсальный доступ > Монитор и включите Уменьшить движение.
Windows (Windows 10, Windows 11)	При поступлении нового сообщения кнопка приложения на панели задач мигает несколько раз. Чтобы это выключить, откройте Параметры > Персонализация > Панель задач и выключите Показывать мигание значков приложений на панели задач.

Если уведомления и метки настроены по инструкциям выше, но всё равно с ними возникают проблемы.

Массово не работают уведомления на многих устройствах

Если наблюдается массовая проблема с уведомлениями у вас и у ваших коллег:

• При использовании приложения eXpress обратитесь в поддержку eXpress для проверки RTS.
• При использовании специального приложения обратитесь в поддержку своей организации для проверки ETS.

Администратору: диагностика массовой неработоспособности уведомлений ETS

Возможные причины массовой неработоспособности уведомлений при использовании специального приложения можно увидеть в логах контейнера ets_push_service на ETS.

Сертификат push-сервиса не должен быть просрочен илои содержать ошибки.

Также нужно убедиться, что ETS может корректно передавать данные в пуш-сервисы Google, Huawei, APNS и т.д. Например, если перестали отправляться push-уведомления на звонки на iOS, тогда:

• Смотрим логи контейнера push_service, если там следующее: 2022-02-18T07:37:53.487661695Z 2022-02-18 07:37:53.486 [error] skip push notification because adapter is not connected to APNS 2022-02-18T07:37:58.486935118Z 2022-02-18 07:37:58.485 [warn] Push timeout! (ios voex)2022-02-18T07:37:58.486957488Z Token information: 2022-02-18T07:37:58.486972168Z   token id: 280338 2022-02-18T07:37:58.486976091Z   phone: 79067247309 2022-02-18T07:37:58.486979331Z   user_huid: "2a768e92-a182-5efd-93c9-0a578b815a0e" 2022-02-18T07:37:58.486982654Z   udid: "d3e604e3-40a3-4aea-9c36-272d49eb6e34" 2022-02-18T07:37:58.486985939Z   platform: "ios_voex" — это означает, что нет подключения к APNS. Запись skip push notification because adapter is not connected to APNS означает, что в стейте APNS-адаптера, отсылающего пуш, conn == nil.
• Проверяем актуальность сертификатов в панели администратора (раздел Push Service на ETS). Если сертификаты истекли, нужно перевыпустить их и загрузить.
• Проверяем подключение к APNS: nc -v api.push.Apple.com 443. Если подключения нет, проверяем сеть, а если все ок — перезапускаем push_service на активной ноде кластера бэка ETS.
• Также проверяем, что запущены сервисы kafka и zookeeper

Уведомления на Android не работают, хотя всё настроено

Чтобы уведомления работали, убедитесь, что параллельно не открыта другая сессия. Например, если вы в данный момент читаете сообщения в веб-версии на компьютере, уведомления на мобильное устройство дублироваться не будут.

Проверьте значения параметров push-служб в инженерном меню приложения для Android и при необходимости проведите их диагностику: подробнее.

Устанавливайте приложение из магазина от производителя устройства! Если на устройстве нет служб Google, установите мобильное приложение из «родного» магазина приложений, иначе уведомления не будут работать. Для устройств Huawei и Honor приложение необходимо устанавливать из Huawei App Gallery. Поддерживается отправка уведомлений через службу магазина RuStore.

Если приложение установлено на устройстве Huawei через App Gallery, и уведомления приходят с сильными задержками, можно попробовать сбросить кэшированные данные службы «Служба push-сообщений»: Настройки > Приложения и службы > Приложения > меню-четыре точки в правом верхнем углу > Показать системные процессы > найдите Служба push-сообщений > Память > Сброс.

Некоторые производители устройств добавляют свои нестандартные настройки уведомлений и энергосбережения. Их тоже необходимо проверить, если в фоновом режиме уведомления не работают. Если процесс приложения был завершен вручную, то уведомления не будут приходить вовсе. На некоторых устройствах может завершаться фоновая работа приложения, в связи с чем уведомления и входящие звонки поступать не будут. Чтобы этого не происходило:

• Настройте стандартные функции оптимизации батареи Android для приложения, добавьте его в исключения этих функций.
• Закрепите приложение в списке недавних, чтобы оно не выгружалось из памяти после сворачивания.
• Исключите приложение из сторонних оптимизаций или выключите оптимизации вообще.
• Выключите ограничения в приложениях-оптимизаторах от производителя либо выключите или удалите эти приложения-оптимизаторы.
• Выключите экономию трафика в фоновом режиме или добавьте приложение в исключения — разрешите доступ к фоновой передаче данных.

Если все вышеперечисленные настройки Android включены, но уведомления всё равно не приходят, можно попробовать выключить и снова включить уведомления в настройках операционной системы. Если это не помогает, можно переустановить приложение (это может решить проблемы с доставкой Push-уведомлений, если приложение, например, было перенесено при миграции со старого телефона на новый).

Уведомления на iOS не работают, хотя всё настроено

Чтобы уведомления работали, убедитесь, что параллельно не открыта другая сессия. Например, если вы в данный момент читаете сообщения в веб-версии на компьютере, уведомления на мобильное устройство дублироваться не будут.

Если в инженерном меню приложения для iOS отсутствует apnsPushToken/voexPushToken, попробуйте перезапустить приложение.

Проверьте, не включён ли на устройстве режим «Фокусирование». Добавьте приложение в список разрешённых уведомлений фокусирования: Настройки > Фокусирование > выберите работающий режим > добавьте приложение в список Допуск уведомлений.

Попробуйте перезапустить приложение полностью, смахнув его из списка, после чего откройте его заново.

Если уведомления не работают во всех приложениях на устройстве, значит, возникла неполадка с APNS на данном устройстве. В таком случае необходимо обратиться в поддержку Apple.

Все уведомления на iOS приходят как «Новое сообщение»

Перезагрузите устройство. После этого уведомления должны приходить с текстом сообщений.

На значке приложения метка непрочитанных сообщений, хотя все сообщения прочитаны

Проверьте, что в приложении не остались непрочитанные чаты или обсуждения. Перезапустите или в крайнем случае переустановите приложение. Если эти меры не помогают, обратитесь в поддержку своей организации для сброса неверного счётчика.

Администратору: как сбросить счётчик на значке приложения

• Заходим в консоль messaging на корпоративном сервере (CTS/ECTS): dpl --dc exec messaging ./bin/messaging remote_console или: docker exec -it {messaging_container} ./bin/messaging remote_console
• Вставляем код ниже и нажимаем Enter: defmodule ClearCounters do @connection :message_counters_api def execute(huid) do with {:ok, hset} <- Redix.command(:message_counters_api, ["HGETALL", huid]) do counters = Enum.chunk_every(hset, 2) for [key, _] <- counters do Redix.command(:message_counters_api, ["HSET", huid, key, 0]) end end end end
• В конце выполняем команду: ClearCounters.execute("huid_пользователя") И просим пользователя перезапустить приложение.

Веб-приложение перестаёт присылать уведомления спустя время

В Chromium-браузерах можно сделать так, чтобы неактивная вкладка с веб-приложением не «засыпала» спустя время, и уведомления продолжали приходить. В некоторых браузерах это выключается только для всех вкладок сразу — не стоит это делать, если у компьютера мало оперативной памяти.

Браузер	Как выключить автоматическую выгрузку вкладок
Chromium	Настройки > Производительность > Экономия памяти > добавьте адрес веб-приложения в список Сайты, которые всегда активны
Google Chrome	Настройки > Производительность > Экономия памяти > добавьте адрес веб-приложения в список Сайты, которые всегда активны
Microsoft Edge	Настройки > Система и производительность > Оптимизировать производительность > добавьте адрес веб-приложения в список Никогда не переводить эти сайты в спящий режим
Opera	Настройки > Возможности > Интерфейс пользователя > снимите флажок Перевести неактивные вкладки в пассивный режим для экономии памяти
Yandex	Настройки > Системные > Производительность > снимите флажок Выгружать из памяти неиспользуемые вкладки

Нет уведомлений приложения в Manjaro Linux

Если десктоп-приложение, установленное в Manjaro Linux, не отображает уведомления о новых сообщениях и звонках, попробуйте установить пакет notification-daemon и настроить сервис уведомлений: cat /usr/share/dbus-1/services/org.freedesktop.Notifications.service [D-BUS Service] Name=org.freedesktop.Notifications Exec=/usr/lib/notification-daemon-1.0/notification-daemon

Нет уведомлений приложения для Windows 10/11, хотя всё настроено

Проверьте, включён ли режим «Фокусировка внимания» Windows. Выключите его Параметры > Система > Фокусировка внимания > Выкл. (также выключите автоматические правила) или настройте так, чтобы уведомления от десктоп-приложения всё равно приходили:

• Windows 10: приложение Параметры > Система > Фокусировка внимания > Только приоритет > Настройте список приоритетов > Приложения > нажмите Добавить приложение и выберите десктоп-приложение.
• Windows 11: приложение Параметры > Система > Уведомления > Задать приоритетные уведомления > нажмите Добавить приложения и выберите десктоп-приложение.

Попробуйте найти приложение в списке «Уведомления и действия» («Уведомления» на Windows 11) в параметрах Windows. В редких случаях десктоп-приложение может там отсутствовать. На этот случай есть сценарий Powershell, который возвращает приложение в базу данных уведомлений Windows, чтобы приложению можно было включить уведомления. Сценарию необходимо подключение к Интернету, поскольку из Интернета скачивается модуль для работы с SQL.

Инструкция:

1. Скачайте сценарий express.desktop_Notifications.ps1 (в браузере щёлкните ссылку правой кнопкой мыши и выберите Сохранить ссылку как).
2. Если приложение называется не eXpress, откройте сценарий в текстовом редакторе и вместо express укажите название своего приложения.
3. Запустите командную строку от имени администратора и выполните команду: powershell Set-ExecutionPolicy RemoteSigned
4. В проводнике щёлкните правой кнопкой мыши файл сценария и выберите команду Выполнить с помощью PowerShell.
5. В командной строке выполните команду: powershell Set-ExecutionPolicy Restricted
После этого приложение должно появиться в списке.