История сообщений

Получить данные для каналов сообщений

GET /v1.1/messaging/<id>/sources

  • id - идентификатор обращения

После успешного выполнения возвращается массив объектов, описывающих каналы сообщений.

id string Идентификатор канала в мессенджере или социальной сети
realId integer Идентификатор канала в Umnico
name string Наименование фотографии или комментария
type string Тип канала: сообщение, комментарий, фотография и т.д.
saId integer Идентификатор интеграции
sender string Идентификатор клиента, который обратился по данному каналу, в мессенджере или социальной сети
token string Токен канала

Возможные типы каналов:

  • comment - комментарий к посту
  • message - сообщение
  • photo - комментарий к фотографии
  • video - комментарий к видеозаписи
  • market - комментарий к товару

Получить историю сообщений для каждого канала

POST /v1.1/messaging/<id>/history/<source-real-id>

  • id - идентификатор обращения
  • source-real-id - идентификатор канала в Umnico (см. в запросе выше)

В тело запроса указывается курсор для запроса более ранних сообщений.

  • cursor - значение смещения (если история еще не загружалась, то передавать не нужно)

После успешного выполнения возвращается следующий объект.

cursor integer Смещение, которое необходимо передать в следующем запросе
source integer Идентификатор канала в Umnico (аналогичен source-real-id)
messages массив Массив объектов сообщений

Объект, описывающий сообщение:

datetime integer Дата и время отправки сообщения
sa integer Идентификатор интеграции
incoming bool true - входящее сообщение, false - исходящее
message объект  
  • text
string Текст сообщения
  • url
string Ссылка на сообщение в социальной сети или мессенджере
  • attachments
массив Вложения в сообщения
    • type
string Тип вложения
    • url
string Ссылка для получения вложения
    • text
string Название вложения
sender объект Объект, описывающий автора сообщения
  • id
integer Идентификатор профиля клиента или externalId интеграции
  • customerId
integer Идентификатор клиента
  • login
string Логин клиента в мессенджере или название аккаунта в социальной сети
  • avatar
string Аватар аккаунта в мессенджере или социальной сети
  • type
string Тип профиля (равнозначен типу интеграции, в которую написал клиент)
  • socialId
string Идентификатор клиента (или интеграции) в мессенджере или социальной сети
  • profileUrl
string Ссылка на профиль
preview объект Объект, описывающий пост (запись, картинку и т.п.), к которому сделан комментарий
  • photo
string Ссылка на картинку из поста
  • description
string Часть текста из поста
  • owner
string Имя пользователя или группы, создавшей пост
  • url
string Ссылка на сообщение в социальной сети или мессенджере
source объект Объект, описывающий канал сообщений (см. выше)