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

Передать диалог

POST /v1/openlines/operator/transfer

Передаёт текущую сессию чата Открытой линии другому сотруднику или в очередь линии.

Действие выполняется от имени сотрудника, к которому привязан ключ, — см. От чьего имени выполняется действие.

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

Поле Тип Обяз. Описание
ПолеchatId Типnumber | string Обяз.да ОписаниеИдентификатор чата Открытой линии — положительное целое. Строка принимается, если состоит только из цифр и не начинается с нуля. См. Идентификатор чата
ПолеuserId Типnumber | string Обяз.нет ОписаниеID сотрудника, которому передаётся диалог. Список: GET /v1/users
ПолеqueueId Типnumber | string Обяз.нет ОписаниеID линии, в очередь которой передаётся диалог. Список: GET /v1/openline-configs
ПолеtransferId Типnumber | string Обяз.нет ОписаниеЦель одним значением: строка queue<id> — очередь линии, например queue59, число или строка из цифр — ID сотрудника

Из полей userId, queueId и transferId передайте ровно одно.

Примеры

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/openlines/operator/transfer \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chatId": 5255,
    "userId": 1295
  }'

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/openlines/operator/transfer \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chatId": 5255,
    "userId": 1295
  }'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/openlines/operator/transfer', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    chatId: 5255,
    userId: 1295,
  }),
})

const { success, data, error } = await res.json()
if (!success) throw new Error(`${error.code}: ${error.message}`)
console.log('Передан:', data.transferred)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/openlines/operator/transfer', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    chatId: 5255,
    userId: 1295,
  }),
})

const { success, data } = await res.json()

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean Описаниеtrue при успешной передаче
Полеdata.chatId Типnumber ОписаниеИдентификатор чата из запроса. Строка из запроса возвращается числом
Полеdata.transferred Типboolean ОписаниеВсегда true

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

JSON 
{
  "success": true,
  "data": {
    "chatId": 5255,
    "transferred": true
  }
}

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

400 — передано больше одной цели:

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Pass exactly one target: userId, queueId or transferId"
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодINVALID_CHAT_ID ОписаниеchatId не передан, не положительное целое, строка не из одних цифр или с ведущим нулём, либо число больше 9007199254740991
HTTP400 КодINVALID_PARAMS ОписаниеЦель не передана, передано больше одной цели, или значение цели не является положительным целым числом либо строкой queue<id>
HTTP404 КодENTITY_NOT_FOUND ОписаниеЧата с таким chatId нет
HTTP422 КодBITRIX_ERROR ОписаниеБитрикс24 отказал в передаче, его код приходит в error.b24Code. OPERATOR_WRONG с текстом You can not redirect to this operator приходит в двух случаях: цель — сам сотрудник, от имени которого идёт вызов, или чата с таким chatId нет
HTTP403 КодBITRIX_ACCESS_DENIED ОписаниеУ сотрудника, от имени которого идёт вызов, нет прав на действие
HTTP502 КодOPENLINE_OPERATOR_FAILED ОписаниеБитрикс24 не подтвердил передачу и не вернул ошибку
HTTP403 КодSCOPE_DENIED ОписаниеУ ключа нет скоупа imopenlines
HTTP403 КодWRITE_BLOCKED_READONLY_KEY ОписаниеКлюч работает только на чтение
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key
HTTP401 КодINVALID_API_KEY ОписаниеКлюч не опознан
HTTP401 КодTOKEN_MISSING ОписаниеУ личного ключа нет доступа к порталу Битрикс24, у ключа приложения не передан токен сессии в Authorization
HTTP502 КодBITRIX_UNAVAILABLE ОписаниеБитрикс24 недоступен или соединение с ним оборвалось до полного ответа

Полный список общих ошибок API — Ошибки.

Известные особенности

  • Передача сотруднику сохраняет сессию. Идентификатор сессии не меняется, меняется её оператор, а счётчик queueTransfers в списке сессий растёт на единицу.
  • Передача в очередь открывает новую сессию. После передачи по queueId или transferId вида queue<id> чат продолжается новой сессией со статусом new и без оператора. Её идентификатор ищите в списке сессий по chatId.

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