Перейти к содержанию

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

Подключение и настройка

Для подключения и настройки push-уведомлений перейдите в раздел "Push Service".

Интерфейс предназначен для подключения push-уведомлений:

Рисунок_5

Таблица содержит следующую информацию:

Название столбца Информация
Платформа Платформа, на которой подключены push-уведомления
Package ID Название сборки приложения "eXpress"
Дата обновления Дата последнего изменения настройки push-уведомлений
Дата истечения Дата истечения поступления push-уведомлений

Для редактирования подключения нажмите кнопку edit и внесите изменения в открывшемся окне.

Для удаления подключения нажмите кнопку delete.

Механизм подключения push-уведомлений различен для платформ Android, iOS и веб-приложения. Для Android и веб-приложения push-уведомления подключаются через FCM, для iOS ─ через APNS.

Примечание

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

  • Apple APN — api.push.apple.com;
  • Google FCM — fcm.googleapis.com;
  • Huawei HSM — push-api.cloud.huawei.com, oauth-login.cloud.huawei.com.


Подключение на Android/HMS Android

Для создания подключения на Android/HMS Android:

  1. Откройте консоль Firebase.

  2. В проекте (меню "Project Overview"), где сконфигурированы ключи для Android, выберите пункт Project settings:

    Рисунок_6

  3. В консоли администратора "eXpress" в разделе "Push Service" нажмите кнопку Создать для Android в верхнем правом углу.

    Откроется окно создания подключения для платформы Android:

    Рисунок_7

  4. Заполните поля формы:

    Параметр Описание Значение
    Платформа Платформа, на которой подключены push-уведомления android_silent
    Package ID Название сборки приложения "eXpress"
    Дата истечения Дата истечения поступления push-уведомлений
    FCM URL Адрес сервера Firebase Cloud Messaging https://fcm.googleapis.com/fcm/send
    FCM API Key Ключ API, выдаваемый в консоли администратора Firebase См. рисунок ниже

    Рисунок_8

  5. Нажмите кнопку Сохранить.


Подключение на iOS

Для создания подключения на iOS:

  1. Нажмите кнопку Создать для iOS в верхнем правом углу.

    Откроется окно создания подключения для платформы iOS:

    Рисунок_9

  2. Заполните поля формы:

    Параметр Описание Значение
    Платформа Платформа, на которой подключены push-уведомления
    • ios_apns (для alert push с сертификатом apns);
    • ios_voex (для push-уведомлений звонков с сертификатом voip)
    Package ID Название сборки приложения "eXpress"
    Дата истечения Дата истечения поступления push-уведомлений
    Mode Режим работы push-уведомлений. Возможные значения prod/dev
    • dev (для сборки beta);
    • prod (для релиза/пререлиза)
    Ключ Приватный ключ
    Cert Сертификат
    Topic Название сборки приложения "eXpress" Package ID (для ios_apns);
    пустое значение (для ios_voex)

  3. Нажмите кнопку Сохранить.


Подключение в веб-приложении

Для создания подключения в веб-приложении:

  1. Откройте консоль Firebase.

  2. В консоли Firebase создайте проект для веб-приложения:

    Рисунок_10

  3. В открывшемся окне нажмите кнопку Generate key pairs:

    Рисунок_11

  4. В консоли администратора в разделе "Push Service" нажмите кнопку Создать для Web в верхнем правом углу.

    Откроется окно создания подключения для веб-приложения:

    Рисунок_12

  5. Заполните поля формы.

    Примечание

    В поле Платформа укажите значение "web".

    Параметр Описание Значение
    Платформа Платформа, на которой подключены push-уведомления
    • web;
    • web_chrome;
    • web_firefox
    Package ID Название сборки приложения "eXpress"
    Дата истечения Дата истечения поступления push-уведомлений
    FCM API Key Ключ API, выдаваемый в консоли администратора Firebase См. пункт 1 на рис. ниже
    Публичный VAPID-ключ Публичный ключ API, сгенерированный в консоли администратора Firebase См. пункт 2 на рис. ниже
    Приватный VAPID-ключ Приватный ключ API, сгенерированный в консоли администратора Firebase См. пункт 3 на рис. ниже
    Субъект VAPID (URI или e-mail) Адрес электронной почты пользователя в firebase mailto:<email аккаунта firebase>

    Рисунок_13

  6. Нажмите кнопку Сохранить.

  7. Повторите действия 1 – 6 для Chrome, указав в поле Платформа значение "web_chrome".

    В разделе "Push Service" появятся две записи (для двух браузеров).

  8. В конфигурационном файле docker-образа веб-приложения (WEB_CLIENT_CONFIG) измените параметр gcmSenderId на значение из Firebase:

    Рисунок_14