Запуск интеграции по кнопке

Общее описание

В рабочее окно операторов можно добавить “программируемые кнопки”, то есть запустить сценарий интеграции по нажатию кнопки в момент работы над чатом. Кроме того, в языке DSL для описания сценариев есть новые команды, с помощью которых можно сконструировать форму, который оператор должен заполнить для этого сценария интеграции.

Создание интеграции

В разделе настроек “Интеграции” создается интеграция на событие “Нажатие кнопки оператором” и действие “выполнить сценарий и продолжить работу”. Канал для такого типа интеграций не указывается.

Важно: Для данного события в сценарии НЕ поддерживается диалог с пользователем, поэтому не нужно использовать команды типа сообщениеПользователю, задатьПользователюВопрос и другие.

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

В описании Сценарии вы найдете новые команды для формирования формы.

Создание кнопки и связь с интеграцией

В разделе Настройки - Запросы - Операторы в блоке “Интерфейс оператора” задаются кнопки действий, к которым привязываются созданные ранее интеграции.

В выпадающем списке Интеграция отображаются только интеграции на событие “Нажатие кнопки оператором”. Для кнопки задается ее название и описание, которое отображается подсказкой при наведении на эту кнопку.

Использование кнопки в работе

Если кнопки действий созданы и настроены, то они появляются в выпадающем меню кнопки Действия:

 

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

Важно: при нажатии кнопки “Отмена” запуск интеграции останавливается, но не происходит “отката”. Т.е. все действия сценария ДО момента показа формы уже будут выполнены.

В историю диалога добавлено событие о запуске интеграции, которое также видно и оператору. Когда сценарий интеграции отрабатывает, блокировка с интерфейса снимается и оператор может дальше продолжить работу. Если в сценарии было изменение состава диалога, например, добавление комментариев или добавление/изменение параметров payload-а чата, то они отобразятся сами.

Важно: Для сценария интеграции действует общий таймер из раздела настроек Сценарии. Если оператор в течение заданного времени не заполнит форму, то она закроется и выполнение сценария остановится.