Для AI-агентов: markdown этой страницы — /docs-content/openlines/sessions/transfers.md индекс документации — /llms.txt

История переназначений

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

POST /v1/openlines/sessions/transfers

Хронологический список переназначений (переводов) по конкретным сессиям — от кого к кому, между какими линиями, по какой причине. До 50 идентификаторов за один вызов.

Поля запроса (body)

Поле Тип Обяз. Описание
sessionId number[] да Массив идентификаторов сессий, до 50 элементов. Источник: POST /v1/openlines/sessions/search. Одиночное число тоже принимается и оборачивается в массив

Дубликаты в sessionId схлопываются. Несуществующий, чужой или недоступный sessionId не приводит к ошибке — для него просто не будет записей в transfers.

Примеры

curl — личный ключ

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/openlines/sessions/transfers" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "sessionId": [1024, 1025] }'

curl — OAuth-приложение

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/openlines/sessions/transfers" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "sessionId": [1024, 1025] }'

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/openlines/sessions/transfers', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ sessionId: [1024, 1025] }),
})
const { data } = await res.json()

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/openlines/sessions/transfers', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ sessionId: [1024, 1025] }),
})
const { data } = await res.json()

Поля ответа

Ответ — { "success": true, "data": { "transfers": [...] } }. Переводы всех запрошенных сессий идут вперемешку, в хронологическом порядке (по date по возрастанию). Для группировки по сессиям используйте поле transfers[].sessionId.

Ключ Описание
sessionId Идентификатор сессии
date Дата и время переназначения
fromOperatorId Оператор, от которого ушло (null, если из очереди)
toOperatorId Оператор, которому пришло (null, если в очередь)
fromConfigId Линия-источник
toConfigId Линия-назначение (если перевод в другую линию)
reason Причина: manual / auto
mode Режим: MANUAL / AUTO
type Тип: USER / QUEUE
initiatorId Инициатор перевода (null, если автоматически)

Пример ответа

Сессия 1024 — авто-распределение из очереди, затем ручной перевод оператору; сессия 1025 — без переводов:

JSON 
{
  "success": true,
  "data": {
    "transfers": [
      { "sessionId": 1024, "date": "2026-06-15T14:30:05+03:00", "fromOperatorId": null, "toOperatorId": 42, "fromConfigId": 3, "toConfigId": null, "reason": "auto", "mode": "AUTO", "type": "USER", "initiatorId": null },
      { "sessionId": 1024, "date": "2026-06-15T14:40:00+03:00", "fromOperatorId": 42, "toOperatorId": 51, "fromConfigId": 3, "toConfigId": null, "reason": "manual", "mode": "MANUAL", "type": "USER", "initiatorId": 42 }
    ]
  }
}

Пример ответа при ошибке

400 — в батче больше 50 идентификаторов:

JSON 
{
  "success": false,
  "error": { "code": "BATCH_LIMIT_EXCEEDED", "message": "sessionId batch must not exceed 50 unique ids" }
}

Ошибки

HTTP Код Когда
403 B24_TARIFF_RESTRICTION Тариф не включает статистику Открытых линий (report_open_lines)
400 MISSING_PARAMS sessionId пустой массив или не передан
400 INVALID_PARAMS Нечисловой элемент в sessionId
400 BATCH_LIMIT_EXCEEDED Больше 50 уникальных идентификаторов (после схлопывания дублей)
422 METHOD_NOT_YET_AVAILABLE Обновление imopenlines 26.700.0 ещё не приехало на портал

Полный список системных кодов — Ошибки API.

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