Типы данных статистики открытых линий

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Типы данных используются в ответах методов imopenlines.v2.*. Все имена полей передаются в формате camelCase.

Где используются типы

Тип

Где возвращается

session

Метод imopenlines.v2.Session.list, поле sessions[]

operatorLoad

Метод imopenlines.v2.Operator.list, поле operators[]

sessionStat

Метод imopenlines.v2.Session.Stat.get, поле stats[]

rating

Метод imopenlines.v2.Session.Rating.list, поле ratings[]

transfer

Метод imopenlines.v2.Session.Transfer.list, поле transfers[]

statResult

Метод imopenlines.v2.Stat.get, корневой объект result

Особенности полей

Поля

Где используются

Когда возвращаются как null

voteHead, commentHead

Объекты session, sessionStat и rating. В sessionStat есть только поле voteHead

Если тариф или права пользователя не позволяют видеть оценку руководителя

crmEntityType, crmEntityId

Объект session

Если у пользователя нет права чтения связанного объекта CRM

Объект session

Поле
тип

Описание

id
integer

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

configId
integer

Идентификатор открытой линии

source
string

Код канала, например livechat

operatorId
integer | null

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

userId
integer

Внутренний идентификатор клиента

userCode
string

Внешний идентификатор клиента в канале

chatId
integer

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

dateCreate
string

Дата создания сессии в формате ISO 8601

dateClose
string | null

Дата закрытия сессии

dateFirstAnswer
string | null

Дата первого ответа оператора

dateOperatorAnswer
string | null

Дата первого ответа живого оператора

status
string

Статус сессии sessionStatus

closeReason
string | null

Причина закрытия closeReason

vote
string

Клиентская оценка vote

voteHead
integer | null

Оценка руководителя от 1 до 5

commentHead
string | null

Комментарий руководителя к оценке

crmEntityType
string | null

Тип связанного объекта CRM.

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

  • lead — лид
  • deal — сделка
  • contact — контакт
  • company — компания

crmEntityId
integer | null

Идентификатор связанного объекта CRM

queueTransfers
integer

Количество переводов сессии

waitAnswer
integer | null

Время до первого ответа, секунды

waitClose
integer | null

Время до закрытия, секунды

kpiFirstAnswer
boolean | null

Уложился ли оператор в KPI первого ответа

messageCount
integer

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

Объект operatorLoad

Поле
тип

Описание

userId
integer

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

configId
integer

Идентификатор открытой линии

status
string

Статус оператора operatorStatus

activeSessions
integer

Количество активных сессий оператора

maxChat
integer

Максимальное количество одновременных чатов из настроек линии

freeSlots
integer

Количество свободных слотов оператора

lastActivityDate
string | null

Дата последней активности оператора

Объект sessionStat

Поле
тип

Описание

sessionId
integer

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

waitAnswer
integer | null

Время до первого ответа, секунды

waitClose
integer | null

Время до закрытия, секунды

messagesCount
integer | null

Общее количество сообщений, включая системные

messagesOperatorCount
integer | null

Количество сообщений оператора без системных сообщений

messagesClientCount
integer | null

Количество сообщений клиента без системных сообщений

transfersCount
integer | null

Количество переводов сессии

kpiFirstAnswer
boolean | null

Уложился ли оператор в KPI первого ответа

vote
string | null

Клиентская оценка vote

voteHead
integer | null

Оценка руководителя от 1 до 5

Объект rating

Поле
тип

Описание

sessionId
integer

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

configId
integer

Идентификатор открытой линии

operatorId
integer | null

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

source
string

Код канала

vote
string

Клиентская оценка vote

voteHead
integer | null

Оценка руководителя от 1 до 5

commentHead
string | null

Комментарий руководителя к оценке

dateVote
string | null

Дата клиентской оценки

dateSessionClose
string | null

Дата закрытия сессии

Объект transfer

Поле
тип

Описание

sessionId
integer

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

date
string

Дата перевода в формате ISO 8601

fromOperatorId
integer | null

Идентификатор оператора, от которого перевели сессию

toOperatorId
integer | null

Идентификатор оператора, которому перевели сессию

fromConfigId
integer

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

toConfigId
integer | null

Идентификатор линии назначения

reason
string

Причина перевода transferReason

mode
string

Режим перевода.

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

  • MANUAL — ручной перевод
  • AUTO — автоматический перевод
  • BOT — перевод ботом

type
string

Тип назначения перевода.

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

  • USER — перевод оператору
  • QUEUE — перевод в очередь

initiatorId
integer | null

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

Объект statResult

Поле
тип

Описание

totalSessions
integer

Общее количество сессий

closedSessions
integer

Количество закрытых сессий

spamSessions
integer

Количество спам-сессий

avgWaitAnswer
number

Среднее время до первого ответа, секунды

avgSessionDuration
number

Средняя длительность сессии, секунды

likeCount
integer

Количество лайков

dislikeCount
integer

Количество дизлайков

votedSessions
integer

Количество сессий с клиентской оценкой

positiveRate
number

Доля положительных оценок от 0 до 1

kpiFirstAnswerOk
integer

Количество сессий с выполненным KPI первого ответа

kpiFirstAnswerFail
integer

Количество сессий с невыполненным KPI первого ответа

sessionsBySource
sourceCount[]

Количество сессий по каналам

sessionsByHour
integer[]

Количество сессий по часам суток, 24 элемента

sessionsByOperator
operatorCount[]

Статистика по операторам

Объект sourceCount

Поле
тип

Описание

source
string

Код канала, например livechat

count
integer

Количество сессий из канала

Объект operatorCount

Поле
тип

Описание

operatorId
integer

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

count
integer

Количество сессий оператора

avgWaitAnswer
number

Среднее время до первого ответа оператора, секунды

positiveRate
number

Доля положительных клиентских оценок оператора от 0 до 1

Значения sessionStatus

Значение

Описание

new

Сессия в очереди или пропущена

answered

Оператор ведет диалог

closed

Сессия закрыта

spam

Сессия помечена как спам

paused

Сессия на паузе

Значения operatorStatus

Значение

Описание

online

Оператор онлайн и не на паузе

offline

Оператор не в сети

pause

Оператор поставил себя на паузу

Значения closeReason

Значение

Описание

operator

Сессию закрыл оператор

auto

Сессия закрыта автоматически по таймауту

spam

Сессия закрыта как спам

client

Сессия закрыта по неактивности клиента

replyLimit

Сессия закрыта после истечения окна ответа канала

Значения vote

Значение

Описание

like

Клиент поставил лайк

dislike

Клиент поставил дизлайк

none

Оценки нет

Значения transferReason

Значение

Описание

manual

Ручной перевод оператором

queue

Автоматический возврат в очередь той же линии

auto

Автоматическое распределение

line

Перевод в другую открытую линию

Продолжите изучение