Открытые линии

Открытые линии Битрикс24 (модуль imopenlines) — входящие обращения из мессенджеров и социальных сетей, распределение по операторам, интеграция с CRM и оценка качества обслуживания. Раздел покрывает две грани модуля: управление настройками линий и статистику дашборда руководителя контакт-центра.

• Базовый URL: https://vibecode.bitrix24.tech
• Аутентификация: заголовок X-Api-Key (личный ключ) или X-Api-Key + Authorization: Bearer (OAuth-приложение)
• Скоуп ключа: imopenlines

Быстрый старт | Полный пример | Справочник эндпоинтов | Коды ошибок

Что входит в раздел

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

Конфигурация линий

Управление настройками открытых линий — создание, список, получение, изменение, удаление, поиск. Общедоступно, раскатки обновления не требует. Здесь же живут два действия оператора над диалогом — принять (answer) и завершить (finish).

Полная документация: Конфигурация линий.

Статистика (дашборд)

Методы статистики в процессе раскатки — выходят в обновлении imopenlines 26.700.0. Доступны не на всех порталах Битрикс24. Если на вашем портале методы ещё не доступны, API вернёт 422 METHOD_NOT_YET_AVAILABLE — это не ошибка интеграции, а признак того, что обновление пока не приехало на портал.

Список обращений с метриками, нагрузка операторов в реальном времени, агрегаты по линии, оценки клиентов (CSAT) и история переназначений. Все методы — только чтение. Данные видны в пределах прав пользователя, от имени которого работает ключ: если у него нет доступа ни к одной линии, метод возвращает пустой результат (или нулевые агрегаты), а не ошибку. Методам нужен доступ к статистике Открытых линий — право report_open_lines. Без него запрос вернёт 403 B24_TARIFF_RESTRICTION.

Все шесть методов выходят в обновлении imopenlines 26.700.0. Имена методов Битрикс24 для сверки с документацией Битрикс24 — в Справочнике эндпоинтов.

Типичные сценарии

Рекомендации

• Для сводных показателей используйте stats — он считает агрегаты на стороне Битрикс24. Не собирайте те же цифры клиентской агрегацией через sessions/search: это упирается в лимит запросов REST Битрикс24.
• operators отдаёт данные почти в реальном времени (статус и счётчик активных чатов читаются раздельно). Для виджета мониторинга опрашивайте метод не чаще одного раза в 30 секунд.
• stats — тяжёлый метод: запрашивайте его не чаще одного раза в 30–60 секунд и кэшируйте результат на своей стороне.
• Статистика звонков живёт отдельно — GET /v1/calls/statistics. Статистика Открытых линий использует POST-формы, потому что несёт богатые фильтры.

Быстрый старт

Агрегаты по линии за июнь:

curl -X POST "https://vibecode.bitrix24.tech/v1/openlines/stats" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dateFrom": "2026-06-01T00:00:00+03:00",
    "dateTo": "2026-06-30T23:59:59+03:00",
    "configId": 3
  }'

{
  "success": true,
  "data": {
    "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 }, { "source": "whatsapp", "count": 140 }],
    "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 }]
  }
}

Полный пример

Отчёт «обращения за месяц с разбором проблемных сессий»:

1. POST /v1/openlines/stats c dateFrom/dateTo — сводные показатели по линии.
2. POST /v1/openlines/sessions/search c тем же периодом и limit: 50 — первая страница списка сессий. Пагинация по страницам: увеличивайте offset на limit, пока data.hasNextPage равно true.
3. POST /v1/openlines/sessions/stats c массивом sessionId (до 100) — детальные метрики выбранных сессий.

Для стабильной постраничной выгрузки фиксируйте верхнюю границу периода: возьмите dateCreateTo равным моменту старта выгрузки. Без фиксированной границы новые сессии, пришедшие во время листания, сдвигают страницы, и записи на стыках могут повториться или пропасть.

Справочник эндпоинтов

Все 16 эндпоинтов раздела:

Конфигурация линий и действия оператора работают на любом портале. Шесть методов статистики выходят в обновлении imopenlines 26.700.0 — до его доезда на портал они отвечают 422, см. Статистика (дашборд). У GET /v1/openline-configs/fields вызова Битрикс24 нет — схему полей отдаёт Вайбкод.

Коды ошибок

Ошибки Открытых линий

При отказе Битрикс24 ответ приходит как 422 BITRIX_ERROR, а сырой код Битрикс24 дублируется в поле error.b24Code:

Системные ошибки

Общие коды (SCOPE_DENIED, TOKEN_MISSING, RATE_LIMITED и другие) — на странице Ошибки API.

Смотрите также

• Конфигурация линий
• Чаты и сообщения
• Журнал изменений API