метод REST scope: imopenlines

imopenlines.v2.Operator.list

Получить список операторов

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

Описание

Метод imopenlines.v2.Operator.list получает список операторов с текущим статусом и нагрузкой.

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • online — оператор онлайн и не на паузе
  • offline — оператор не в сети
  • pause — оператор поставил себя на паузу
hasFreeSlots boolean необязательный

Фильтр по наличию свободных слотов.

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

  • true, Y, 1 — есть свободные слоты
  • false, N, 0 — свободных слотов нет
offset integer необязательный

Смещение для пагинации.

По умолчанию: 0

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

Размер страницы.

Возможные значения: от 1 до 200.

По умолчанию: 50

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "configId": 3,
    "status": "online",
    "limit": 50
  }' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imopenlines.v2.Operator.list

Ответ

HTTP-статус: 200

{
    "result": {
        "operators": [
            {
                "userId": 42,
                "configId": 3,
                "status": "online",
                "activeSessions": 2,
                "maxChat": 5,
                "freeSlots": 3,
                "lastActivityDate": "2026-06-15T15:01:00+03:00"
            }
        ],
        "hasNextPage": false
    },
    "time": {
        "start": 1782810000,
        "finish": 1782810000.2,
        "duration": 0.2,
        "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 object

Корневой объект ответа

result.operators operatorLoad[]

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

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

result.hasNextPage boolean

Признак следующей страницы

time time

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

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

HTTP-статус: 400

{
    "error": "INVALID_FILTER",
    "error_description": "Invalid status filter value"
}
Код Описание Значение
400 TARIFF_RESTRICTION Statistics reports are not available on the current tariff plan
400 INVALID_FILTER Invalid status filter value
400 OFFSET_TOO_LARGE Offset is too large

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

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