Получить список сессий imopenlines.v2.Session.list

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

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

Scope: imopenlines

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

Метод imopenlines.v2.Session.list получает список сессий открытых линий с фильтрами и пагинацией.

Параметры метода

Обязательные параметры отмечены *

Название `тип`	Описание
configId `integer`	Идентификатор открытой линии. Идентификатор можно получить методом imopenlines.config.list.get
configIdList `integer[]`	Список идентификаторов открытых линий. Идентификаторы можно получить методом imopenlines.config.list.get. Если переданы `configIdList` и `configId`, используется `configIdList`. Максимум: 1000 элементов
operatorId `integer`	Идентификатор оператора. Идентификатор можно получить методом user.get или user.search
operatorIdList `integer[]`	Список идентификаторов операторов. Идентификаторы можно получить методом user.get или user.search. Если переданы `operatorIdList` и `operatorId`, используется `operatorIdList`. Максимум: 1000 элементов
source `string`	Код канала. Код можно получить методом imconnector.list
sourceList `string[]`	Список кодов каналов. Коды можно получить методом imconnector.list. Если переданы `sourceList` и `source`, используется `sourceList`. Максимум: 1000 элементов
status `string`	Статус сессии. Возможные значения: `new` — сессия в очереди или пропущена `answered` — оператор ведет диалог `closed` — сессия закрыта `spam` — сессия помечена как спам `paused` — сессия на паузе
closeReason `string`	Причина закрытия. Нельзя передавать вместе со `status`. Возможные значения: `operator` — сессию закрыл оператор `auto` — сессия закрыта автоматически по таймауту `spam` — сессия закрыта как спам `client` — сессия закрыта по неактивности клиента `replyLimit` — сессия закрыта после истечения окна ответа канала
dateCreateFrom `string`	Начало периода создания в формате ISO 8601
dateCreateTo `string`	Конец периода создания в формате ISO 8601. Максимальный период: 366 дней
dateCloseFrom `string`	Начало периода закрытия в формате ISO 8601
dateCloseTo `string`	Конец периода закрытия в формате ISO 8601. Максимальный период: 366 дней
vote `string`	Клиентская оценка. Возможные значения: `like` — клиент поставил лайк `dislike` — клиент поставил дизлайк `none` — оценки нет `any` — есть любая клиентская оценка
hasVoteHead `boolean`	Фильтр по наличию оценки руководителя. Возможные значения: `true`, `Y`, `1` — есть оценка руководителя `false`, `N`, `0` — оценки руководителя нет
kpiFirstAnswer `boolean`	Фильтр по выполнению KPI первого ответа. Требует полного периода `dateCreateFrom` и `dateCreateTo` или `dateCloseFrom` и `dateCloseTo`. Возможные значения: `true`, `Y`, `1` — KPI первого ответа выполнен `false`, `N`, `0` — KPI первого ответа не выполнен
hasCrm `boolean`	Фильтр по наличию доступной связи с CRM. Возможные значения: `true`, `Y`, `1` — есть доступная связь с CRM `false`, `N`, `0` — доступной связи с CRM нет
waitAnswerFrom `integer`	Минимальное время до первого ответа, секунды
waitAnswerTo `integer`	Максимальное время до первого ответа, секунды
waitCloseFrom `integer`	Минимальное время до закрытия, секунды
waitCloseTo `integer`	Максимальное время до закрытия, секунды
order `string`	Поле сортировки. Возможные значения: `dateCreate` — дата создания сессии `dateClose` — дата закрытия сессии `waitAnswer` — время до первого ответа `waitClose` — время до закрытия По умолчанию: `dateCreate`
orderDirection `string`	Направление сортировки. Возможные значения: `asc` — по возрастанию `desc` — по убыванию По умолчанию: `desc`
offset `integer`	Смещение для пагинации. По умолчанию: `0`
limit `integer`	Размер страницы. Возможные значения: от `1` до `200`. По умолчанию: `50`

Фильтры комбинируются логическим И.

Сортировки dateClose, waitAnswer и waitClose применяются только при полном периоде создания или закрытия, иначе метод сортирует по dateCreate.

Поля voteHead и commentHead в элементах session возвращаются как null, если тариф или права пользователя не позволяют видеть оценку руководителя. Фильтр hasVoteHead применяется только к линиям, где у пользователя есть право на оценку руководителя.

