Для AI-агентов: markdown этой страницы — /docs-content/bots/openlines/transfer.md индекс документации — /llms.txt
Перевести сессию
POST /v1/bots/:botId/openlines/session/transfer
Метод Б24: imopenlines.bot.session.transfer. Нужны imbot и imopenlines, владеющий ботом ключ и разрешённая запись.
curl -X POST "https://vibecode.bitrix24.tech/v1/bots/621/openlines/session/transfer" \
-H "X-Api-Key: $VIBE_API_KEY" -H "Content-Type: application/json" \
-d '{"chatId": 2043, "queueId": 7, "leave": true}'Передайте ровно одну цель: userId, queueId или transferId. Первые две — положительные безопасные целые либо числовые строки. transferId — идентификатор пользователя или queue<N> с любым регистром префикса. Поддерживаются алиасы USER_ID, QUEUE_ID, TRANSFER_ID. leave / LEAVE принимают только true, false, Y, N; по умолчанию N.
{
"success": true,
"data": {
"chatId": 2043,
"transferred": true
}
}Идентификаторы: chatId / dialogId / CHAT_ID — общие правила.
Отказы
| HTTP | Коды |
|---|---|
| 400 | INVALID_BOT_ID / INVALID_CHAT_ID / INVALID_PARAMS / MISSING_REQUIRED_FIELDS / MISSING_TRANSFER_TARGET / INVALID_TRANSFER_TARGET |
| 401 | MISSING_API_KEY / TOKEN_MISSING |
| 403 | SCOPE_DENIED / BOT_ACCESS_DENIED / WRITE_BLOCKED_READONLY_KEY / BITRIX_ACCESS_DENIED |
| 404 | BOT_NOT_FOUND / ENTITY_NOT_FOUND |
| 410 | BOT_DISABLED |
| 422 | BITRIX_ERROR; b24Code содержит отказ Б24, например WRONG_CHAT, BOT_ID_ERROR, OPERATOR_WRONG или WRONG_AUTH_TYPE |
| 429 | RATE_LIMITED или очередь портала |
| 502 | OPENLINE_BOT_SESSION_FAILED / BITRIX_UNAVAILABLE |
| 503 | BITRIX_TIMEOUT или заморозка удаления владельца ключа |
Бизнес-текст Б24 сохраняется с удалением секретов. Чужие сессии при проверке не изменяйте.