Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Параметр

Обязательно

Значение по умолчанию

Описание

withoutCount

Нет

False

Если True, то в ответе не будет общего количества элементов

withoutItems

Нет

False

Если True, то в ответе не будет подробностей по элементам

limit

Нет

10

Количество элементов в ответе (максимум 1000)

page

Нет0

Номер "страницы" с элементами (начиная с 0).

Например, если в limit указано 1000, а всего элементов 1500, то первая 1000 будет в ответе при page = 0, а остальные 500 при page =1 

from

ДаОтсутствует

Дата начала промежутка поиска. 

Задается в формате:

2023-10-31T00:00:00+00:00

ГГГГ-ММ-ДДTчч:мм:сс+чч:мм

Обязательно url-encoded

to

ДаОтсутствует

Дата окончания промежутка поиска. 

Задается в формате:

2023-10-31T00:00:00+00:00

ГГГГ-ММ-ДДTчч:мм:сс+чч:мм

Обязательно url-encoded

chatId

НетОтсутствуетИдентификатор чата

messengerType

НетОтсутствует

Фильтр по типу мессенджера. 

Возможные значения:

WHATSAPP, VIBER, TELEGRAM, VKONTAKTE, FACEBOOK, SKYPE, SLACK, YANDEX, ALICE, THREADS

keyword

НетОтсутствует

Фильтр по значению в любом из полей:

  • name – имя чат-сессии
  • clientId – идентификатор клиента в twin
  • messengerUserId – идентификатор клиента в мессенджере

output

НетОтсутствует

Используется для получения данных в виде файла, а не в JSON теле ответа. 

Возможные значения:

  • CSV
  • EXCEL

filename

НетОтсутствует

Имя файла без расширения.

Актуально только при использовании output

archive

НетОтсутствует

Возвращать ли файл в архиве. 

true/false

Актуально только при использовании output


Примечание

Из-за особенностей рассылки первое сообщение клиента и первое сообщение бота перепутаны местами. Следующие сообщения будут идти в нужном порядке. При входящих обращениях также будет правильный порядок сообщений. 

...

Поле

Тип

Описание

count

IntОбщее количество найденных элементов

items

Array[Object]Массив найденных элементов

|    id

StringИдентификатор чат-сессии

|    dialogLink

StringСсылка на диалог

|    name

StringИмя чат-сессии

|    chatId

StringИдентификатор чата

|    chatName

StringИмя чата 

|    markedAsSpam

StringБыло ли помечено как спам

|    operatorId

StringИдентификатор оператора

|    operatorName

StringИмя оператора

|    operatorAssignedAt

StringДата присвоения диалога текущему/последнему оператору

|    previousOperators

Array[String]Массив предыдущих операторов

|    firstOperatorName

StringИмя первого оператора

|    firstOperatorAssignedAt

StringДата присвоения диалога первому оператору

|    previousOperatorsAsString

StringМассив предыдущих операторов строкой

|    botName

StringНазвание сценария

|    clientId

StringИдентификатор клиента (внутренний)

|    clientExternalId

StringИдентификатор клиента (внешний)

|    clientIp

StringIP клиента

|    userAgent

StringUser Agent браузера клиента

|    messengerType

StringТип мессенджера

|    status

StringСтатус чат-сессии

|    startedAt

StringДата начала чат-сессии

|    closedAt

StringДата закрытия чат-сессии

|    operatorFirstMessageCreatedAt

StringДата первого сообщения оператора

|    operatorLastMessageCreatedAt

StringДата последнего сообщения оператора

|    botLastMessageCreatedAt

StringДата последнего сообщения бота

|    lastMessageCreatedAt

StringДата последнего сообщения

|    clientLastMessageCreatedAt

StringДата последнего сообщения клиента

|    clientOnlineAt

StringДата и время, когда клиент был online

|    clientOfflineAt

StringДата и время, когда клиент был offline

|    referer

StringЗначение заголовка referer на странице, с которой пришел клиент

|    price

StringСтоимость всех сообщений чат сессии

|    messages

Array[Object]Массив сообщений

|    |    id

StringИдентификатор сообщения

|    |    authorId

StringИдентификатор автора сообщения

|    |    authorName

StringИмя автора сообщения

|    |    authorType

StringТип автора сообщения

|    |    type

StringТип сообщения

|    |    price

StringЦена за сообщения

|    |    body

StringТекст сообщения

|    |    attachments

ArrayВложения в сообщении

|    |    answers

Array[String]Варианты ответа/кнопки в сообщении

|    |    createdAt

StringДата создания сообщения

|    messagesAsString

StringВсе сообщения одной строкой

|    operatorMessageCount

IntКоличество сообщений оператора

|    botMessageCount

IntКоличество сообщений бота

|    clientMessageCount

IntКоличество сообщений клиента

|    messageCount

IntКоличество всех сообщений

|    dialogResultsFromBot

StringЗначение поля "Подтверждение результата"

|    dialogResultsFromBotJson

ObjectВсе результаты бота одним объектом

|    |    nps

StringЗначение поля NPS

|    |    confirmation

StringЗначение поля "Подтверждение результата"

|    |    Var

StringЗначение произвольного результата

|    |    markers

Array[String]Массив маркеров в чат-сессии

|    |    initialVariables

ArrayСтартовые переменные в чат-сессии

|    dialogResultsFromOperator

StringРезультат, проставленный оператором

|    nps

StringЗначение поля NPS

|    csi

StringЗначение csi

|    fcr

StringЗначение fcr

|    whatsappPhone

StringНомер телефона клиента в WhatsApp

|    markers

StringМаркеры одной строкой

|    rating

StringОценка клиента

|    closedBy

StringКем была закрыта сессия

|    timerFirstAnswer

IntТаймер первого ответа

|    timerNextAnswers

IntТаймер последующих ответов

|    operatorFirstAnswer

IntТаймер первого ответа оператора

|    operatorNextAnswers

IntТаймер последующих ответов оператора

...