Использование кнопок в сообщениях бота | Слот Button Menu и под-слот Button

Назначение и общая информация

Слот Button Menu — слот, объявляющий блок кнопок button, которые определяются после этого слота.

Создание и настройки комплексного слота Button Menu (Button Menu+button+fallback)

Атрибуты слота Button Menu

Name — название слота, которое будет отображено в Дереве сценария. Максимальная длина значения поля — 40 символов.

При сохранении Слота проверяется значение в поле:

1. если поле пустое, выводится ошибка Please enter a slot name
2. если в поле более 40 символов, выводится ошибка Name must contain no more than 40 characters

Атрибуты подслота Button

1. Name — название подслота, которое будет отображено в Дереве сценария. Максимальная длина значения поля — 40 символов. Если название не введено, на подслоте в Дереве сценария будут отображаться первые 34 символа из поля Label.

   1. При сохранении Слота проверяется значение в поле:

      1. если в поле более 40 символов, выводится ошибка Name must contain no more than 40 characters
2. Label — название кнопки, которое увидит Собеседник при Общении с Агентом.

   1. При сохранении Слота проверяется значение в поле:

      1. если поле пустое, выводится ошибка Please enter a button label
   2. Обрезка пробелов: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании слота) обрезаются пробелы и переносы строк в начале и в конце поля Label.

Использование синтаксиса в Подслоте Button

В Подслоте Button допустимо использование Выражений в поле Label. Подробнее: Синтаксис

Пример:

Использовать можно только одно Выражение.

В качестве лейбла кнопки будет использоваться значение Контекстной переменной some_var приведенное к нижнему регистру.

Атрибуты подслота Fallback

Подслот fallback — это это дочерний слот в комплексном слоте Button Menu + button + fallback, в который переходит Агент в том случае, если Собеседник не нажал на кнопку и не ввел вручную текст, совпадающий с текстом кнопки.

Name — название подслота, которое будет отображено в Дереве сценария. Максимальная длина значения поля — 40 символов. При создании слота Button Menu в поле Name подслота Fallback автоматически подставляется содержимое поля Name слота Button Menu. Если содержимое поля Name удалено, подслот в Дерево сценария будет отображаться без названия.

При сохранении Слота проверяется значение в поле:

1. если в поле более 40 символов, выводится ошибка Name must contain no more than 40 characters

Подслоты Button и Fallback

Автоматическая генерация подслотов при создании Button Menu

1. При создании слота Button Menu автоматически создаются два подслота button с названиями “Button 1” и “Button 2” и подслот fallback.
2. Изменить текст в сгенерированных подслотах button можно, развернув подслот двойным нажатием мышки, введя в поле LABEL название кнопки, которое увидит Собеседник на экране и нажав кнопку Save.

Добавление подслотов Button

Используя кнопку “+” можно создать новый подслот button. Новый подслот button будет создан ниже автоматически сгенерированного подслота button со значением “Button 2”.

Удаление подслотов Button

1. Чтобы удалить подслот button, необходимо кликнуть по нему правой кнопкой мыши и нажать кнопку Remove Branch, затем нажать OK во всплывшем диалоговом окне.
2. Возможно удалить любой подслот button, если после удаления у Слота Button Menu остается хотя бы один подслот button.

3. Удаление подслота fallback невозможно. При попытке это сделать появится следующая ошибка по центру внизу:
4. Удаление единственного подслота button невозможно. При попытке это сделать появится следующая ошибка по центру внизу:

Работа слота

Слот Button Menu является пустым по своему содержанию и выполняет лишь формальную роль – определяет блок кнопок, названия которых указываются после него в подслотах button.

1. При выполнении слота Button Menu на экран выводятся кнопки, на которые может нажать Собеседник в процессе общения с Агентом.

2. Если Собеседник нажимает одну из кнопок, Общение переходит в подслот button, соответствующий этой кнопке. При этом в переменную client_message записывается содержимое этой кнопки.

3. Если Собеседник ввел текст, совпадающий с текстом одной из кнопок (независимо от регистра), то Общение перейдет в подслот button, соответствующий этой кнопке. При этом в переменную client_message записывается текст, введенный Собеседником.

4. Если вместо нажатия кнопки Собеседник ввел какой-либо текст, не совпадающий с текстом ни одной из кнопок, Общение переходит в подслот fallback.

5. Если Собеседник отправил файл, Общение переходит в подслот fallback.