Документация Webitel

Компонент "Menu"

1. Описание

Компонент позволяет генерировать меню навигации, где выбор будет сохранен в переменную.

Данный компонент присутствует в схемах типа:

  • Текстовая.

Блок (Рис. 1.(1)) используется в поле для построения схемы. При нажатии на блок открывается панель настроек данного компонента (Рис. 1.(2)).

Menu.png
Рис. 1. Компонент "Menu”

1.1. Блок "Menu"

Блок состоит из таких элементов:

  1. Название компонента;

  2. Ветка "In" - принимающая (соединяющая с предыдущим блоком) ветка;

  3. Ветка "Out" - исходящая (соединяющая со следующим блоком) ветка.

При наведении на поле "Out" появляется переключатель, который позволяет соединить этот компонент с компонентом, уже имеющим соединение.

Наличие иконки  image2024-11-7_15-47-46.png  обозначает, что  переключатель включен, и данный компонент можно соединить с компонентом, уже имеющим соединение.

Смена положения переключателя  удаляет исходящую ветку этого компонента.

Кнопка  image2024-11-7_15-51-56.png  удаляет блок из схемы.

1.2. Панель настроек "Menu"

Состоит из таких элементов (Рис. 2):

Компонент "Menu".png
Рис. 2. Панель настроек “Menu“

1.2.1. Поле "Text"

Здесь указывается текст, который будет отображаться вместе с меню навигации.

1.2.2. Поле “Kind“

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

В этом поле разрешено использовать только:

  • латинские буквы;

  • цифры;

  • символ подчёркивания.

Формат: /[a-zA-Z0-9_]/g.

Может использоваться, например, для служебных или системных сообщений (типа system).

1.2.3. Поле "Set"

Здесь указывается название переменной, в которую записывается результат выбора абонента.

Поле автоматически заполнено значением "${onClick.Menu}".

1.2.4. Поле "Type"

Указывается тип размещения кнопок. Существуют такие варианты:

  • message - кнопки отображаются в сообщении;

  • chat - кнопки отображаются под чатом;

  • clear - отсутствие кнопок.

1.2.5. Элемент "Rows of buttons"

Предназначен для создания рядов кнопок в меню навигации.

1.2.6. Кнопка "Add row"

При нажатии на кнопку "Add row" дополнительно отображаются следующие параметры (Рис. 2):

  1. Элемент "Button";

  2. Кнопка "Add button";

  3. Кнопка "Delete row".

Переключатель "No input" становится доступный при наличии, минимум, одного рядка.

image2024-6-7_15-49-56.png  - указывает, что нужно отключить возможности ввода (текста, медиа, видео, файлов, локации, и т.д.), а разрешить лишь ответ с помощью одной из кнопок.
Только для порталов!

image-20251204-090938.png
Рис. 3. Добавление ряда
1.2.6.1. Элемент "Button"

Предназначен для создания кнопки. Состоит из:

  1. Инструмента удаления;

  2. Поля "Type";

  3. Поля "Text";

1.2.6.1.1. Инструмент удаления

Предоставлен в виде image2024-1-30_16-58-4.png нажатие на которую удаляет кнопку.

1.2.6.1.2. Поля "Type"

Тип кнопки.

Для типа размещения кнопок "message" доступны:

  1. reply;

  2. url.

 Для типа размещения кнопок "chat" доступны:

  1. postback;

  2. contact;

  3. email;

  4. location.

1.2.6.1.3. Поля "Text" 

Название кнопки, которое отображается в мессенджере.

Посредством использования компонента "Switch" можно создать ветки, по которым будет проходить схема, согласно с выбранной кнопкой.
Для этого в поле "Cases"  компонента "Switch" необходимо указать код кнопки созданные в компоненте "Menu", а в поле "Variable"  компонента "Switch" - переменную, название которой указано в поле "Set" компонента "Menu".

1.2.6.2. Кнопка "Add button"

При нажатии на эту кнопку добавляться элемент "Button" в ряд, к которому принадлежит кнопка "Add button".

1.2.6.3. Кнопка "Delete row"

Нажатие на эту кнопку удаляет ряд и все кнопки из этого ряду.

1.2.7. Переключатель "Break"

Отвечает за окончание выполнения схемы.

  • image-20250704-085952.png - инициирует окончание выполнения схемы после данного компонента;

  • image-20250704-085922.png - переключатель отключен.

1.2.8. Элемент "Limit"

Предназначен для определения максимального количества прохождений через этот компонент. 

Если через компонент прохождений будет больше, чем указано в поле "Max", то будет использоваться ветка "failover"- image2024-1-26_12-1-12.png , которая появляется в блоке компонента при установке лимита.

Нажатие на кнопку "Add limit" добавляет поле "Max" и кнопку "Delete limit".

В поле "Max" указывается количество возможных прохождений.

Нажатие на кнопку "Delete limit" убирает лимит, возвращая кнопку "Add limit".

Limit.png


Рис. 4. Установление лимита

1.2.9. Элемент "Add description"

Нажатие на кнопку "Add description" добавляет поле "Description" и кнопку "Delete description".

В поле "Description" указывается описание — комментарии к компоненту.

Нажатие на кнопку "Delete description" убирает описание, возвращая кнопку "Add description".

Description.png

Рис. 5. Элемент "Add description"