метод REST scope: imopenlines

imopenlines.v2.Session.Rating.list

Получить список оценок

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

Описание

Метод imopenlines.v2.Session.Rating.list получает список сессий, которым клиент поставил оценку.

Параметры

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

Начало периода клиентской оценки в формате ISO 8601

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

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

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

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 элементов

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

Клиентская оценка.

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

  • like — клиент поставил лайк
  • dislike — клиент поставил дизлайк
hasVoteHead 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,
    "vote": "like",
    "dateVoteFrom": "2026-06-01T00:00:00+03:00",
    "dateVoteTo": "2026-06-30T23:59:59+03:00"
  }' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imopenlines.v2.Session.Rating.list

Ответ

HTTP-статус: 200

{
    "result": {
        "ratings": [
            {
                "sessionId": 1024,
                "configId": 3,
                "operatorId": 42,
                "source": "livechat",
                "vote": "like",
                "voteHead": 5,
                "commentHead": "Хорошая работа",
                "dateVote": "2026-06-15T14:53:00+03:00",
                "dateSessionClose": "2026-06-15T14:52:10+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.ratings rating[]

Список сессий с клиентской оценкой.

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

result.hasNextPage boolean

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

time time

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

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

HTTP-статус: 400

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

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

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