PUSH-оповещения
Для передачи оповещений от сервера на сторону мобильного приложения используются два механизма:
- LiveTex SDK Core после успешной инициализации начинает постоянное соединение с сервисом оповещений LiveTex. Для коммуникации используется long-polling транспорт.
- В случае неактивности мобильного приложения с SDK для доставки оповещений могут использоваться специфичные для платформы сервисы PUSH-оповещений. FCM в случае Android и APNS для iOS.
- Также возможна интеграция, при которой оповещения отсылаются на сервера клиента.
Рекомендуемый механизм отправки PUSH оповещений
Пришлите Технической Поддержке URL вашего сервера, на который с сервера LiveTex будут поступать вебхуки с сообщениями в формате JSON. Ваш сервер на основе полученных данных сможет отправить push-оповещение.
Сервер LiveTex посылает вебхук при новом сообщении от оператора в том случае, если связь с приложением прервалась и приложение не восстанавливает соединение с сервером LiveTex заданное время. Из всех сообщений, которые были высланы оператором за время отведённое на восстановление соединения, в вебхуке будет только последнее сообщение. Для отображения в приложении всех сообщений, которые были отправлены, пока отсутствовало соединение, при возвращении на экран чата необходимо загрузить историю при помощи метода getHistory/messageHistory.
Отправляемые в JSON данные:
| Поле | Тип | Обязательный | Описание |
| version | string | Да | Строка, версия протокола (сейчас только 1) |
| platform | string | Да | "ios" | "android" - перечисление может быть либо ios либо android |
| to | string | Да | id устройства пользователя |
| text | string | нет | текст сообщения |
| url | string | yет | ссылка на файл |
Возможные варианты комбинации text/url: