Open Channels Statistics Data Types

If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.

Data types are used in responses of imopenlines.v2.* methods. All field names are passed in camelCase format.

Where Types Are Used

Type

Where It Is Returned

session

Method imopenlines.v2.Session.list, field sessions[]

operatorLoad

Method imopenlines.v2.Operator.list, field operators[]

sessionStat

Method imopenlines.v2.Session.Stat.get, field stats[]

rating

Method imopenlines.v2.Session.Rating.list, field ratings[]

transfer

Method imopenlines.v2.Session.Transfer.list, field transfers[]

statResult

Method imopenlines.v2.Stat.get, root object result

Field Features

Fields

Where They Are Used

When They Are Returned as null

voteHead, commentHead

Objects session, sessionStat, and rating. sessionStat has only the voteHead field

If the plan or user permissions do not allow viewing supervisor ratings

crmEntityType, crmEntityId

Object session

If the user does not have read permission for the linked CRM object

Object session

Field
type

Description

id
integer

Session ID

configId
integer

Open channel ID

source
string

Channel code, for example livechat

operatorId
integer | null

Operator ID

userId
integer

Internal customer ID

userCode
string

External customer ID in the channel

chatId
integer

Chat ID

dateCreate
string

Session creation date in ISO 8601 format

dateClose
string | null

Session close date

dateFirstAnswer
string | null

Date of the first operator response

dateOperatorAnswer
string | null

Date of the first live operator response

status
string

Session status sessionStatus

closeReason
string | null

Close reason closeReason

vote
string

Customer rating vote

voteHead
integer | null

Supervisor rating from 1 to 5

commentHead
string | null

Supervisor comment on the rating

crmEntityType
string | null

Linked CRM object type.

Possible values:

  • lead — lead
  • deal — deal
  • contact — contact
  • company — company

crmEntityId
integer | null

Linked CRM object ID

queueTransfers
integer

Number of session transfers

waitAnswer
integer | null

Time to first response, seconds

waitClose
integer | null

Time to close, seconds

kpiFirstAnswer
boolean | null

Whether the operator met the first response KPI

messageCount
integer

Number of messages in the dialog

Object operatorLoad

Field
type

Description

userId
integer

Operator ID

configId
integer

Open channel ID

status
string

Operator status operatorStatus

activeSessions
integer

Number of active operator sessions

maxChat
integer

Maximum number of simultaneous chats from line settings

freeSlots
integer

Number of free operator slots

lastActivityDate
string | null

Operator last activity date

Object sessionStat

Field
type

Description

sessionId
integer

Session ID

waitAnswer
integer | null

Time to first response, seconds

waitClose
integer | null

Time to close, seconds

messagesCount
integer | null

Total number of messages, including system messages

messagesOperatorCount
integer | null

Number of operator messages, excluding system messages

messagesClientCount
integer | null

Number of customer messages, excluding system messages

transfersCount
integer | null

Number of session transfers

kpiFirstAnswer
boolean | null

Whether the operator met the first response KPI

vote
string | null

Customer rating vote

voteHead
integer | null

Supervisor rating from 1 to 5

Object rating

Field
type

Description

sessionId
integer

Session ID

configId
integer

Open channel ID

operatorId
integer | null

Operator ID

source
string

Channel code

vote
string

Customer rating vote

voteHead
integer | null

Supervisor rating from 1 to 5

commentHead
string | null

Supervisor comment on the rating

dateVote
string | null

Customer rating date

dateSessionClose
string | null

Session close date

Object transfer

Field
type

Description

sessionId
integer

Session ID

date
string

Transfer date in ISO 8601 format

fromOperatorId
integer | null

ID of the operator from whom the session was transferred

toOperatorId
integer | null

ID of the operator to whom the session was transferred

fromConfigId
integer

Source line ID

toConfigId
integer | null

Destination line ID

reason
string

Transfer reason transferReason

mode
string

Transfer mode.

Possible values:

  • MANUAL — manual transfer
  • AUTO — automatic transfer
  • BOT — transfer by bot

type
string

Transfer destination type.

Possible values:

  • USER — transfer to an operator
  • QUEUE — transfer to a queue

initiatorId
integer | null

Transfer initiator ID

Object statResult

Field
type

Description

totalSessions
integer

Total number of sessions

closedSessions
integer

Number of closed sessions

spamSessions
integer

Number of spam sessions

avgWaitAnswer
number

Average time to first response, seconds

avgSessionDuration
number

Average session duration, seconds

likeCount
integer

Number of likes

dislikeCount
integer

Number of dislikes

votedSessions
integer

Number of sessions with a customer rating

positiveRate
number

Share of positive ratings from 0 to 1

kpiFirstAnswerOk
integer

Number of sessions that met the first response KPI

kpiFirstAnswerFail
integer

Number of sessions that did not meet the first response KPI

sessionsBySource
sourceCount[]

Number of sessions by channel

sessionsByHour
integer[]

Number of sessions by hour of day, 24 items

sessionsByOperator
operatorCount[]

Statistics by operator

Object sourceCount

Field
type

Description

source
string

Channel code, for example livechat

count
integer

Number of sessions from the channel

Object operatorCount

Field
type

Description

operatorId
integer

Operator ID

count
integer

Number of operator sessions

avgWaitAnswer
number

Average operator first response time, seconds

positiveRate
number

Share of positive customer ratings for the operator from 0 to 1

sessionStatus Values

Value

Description

new

Session is in the queue or missed

answered

Operator is handling the dialog

closed

Session is closed

spam

Session is marked as spam

paused

Session is paused

operatorStatus Values

Value

Description

online

Operator is online and not paused

offline

Operator is offline

pause

Operator has paused themselves

closeReason Values

Value

Description

operator

Session was closed by an operator

auto

Session was closed automatically by timeout

spam

Session was closed as spam

client

Session was closed because of customer inactivity

replyLimit

Session was closed after the channel response window expired

vote Values

Value

Description

like

Customer left a like

dislike

Customer left a dislike

none

No rating

transferReason Values

Value

Description

manual

Manual transfer by an operator

queue

Automatic return to the same line queue

auto

Automatic distribution

line

Transfer to another open channel

Continue Learning