метод REST scope: imopenlines

imopenlines.v2.Stat.get

Получить агрегированную статистику

Кто может выполнять: пользователь с доступом к отчетам открытых линий

Описание

Метод imopenlines.v2.Stat.get получает агрегированную статистику открытых линий за период.

Параметры

dateFrom string обязательный

Начало периода в формате ISO 8601

dateTo string обязательный

Конец периода в формате ISO 8601.

Максимальный период: 366 дней

configId integer необязательный

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

Идентификатор можно получить методом imopenlines.config.list.get

configIdList integer[] необязательный

Список идентификаторов открытых линий.

Идентификаторы можно получить методом imopenlines.config.list.get.

Если переданы configIdList и configId, используется configIdList.

Максимум: 1000 элементов

source string необязательный

Код канала.

Код можно получить методом imconnector.list

sourceList string[] необязательный

Список кодов каналов.

Коды можно получить методом imconnector.list.

Если переданы sourceList и source, используется sourceList.

Максимум: 1000 элементов

operatorId integer необязательный

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

Идентификатор можно получить методом user.get или user.search

operatorIdList integer[] необязательный

Список идентификаторов операторов.

Идентификаторы можно получить методом user.get или user.search.

Если переданы operatorIdList и operatorId, используется operatorIdList.

Максимум: 1000 элементов

Примеры запроса

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "dateFrom": "2026-06-01T00:00:00+03:00",
    "dateTo": "2026-06-30T23:59:59+03:00",
    "configId": 3
  }' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imopenlines.v2.Stat.get

Ответ

HTTP-статус: 200

{
    "result": {
        "totalSessions": 340,
        "closedSessions": 318,
        "spamSessions": 4,
        "avgWaitAnswer": 42.7,
        "avgSessionDuration": 612.3,
        "likeCount": 210,
        "dislikeCount": 15,
        "votedSessions": 225,
        "positiveRate": 0.9333,
        "kpiFirstAnswerOk": 300,
        "kpiFirstAnswerFail": 18,
        "sessionsBySource": [
            {
                "source": "livechat",
                "count": 200
            }
        ],
        "sessionsByHour": [0, 0, 0, 0, 0, 0, 2, 10, 25, 40, 38, 30, 28, 22, 20, 25, 30, 20, 15, 10, 8, 5, 3, 1],
        "sessionsByOperator": [
            {
                "operatorId": 42,
                "count": 120,
                "avgWaitAnswer": 38.1,
                "positiveRate": 0.95
            }
        ]
    },
    "time": {
        "start": 1782810000,
        "finish": 1782810000.3,
        "duration": 0.3,
        "processing": 0,
        "date_start": "2026-06-30T10:00:00+03:00",
        "date_finish": "2026-06-30T10:00:00+03:00",
        "operating_reset_at": 1782810600,
        "operating": 0
    }
}

Возвращаемые данные

result statResult

Агрегированная статистика за период.

Все поля типа statResult смотрите в разделе Типы данных статистики открытых линий

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "PERIOD_REQUIRED",
    "error_description": "dateFrom and dateTo are required"
}
Код Описание Значение
400 TARIFF_RESTRICTION Statistics reports are not available on the current tariff plan
400 PERIOD_REQUIRED dateFrom and dateTo are required
400 INVALID_FILTER Invalid filter value
400 PERIOD_TOO_LARGE The requested period exceeds the maximum of 1 year

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.