# imopenlines.v2.Stat.get URL: https://chugunov.pro/api-bitrix24/imopenlines/statistics/imopenlines-v2-stat-get/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Получить агрегированную статистику Scope: `imopenlines` Кто может выполнять метод: пользователь с доступом к отчетам открытых линий ## Описание Метод `imopenlines.v2.Stat.get` получает агрегированную статистику открытых линий за период. ## Параметры - `dateFrom` `string` — обязательный. Начало периода в формате ISO 8601 - `dateTo` `string` — обязательный. Конец периода в формате ISO 8601. Максимальный период: 366 дней - `configId` `integer` — необязательный. Идентификатор открытой линии. Идентификатор можно получить методом [imopenlines.config.list.get](https://chugunov.pro/api-bitrix24/imopenlines/openlines/imopenlines-config-list-get/) - `configIdList` `integer[]` — необязательный. Список идентификаторов открытых линий. Идентификаторы можно получить методом [imopenlines.config.list.get](https://chugunov.pro/api-bitrix24/imopenlines/openlines/imopenlines-config-list-get/). Если переданы `configIdList` и `configId`, используется `configIdList`. Максимум: 1000 элементов - `source` `string` — необязательный. Код канала. Код можно получить методом [imconnector.list](https://chugunov.pro/api-bitrix24/imopenlines/imconnector/imconnector-list/) - `sourceList` `string[]` — необязательный. Список кодов каналов. Коды можно получить методом [imconnector.list](https://chugunov.pro/api-bitrix24/imopenlines/imconnector/imconnector-list/). Если переданы `sourceList` и `source`, используется `sourceList`. Максимум: 1000 элементов - `operatorId` `integer` — необязательный. Идентификатор оператора. Идентификатор можно получить методом [user.get](https://chugunov.pro/api-bitrix24/user/user-get/) или [user.search](https://chugunov.pro/api-bitrix24/user/user-search/) - `operatorIdList` `integer[]` — необязательный. Список идентификаторов операторов. Идентификаторы можно получить методом [user.get](https://chugunov.pro/api-bitrix24/user/user-get/) или [user.search](https://chugunov.pro/api-bitrix24/user/user-search/). Если переданы `operatorIdList` и `operatorId`, используется `operatorIdList`. Максимум: 1000 элементов ## Ответ HTTP-статус: 200 ```json { "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`](https://apidocs.bitrix24.ru/api-reference/imopenlines/statistics/data-types.html#stat-result) смотрите в разделе [Типы данных статистики открытых линий](https://apidocs.bitrix24.ru/api-reference/imopenlines/statistics/data-types.html#stat-result) - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "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 ## Примеры запроса ### cURL (Webhook) ```bash 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 ``` ### cURL (OAuth) ```bash 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, "auth": "**put_access_token_here**" }' \ https://**put_your_bitrix24_address**/rest/imopenlines.v2.Stat.get ``` ### JS (TS) ```ts import { Text } from '@bitrix24/b24jssdk' import type { B24Frame } from '@bitrix24/b24jssdk' declare const $b24: B24Frame type StatResult = { totalSessions: number closedSessions: number spamSessions: number avgWaitAnswer: number avgSessionDuration: number likeCount: number dislikeCount: number votedSessions: number positiveRate: number kpiFirstAnswerOk: number kpiFirstAnswerFail: number sessionsBySource: Array<{ source: string, count: number }> sessionsByHour: number[] sessionsByOperator: Array<{ operatorId: number, count: number, avgWaitAnswer: number, positiveRate: number }> } try { const response = await $b24.actions.v2.call.make({ method: 'imopenlines.v2.Stat.get', params: { dateFrom: '2026-06-01T00:00:00+03:00', dateTo: '2026-06-30T23:59:59+03:00', configId: 3, }, requestId: Text.getUuidRfc4122() }) if (!response.isSuccess) { console.error(response.getErrorMessages().join('; ')) } else { console.info(response.getData()!.result) } } catch (error) { console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from b24pysdk.errors import BitrixAPIError, BitrixSDKException try: bitrix_response = client.call( "imopenlines.v2.Stat.get", { "dateFrom": "2026-06-01T00:00:00+03:00", "dateTo": "2026-06-30T23:59:59+03:00", "configId": 3, }, ).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}") ``` ### PHP ```php try { $response = $b24Service ->core ->call( 'imopenlines.v2.Stat.get', [ 'dateFrom' => '2026-06-01T00:00:00+03:00', 'dateTo' => '2026-06-30T23:59:59+03:00', 'configId' => 3, ] ); print_r($response->getResponseData()->getResult()); } catch (Throwable $e) { echo $e->getMessage(); } ``` ### BX24.js ```js BX24.callMethod( 'imopenlines.v2.Stat.get', { dateFrom: '2026-06-01T00:00:00+03:00', dateTo: '2026-06-30T23:59:59+03:00', configId: 3, }, function(result) { if (result.error()) { console.error(result.error()); } else { console.log(result.data()); } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'imopenlines.v2.Stat.get', [ 'dateFrom' => '2026-06-01T00:00:00+03:00', 'dateTo' => '2026-06-30T23:59:59+03:00', 'configId' => 3, ] ); print_r($result); ``` ### Go ```go res, err := client.Core().Call(ctx, "imopenlines.v2.Stat.get", b24.Params{ "dateFrom": "2026-06-01T00:00:00+03:00", "dateTo": "2026-06-30T23:59:59+03:00", "configId": 3, }, b24.WithIdempotent()) if err != nil { return fmt.Errorf("imopenlines.v2.Stat.get: %w", err) } fmt.Println(string(res.Result)) ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/imopenlines/statistics/imopenlines-v2-stat-get.html