TransferToOperator

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

Перед тем как использовать этот тег, подключите к своему проекту один из операторских каналов.

подсказка

Если вы хотите переводить диалог на оператора без тегов действий, но из вставок JavaScript-кода, используйте ответы с типом switch в $response.replies.

Параметры

Все параметры этого тега необязательны.

Параметр	Тип	Описание
titleOfCloseButton	Строка	Текст кнопки перевода диалога обратно на бота. С помощью этой кнопки пользователь может прекратить общение с оператором и вернуться к диалогу с ботом.
messageBeforeTransfer	Строка	Сообщение перед переводом на оператора. Должно оповещать пользователя, что сейчас с ним будет говорить оператор. Если вы хотите использовать в сообщении HTML-разметку, вы можете не указывать этот параметр и использовать только messageBeforeTransferHtml.
messageBeforeTransferHtml	Строка	Сообщение перед переводом на оператора с использованием HTML-разметки. Если вы не хотите использовать HTML-разметку, вы можете не указывать этот параметр и использовать только messageBeforeTransfer.
prechatAttributes	Объект	Информация о пользователе, которую необходимо передать оператору. Укажите значение в формате: prechatAttributes = { "Ключ 1": "Значение 1", "Ключ 2": "Значение 2" } • Ключ — название поля, которое ожидает операторский чат. • Значение — информация, которую нужно передать оператору при переводе. Параметр используется только для операторских каналов: Aimychat и LiveTex.
ignoreOffline	Логический	Ожидать ли свободных операторов. Определяет дальнейшие действия, если в момент перевода диалога нет свободных операторов: • true — будет показано значение параметра messageForWaitingOperator или messageForWaitingOperatorHtml. • false — произойдет переход в стейт из параметра noOperatorsOnlineState.
messageForWaitingOperator	Строка	Текст, который будет отправлен пользователю перед ожиданием свободных операторов. Если вы хотите использовать в сообщении HTML-разметку, вы можете не указывать этот параметр и использовать только messageForWaitingOperatorHtml.
messageForWaitingOperatorHtml	Строка	Текст, который будет отправлен пользователю перед ожиданием свободных операторов, с использованием HTML-разметки. Если вы не хотите использовать HTML-разметку, вы можете не указывать этот параметр и использовать только messageForWaitingOperator.
sendMessageHistoryAmount	Число	Количество последних сообщений пользователя, которые будут переданы оператору. Указывайте этот параметр, только если для параметра sendMessagesToOperator вы передали значение true.
sendMessagesToOperator	Логический	Передавать ли оператору историю сообщений пользователя.
noOperatorsOnlineState	Строка	Стейт, в который перейдет диалог, если на момент перевода диалога нет свободных операторов.
dialogCompletedState	Строка	Стейт, в который перейдет диалог, когда диалог с оператором будет завершен. Диалог может завершить: • клиент — по кнопке завершения диалога (параметр titleOfCloseButton); • оператор, если такая опция есть в операторском канале.
actions	Массив объектов	Кнопки, которые будут отправлены вместе с запросом. Укажите значение в формате: actions = [{ "buttons": [{ "name": "Текст кнопки", "transition": "/Путь до стейта" }], "type": "buttons" }]
htmlEnabled	Логический	Использовать ли HTML-разметку в сообщении перед переводом на оператора и ожиданием свободных. Определяет, значения каких параметров будут отображаться клиенту: • true — будут показаны значения параметров messageBeforeTransfer и messageForWaitingOperator; • false — будут показаны значения параметров messageBeforeTransferHtml и messageForWaitingOperatorHtml.
destination	Строка	Идентификатор группы операторов, на которую нужно перевести диалог. Параметр используется только для Aimychat и Operator API.

Использование в сценарии

state: Switch
    intent!: /Перевод на оператора
    TransferToOperator:
        titleOfCloseButton = Переключить обратно на бота
        messageBeforeTransfer = Подождите немного. Соединяю вас со специалистом.
        ignoreOffline = false
        messageForWaitingOperator = Вам ответит первый освободившийся оператор.
        noOperatorsOnlineState = /Switch/Error
        dialogCompletedState = /AnythingElse
        sendMessageHistoryAmount = 5
        sendMessagesToOperator = true

    state: Error
        a: К сожалению, все операторы сейчас заняты. Мы обязательно свяжемся с вами позже.
        go!: /AnythingElse

state: AnythingElse
    a: Могу ли я еще чем-нибудь вам помочь?