Поля crmEntityType и crmEntityId в элементах session возвращаются как null, если у пользователя нет права чтения связанного объекта CRM. Фильтр hasCrm учитывает только доступные пользователю связи с CRM.

Примеры кода

Как использовать примеры в документации

cURL (Webhook)

cURL (OAuth)

JS (TS)

JS (UMD)

Python

PHP

BX24.js

PHP CRest

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "configId": 3,
    "status": "closed",
    "dateCreateFrom": "2026-06-01T00:00:00+03:00",
    "dateCreateTo": "2026-06-30T23:59:59+03:00",
    "limit": 50
  }' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imopenlines.v2.Session.list

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "configId": 3,
    "status": "closed",
    "dateCreateFrom": "2026-06-01T00:00:00+03:00",
    "dateCreateTo": "2026-06-30T23:59:59+03:00",
    "limit": 50,
    "auth": "**put_access_token_here**"
  }' \
  https://**put_your_bitrix24_address**/rest/imopenlines.v2.Session.list

import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

type SessionListResult = {
  sessions: Array<{ id: number, configId: number, status: string }>
  hasNextPage: boolean
}

try {
  const response = await $b24.actions.v2.call.make<SessionListResult>({
    method: 'imopenlines.v2.Session.list',
    params: {
      configId: 3,
      status: 'closed',
      dateCreateFrom: '2026-06-01T00:00:00+03:00',
      dateCreateTo: '2026-06-30T23:59:59+03:00',
      limit: 50,
    },
    requestId: Text.getUuidRfc4122()
  })

  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    console.info(response.getData()!.result.sessions)
  }
} catch (error) {
  console.error(error)
}

