метод REST scope: imopenlines, imbot

imopenlines.bot.session.transfer

Перевести диалог на оператора или очередь

Кто может выполнять: пользователь приложения с зарегистрированным чат-ботом

Описание

Метод imopenlines.bot.session.transfer переводит диалог открытой линии от чат-бота на указанного оператора или очередь.

Параметры

CHAT_ID integer обязательный

Идентификатор чата, диалог которого нужно перевести.

Идентификатор чата можно получить с помощью методов imopenlines.dialog.get или imopenlines.crm.chat.get

USER_ID integer необязательный

Идентификатор сотрудника, на которого нужно перевести диалог.

Идентификатор пользователя можно получить с помощью методов user.get или user.search

QUEUE_ID integer необязательный

Идентификатор очереди, в которую нужно перевести диалог.

В параметр передавайте значение поля ID из ответа метода imopenlines.config.list.get.

Поле QUEUE из ответа imopenlines.config.list.get содержит USER_ID сотрудников очереди и не подходит как QUEUE_ID

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

Универсальный параметр назначения перевода.

Допустимые форматы: USER_ID сотрудника или строка queue<QUEUE_ID>.

Идентификатор пользователя можно получить методами user.get и user.search, идентификатор очереди — методом imopenlines.config.list.get

LEAVE boolean необязательный

Флаг присутствия чат-бота в диалоге после перевода.

Допустимые значения:
- Y — бот покидает чат сразу
- N — бот остается до подтверждения перевода

По умолчанию используется N

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

Параметр обязателен только для вебхуков.

Передавайте:
- тот же CLIENT_ID, который был указан при регистрации чат-бота методом imbot.register
- или значение параметра botToken, переданного при регистрации чат-бота методом imbot.v2.Bot.register

Примеры запроса

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"CHAT_ID":112,"USER_ID":12,"LEAVE":"N","CLIENT_ID":"**put_your_client_id_or_bot_token_here**"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imopenlines.bot.session.transfer

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1728626400.456,
        "finish": 1728626400.539,
        "duration": 0.083,
        "processing": 0.031,
        "date_start": "2024-10-11T10:00:00+03:00",
        "date_finish": "2024-10-11T10:00:00+03:00",
        "operating": 0
    }
}

Возвращаемые данные

result boolean

Содержит true, если диалог успешно переведен

time time

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

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

HTTP-статус: 400

{
    "error": "TRANSFER_ID_EMPTY",
    "error_description": "Queue ID or User ID can't be empty"
}
Код Описание Значение
400 CHAT_ID_EMPTY Chat ID can't be empty
400 USER_ID_EMPTY User ID can't be empty
400 QUEUE_ID_EMPTY QUEUE ID can't be empty
400 TRANSFER_ID_EMPTY Queue ID or User ID can't be empty
400 BOT_ID_ERROR Bot not found
400 OPERATOR_WRONG You can not redirect to this operator
403 WRONG_AUTH_TYPE Access for this method not allowed by session authorization

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

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