PUSH-оповещения

Для передачи оповещений от сервера на сторону мобильного приложения используются два механизма:

Рекомендуемый механизм отправки 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:

  • Задан text, не задан url - текстовое сообщение;
  • Не задан text, задан url - сообщение содержащее файл;
  • Задан text, задан url - отправлен файл с комментарием.