<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function getOpenlinesSessions() {
    try {
      const $b24 = await B24Js.initializeB24Frame()
      const response = await $b24.actions.v2.call.make({
        method: 'imopenlines.v2.Session.list',
        params: {
          configId: 3,
          status: 'closed',
          dateCreateFrom: '2026-06-01T00:00:00+03:00',
          dateCreateTo: '2026-06-30T23:59:59+03:00',
          limit: 50,
        },
        requestId: B24Js.Text.getUuidRfc4122()
      })

      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      console.info(response.getData().result.sessions)
    } catch (error) {
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', getOpenlinesSessions)
</script>

from b24pysdk.errors import BitrixAPIError, BitrixSDKException

try:
    bitrix_response = client.call(
        "imopenlines.v2.Session.list",
        {
            "configId": 3,
            "status": "closed",
            "dateCreateFrom": "2026-06-01T00:00:00+03:00",
            "dateCreateTo": "2026-06-30T23:59:59+03:00",
            "limit": 50,
        },
    ).response
    print(bitrix_response.result)
except BitrixAPIError as error:
    print(f"error: {error.error}", f"error_description: {error.error_description}", sep="\n")
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")

try {
    $response = $b24Service
        ->core
        ->call(
            'imopenlines.v2.Session.list',
            [
                'configId' => 3,
                'status' => 'closed',
                'dateCreateFrom' => '2026-06-01T00:00:00+03:00',
                'dateCreateTo' => '2026-06-30T23:59:59+03:00',
                'limit' => 50,
            ]
        );

    print_r($response->getResponseData()->getResult());
} catch (Throwable $e) {
    echo $e->getMessage();
}

BX24.callMethod(
    'imopenlines.v2.Session.list',
    {
        configId: 3,
        status: 'closed',
        dateCreateFrom: '2026-06-01T00:00:00+03:00',
        dateCreateTo: '2026-06-30T23:59:59+03:00',
        limit: 50,
    },
    function(result)
    {
        if (result.error())
        {
            console.error(result.error());
        }
        else
        {
            console.log(result.data());
        }
    }
);

require_once('crest.php');

$result = CRest::call(
    'imopenlines.v2.Session.list',
    [
        'configId' => 3,
        'status' => 'closed',
        'dateCreateFrom' => '2026-06-01T00:00:00+03:00',
        'dateCreateTo' => '2026-06-30T23:59:59+03:00',
        'limit' => 50,
    ]
);

print_r($result);

res, err := client.Core().Call(ctx, "imopenlines.v2.Session.list", b24.Params{
	"configId":        3,
	"status":          "closed",
	"dateCreateFrom":  "2026-06-01T00:00:00+03:00",
	"dateCreateTo":    "2026-06-30T23:59:59+03:00",
	"limit":           50,
}, b24.WithIdempotent())
if err != nil {
	return fmt.Errorf("imopenlines.v2.Session.list: %w", err)
}

fmt.Println(string(res.Result))

Обработка ответа

HTTP-статус: 200

{
    "result": {
        "sessions": [
            {
                "id": 1024,
                "configId": 3,
                "source": "livechat",
                "operatorId": 42,
                "userId": 501,
                "userCode": "site_visitor_88a1",
                "chatId": 2048,
                "dateCreate": "2026-06-15T14:30:00+03:00",
                "dateClose": "2026-06-15T14:52:10+03:00",
                "dateFirstAnswer": "2026-06-15T14:31:05+03:00",
                "dateOperatorAnswer": "2026-06-15T14:31:05+03:00",
                "status": "closed",
                "closeReason": "operator",
                "vote": "like",
                "voteHead": 5,
                "commentHead": "Хорошая работа",
                "crmEntityType": "deal",
                "crmEntityId": 771,
                "queueTransfers": 1,
                "waitAnswer": 65,
                "waitClose": 1330,
                "kpiFirstAnswer": true,
                "messageCount": 14
            }
        ],
        "hasNextPage": false
    },
    "time": {
        "start": 1782810000,
        "finish": 1782810000.4,
        "duration": 0.4,
        "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.sessions `session[]`	Список сессий. Все поля типа `session` смотрите в разделе Типы данных статистики открытых линий
result.hasNextPage `boolean`	Признак следующей страницы
time `time`	Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": "PERIOD_TOO_LARGE",
    "error_description": "The requested period exceeds the maximum of 1 year"
}

Название `тип`	Описание
error `string`	Строковый код ошибки. Состоит из цифр, латинских букв и знака подчеркивания. Может прийти пустым — тогда причину показывает только `error_description`
error_description `string`	Текст ошибки для разработчика. Не показывайте его конечному пользователю без обработки

Возможные коды ошибок

Статус	Код	Описание	Значение
`400`	`TARIFF_RESTRICTION`	Statistics reports are not available on the current tariff plan	Тариф не позволяет использовать отчеты открытых линий
`400`	`INVALID_FILTER`	Invalid filter value	Передан некорректный фильтр, дата, порядок дат, сочетание `status` и `closeReason`, список больше 1000 элементов или `kpiFirstAnswer` без полного периода
`400`	`PERIOD_TOO_LARGE`	The requested period exceeds the maximum of 1 year	Период создания или закрытия больше 366 дней
`400`	`OFFSET_TOO_LARGE`	Offset is too large	`offset` больше `10000`

Статусы и коды системных ошибок

HTTP-статус: 4xx, 5xx

Описанные ниже ошибки возвращает сам REST API, а не логика конкретного метода. Они могут прийти в ответ на любой метод.

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Сервер вернул неожиданный ответ. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`429`	`OPERATION_TIME_LIMIT` Method is blocked due to operation time limit	Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически, когда накопленное время выполнения метода перестает превышать лимит
`401`	`NO_AUTH_FOUND` Wrong authorization data	В запросе нет авторизационных данных: не передан ни access-токен, ни код вебхука
`401`	`INVALID_REQUEST` Https required	Методы вызываются только по протоколу HTTPS
`401`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка. Чтобы ее снять, обратитесь в техническую поддержку Битрикс24
`401`	`ACCESS_DENIED` REST is available only on commercial plans	REST API доступен только на коммерческих тарифах. У вебхука текст ошибки другой — `REST is available only by subscription`
`401`	`INVALID_CREDENTIALS` Invalid request credentials	Не найден активный вебхук с указанным идентификатором пользователя и секретным кодом
`404`	`ERROR_METHOD_NOT_FOUND` Method not found!	Метод с таким именем не найден. Имя написано с ошибкой, метода нет в REST API или он недоступен без нужного скоупа
`401`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более широких прав, чем есть у токена: у вебхука это выданные ему права, у приложения — скоуп. У приложения текст ошибки заканчивается на `provided by the access token`
`401`	`expired_token` The access token provided has expired	Срок действия access-токена истек
`401`	`user_access_error` The user does not have access to the application	Приложение установлено, но администратор Битрикс24 открыл доступ к нему только конкретным пользователям
`403`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть ее на коробочной установке, отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

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

Была ли статья полезна?

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

Получить метрики сессий

Получить список сессий imopenlines.v2.Session.list

Параметры методаПараметры метода

Примеры кодаПримеры кода

Обработка ответаОбработка ответа

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

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

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

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