Перевести на оператора и Вернуть боту

Результатом работы данных команд является перевод диалога на оператора CRM или перевод обратно с оператора на бота.

Функциональная команда Перевести на оператора позволяет выполнить перевод на оператора и установить по лиду параметр Чат передан оператору. А функциональная команда Вернуть боту позволяет выполнить возврат диалога обратно боту и автоматически снимает по лиду этот параметр.

Добавить в скрипт их можно, выбрав пункты Перевести на оператора и Вернуть боту из списка Команд:

Настройка полей

После выбора команды в списке Команд перед вами откроется диалоговое окно настройки свойств:

С пунктом Использовать условие вы можете познакомиться в статье 

В поле Если не поддерживается, то перевести в статус можно указать в какой статус при выполнении данной команды будет переведен лид. Поле не обязательное для заполнения.

При выполнении команды Перевести на оператора по Лиду будет установлен параметр Чат передан оператору и бот будет молчать.  Командой Вернуть боту по лиду снимается параметр Чат передан оператору и она должна быть установлена в скрипт, который будет запускаться по маршруту с активным параметром Действует при переводе на оператора.

По кнопке Создать как итог команда появится в редакторе скрипта:

Как правильно использовать данные команды можно подробнее узнать в уроке Автоматизируем службу поддержки

JS методы для работы с переключением на оператора

К переключению на оператора можно обращаться из JS следующими методами:

Название метода	Метод
Переключить на оператора	lead.setForwarded(bool|int $state): self
Проверка кто переключил на оператора	bot.getForwardEventType(): bool
Проверка переключения на оператора	bot.isForwardedToOperator(): bool

Каждый из методов подробнее расписан ниже.

Переключить на оператора

lead.setForwarded(bool|int $state)

Описание:

Установка ($state == true) или сброс ($state == false) у лида признака “Переведён на оператора”.

Атрибуты:

Имя	Тип	Описание
state	bool|int	При $state = true установка и при $state = false сброс признака “Переведён на оператора”

Возвращает:

self - подтверждение установки или сброса в формате используемом при вызове метода.

Проверка кто переключил на оператора

bot.getForwardEventType()

Описание:

Эта функция необходимо для того чтобы отличать событие Переключения на оператора обычным способом (через маршруты/скрипты бота) или при перехвате управления оператором.

Возвращает:

bool - "forwarded_by_operator" если контроль за диалогом забран оператором (по его инициативе).

Проверка переключения на оператора

bot.isForwardedToOperator()

Описание:

Проверяет переключен ли лид на оператора.

Возвращает:

bool - подтверждение того, что лид переключен на оператора.