Перевод диалога

Робот Перевод диалога ([OL] Передать диалог) переводит активный диалог открытой линии на другого оператора или в очередь другой открытой линии. Это позволяет автоматически маршрутизировать обращения клиентов.

Назначение

Автоматически перевести диалог на конкретного оператора
Перенаправить диалог в очередь другой открытой линии
Настроить маршрутизацию обращений по типу запроса или стадии сделки

Параметры

Параметр	Описание	Обязательный
ID диалога	ID диалога открытой линии	Да*
ID чата (legacy)	ID чата (устаревший параметр, используется при отсутствии ID диалога)	Нет
TRANSFER_ID	ID оператора или идентификатор очереди в формате `queue#ID_ЛИНИИ`	Нет**
ID нового оператора	ID пользователя Битрикс24 (тип: пользователь)	Нет**

* Необходимо указать ID диалога или ID чата. ** Необходимо указать TRANSFER_ID или ID нового оператора.

Формат TRANSFER_ID

Значение	Описание
`42`	Перевести на пользователя Битрикс24 с ID 42
`queue#5`	Перевести в очередь открытой линии №5

Настройка в редакторе роботов

Шаг 1. Добавьте робота

На нужной стадии воронки добавьте робота [OL] Передать диалог из раздела Олчат.

Шаг 2. Укажите диалог

Введите или подставьте из переменной ID диалога.

Шаг 3. Укажите получателя

Выберите способ указания получателя:

ID нового оператора — выберите пользователя Битрикс24 из списка
TRANSFER_ID — введите ID пользователя или очереди (для гибкой маршрутизации)

Настройка в дизайнере бизнес-процессов

В дизайнере бизнес-процессов действие доступно в разделе Действия приложений. Параметр ID нового оператора поддерживает тип «Пользователь» для удобного выбора.

Возвращаемые значения

Значение	Тип	Описание
`success`	bool	Успешность перевода: `Y` или `N`
`error`	string	Текст ошибки
`error_code`	string	Код ошибки

Коды ошибок

Код	Описание
`DIALOG_ID_EMPTY`	ID диалога не указан
`TRANSFER_ID_EMPTY`	Не указан ни TRANSFER_ID, ни ID оператора
`TRANSFER_ERROR`	Ошибка при переводе диалога

Примеры использования

Перевод на ответственного менеджера

При смене ответственного в сделке автоматически перевести диалог:

На стадии смены ответственного добавьте робота Передать диалог
В поле ID нового оператора вставьте переменную {{Ответственный}}

Перевод в очередь отдела

Автоматически перенаправить диалог в техническую поддержку:

Добавьте робота Передать диалог
В поле TRANSFER_ID укажите queue#7 (где 7 — номер линии техподдержки)

Примечания и рекомендации

Перевод на конкретного оператора назначает его ответственным за диалог
Перевод в очередь распределяет диалог по правилам очереди указанной открытой линии
При переводе клиент не получает уведомлений — для него общение продолжается в том же чате