Перейти к основному содержимому
Версия: 4.11-refactoring

Обзор пуш-уведомлений

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

Клиентская доставка

Клиенты получают пуши двумя способами:

  • мобильные приложения с SDK iqchannels — доставка через провайдера платформы устройства: iOS — Apple Push Notification service (APNs), Android — Firebase Cloud Messaging (FCM), устройства Huawei без сервисов Google — Huawei Cloud Messaging (HCM);
  • веб-виджет, встроенный в мобильное приложение — приложение получает нативный пуш-токен и передаёт его методами API виджета: Пуш-уведомления виджета.

Операторская доставка

Операторы получают пуши:

Провайдеры и приоритет

Маршрут клиентских пушей выбирается так: если включён шлюз пушей, отправка идёт в него; иначе платформа обращается к прямым провайдерам — APNs, затем FCM, затем HCM.

ПровайдерПлатформаГде настраивается
APNsiOSПуш-уведомления iOS (APNs)
FCMAndroidПуш-уведомления Android и HarmonyOS
HCMHarmonyOS (устройства Huawei)Пуш-уведомления Android и HarmonyOS
Шлюз пушейлюбой — доставка средствами вашей инфраструктурыШлюз пушей

Для отправки клиентских пушей через корпоративный агрегатор существует отдельный контур iSMG — см. Пуш-уведомления через iSMG.

Заголовок пуша

Заголовок клиентских пуш-уведомлений канала переопределяется карточкой «Настройка заголовка пуша» в настройках канала: поле «Заголовок пуша» задаёт текст, который отображается в заголовке уведомлений этого канала.

События операторских пушей

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

СобытиеЗаголовокТекст
Окончание сессии«Ваша сессия закончилась»«Для получения уведомлений войдите снова»
Новое сообщение от клиента«Сообщение от клиента»{Имя}: {текст}
Новое обращение«Поступило новое обращение»от {Имя}
Клиент ожидает ответ«Напоминание»«Клиент ожидает ответ на сообщение»
Передача заместителю персонального менеджера«Персональный менеджер»{Имя} написал в ваше отсутствие - обращение передано заместителю
Передача в другой сегмент«Персональный менеджер»{Имя} написал в ваше отсутствие - обращение передано в сегмент {Название}
Сообщение в групповом корпоративном чатеназвание чата{Имя автора}: {текст}
Сообщение в личном корпоративном чатеимя автора сообщениятекст сообщения

{Имя}, {текст}, {Название} — подстановки: имя клиента, текст сообщения и название сегмента.

За включение каждого события отвечают флаги уведомлений в группах прав — Полномочия и роли в сегменте. При включённом обезличивании в настройках приложения операторов заголовок и текст любых операторских пушей заменяются на «Получено новое уведомление» и «Проверьте приложение» — см. Пуш-уведомления для приложения операторов.

Лицензии

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

Как устроена доставка

От события до устройства уведомление проходит один путь доставки с двумя потоками — клиентским и операторским:

                    Событие в системе
(новое сообщение, обращение, напоминание клиенту)


Очередь на сервере

┌────────────────┴────────────────┐
▼ ▼
Демон отправки Демон отправки
клиентских пушей операторских пушей
│ │
▼ ▼
Провайдеры клиентских Провайдеры операторских
пушей: пушей: FCM и HCM
шлюз пушей → APNs → FCM → HCM
(альтернативный путь — iSMG)
│ │
▼ ▼
Устройство клиента: Устройство оператора:
телефон с приложением телефон с приложением
(SDK iqchannels), виджет операторов, браузер
в мобильном приложении веб-панели (web-push)

Связанные задачи