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

Пуш-уведомления виджета

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

Как работает регистрация токена​

  1. Мобильное приложение регистрирует устройство в нативном пуш-сервисе — APNs на iOS или FCM на Android — и получает пуш-токен устройства.
  2. Приложение передаёт токен в виджет методом API:
// iOS — токен APNs
widget.setIPhonePushToken(deviceToken);

// Android — токен FCM
widget.setAndroidPushToken(deviceToken);
  1. Виджет отправляет токен на сервер — автоматически, после авторизации клиента.

Токен можно передать как до, так и после открытия чата: виджет запоминает его и отправит на сервер, когда клиент авторизуется.

Настройка серверной части​

Доставка клиентских пушей настраивается в карточках канала внутреннего чата:

Заголовок уведомлений канала задаётся карточкой «Настройка заголовка пуша» — см. Обзор пуш-уведомлений.

Ограничения​

  • Виджет передаёт токены APNs и FCM; доставка на устройства Huawei через HCM для виджета недоступна — настройка карточки HCM канала на виджет не влияет.
  • Пуши доставляются о событиях чата того канала, для которого настроены провайдеры.

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