Для отображения push-уведомлений на мобильных устройствах убедитесь, что выполнены следующие условия:
добавлены шаблоны push-уведомлений в подразделе «Шаблоны»;
настроена отправка push-уведомлений в подразделе «Push-уведомления». Если при настройке в проекте не содержится ни одного шаблона настраиваемого сервиса, то будет выдано соответствующее сообщение.
Для настройки отправки push-уведомлений на мобильные устройства используйте подраздел «Push-уведомления»:
Задайте параметры в зависимости от используемого типа ОС и добавленных шаблонов:
Firebase Cloud Messaging. Раздел для настройки сервиса на Android:
Firebase. Установите флажок для использования сервиса и задайте отобразившиеся параметры:
Firebase service account JSON-file. Выберите JSON-файл сервисной учётной записи пользователя при нажатии на кнопку «Выберите файл». Выбранный файл позволяет серверу мобильной платформы самостоятельно получать и обновлять токен доступа, используемый для отправки push-уведомлений;
Важно. При обновлении продукта «Форсайт. Мобильная платформа» требуется повторная загрузка JSON-файла.
Firebase OAuth 2.0 access token. Токен доступа по протоколу OAuth 2.0. Администратор мобильной платформы вручную изменяет значение параметра по истечении срока действия токена доступа. Сервер мобильной платформы может только получать заданный токен доступа, но не обновлять его;
Firebase project id. Идентификатор проекта в сервисе Firebase.
Примечание. Выберите JSON-файл в параметре «Firebase service account JSON-file» или задайте параметры «Firebase OAuth 2.0 access token», «Firebase project id». При использовании параметра «Firebase service account JSON-file» задание параметров «Firebase OAuth 2.0 access token», «Firebase project id» не требуется.
Apple Push Notification service. Раздел для настройки сервиса на iOS:
APNs. Установите флажок для использования сервиса и задайте отобразившиеся параметры:
Via Firebase Cloud Messaging. При необходимости установите флажок для использования сервиса Firebase и загрузите JSON-файл сервисной учётной записи пользователя в параметре «Firebase service account JSON-file» или задайте параметры «Firebase OAuth 2.0 access token», «Firebase project id»;
Примечание. Параметры «Firebase service account JSON-file», «Firebase OAuth 2.0 access token», «Firebase project id» доступны только при установленном флажке «Via Firebase Cloud Messaging». При использовании сервиса Firebase параметры APNs, указанные ниже, становятся недоступны.
Bundle ID. Укажите идентификатор iOS-приложения. Поле обязательно для заполнения;
Apns certificate as file. Выберите файл с APNs-сертификатом при нажатии на кнопку «Выберите файл». Параметр является обязательным;
Apns server. Выберите тип APNs-сервера в раскрывающемся списке: Development, Production;
Windows Push Notification Services. Раздел для настройки сервиса на Windows:
WNS. Установите флажок для использования сервиса и задайте отобразившиеся параметры:
Client ID. Укажите идентификатор Windows-приложения. Поле обязательно для заполнения;
Client secret. Укажите секретный ключ Windows-приложения. Поле обязательно для заполнения;
Настройка Proxy сервера для отправки Push-уведомлений. При необходимости задайте параметры для отправки push-уведомлений с использованием прокси-сервера:
Адрес прокси. Укажите IP-адрес или DNS-имя прокси-сервера;
Порт. Укажите TCP порт, по которому доступен прокси-сервер. По умолчанию установлено значение «80»;
Примечание. Для работы с сервером APNS на прокси-сервере отключите аутентификацию и SSL инспекцию трафика.
Настройка хранения Push-сообщений. При необходимости задайте параметр для хранения сообщений:
Время хранения Push сообщений на сервере (дней). Укажите время хранения push-сообщений на сервере мобильной платформы в днях. По умолчанию установлено значение «180».
После настройки параметров push-уведомлений нажмите кнопку «Сохранить».
Алгоритм отправки push-уведомлений:
Аутентификация пользователя с указанием DeviceID устройства. В ответе будет содержаться «api_sessionid», который используется в последующих запросах.
Запрос токена устройства у соответствующего сервиса push-уведомлений (для Android - Firebase, для iOS - APNS, для Windows - WNS) на мобильном устройстве.
Отправка токена на сервер мобильной платформы с привязкой к устройству и указанием типа платформы, сервиса и самого токена.
Примечание. Если отправляемый токен уже есть в проекте, но привязан к другому пользователю, то сервер разорвёт связь между ними и привяжет токен к пользователю API, отправляющему запрос.
Отправка запроса:
с указанием шаблона и пользователя при отправке push-уведомлений конкретному пользователю;
с указанием шаблона и топика при отправке push-уведомлений группе пользователей.
Методы и запросы для отправки push-уведомлений приведены в разделе «Методы работы с push-уведомлениями».
Для проверки статуса отправки push-уведомлений обратитесь к разделу «Проверка статуса отправки push-уведомлений».
При использовании сервиса Firebase в качестве провайдера push-уведомлений сервер мобильной платформы аутентифицируется в Google с помощью сервисного аккаунта и получает токен доступа, действительный в течение 60 минут. Если при отправке уведомления срок действия токена истек, то платформа автоматически обновляет его и повторяет отправку. Отправка push-уведомления с недействительным токеном и успешное обновление токена фиксируются в качестве информационных событий в подразделе «Системные логи».
См. также:
Настройка сред и проектов | Добавление темы сообщений | Добавление шаблонов push-уведомлений | Проверка статуса отправки push-уведомлений