Действия

Действия используются для выполнения каких-либо операций в ответ на вызов команды или взаимодействие с компонентами.

Действия являются частью Пользовательских команд.

Интерфейс настроек

У каждого действия вне зависимости от её типа есть определенный набор общих настроек:

• Название действия — название действия для отображения во вкладке и в списках выбора действия;
• Тип действия — выбор типа действия, подробное описание которых вы найдете в подразделах;
• Иконка — меню действия, позволяет получить информацию о действии (уникальный идентификатор) и создать дубликат;
• Краткое описание — краткое описание действия, которое отображается в списках выбора действия;
• Переопределить права доступа — включение этого параметра потребует проверки определённых прав доступа к этому действию в дополнение прав доступа самой команды.

UUID

UUID — уникальный идентификатор действия, который можно использовать в расширенной функциональности шаблонов сообщений.

Типы действий

1. Отправка сообщения — на запуск такого действия бот отправит сообщение.
2. Диалоговое окно — на запуск такого действия бот ответит всплывающим окном с полями ввода для получения каких-либо данных от участника в удобном интерфейсе.
3. Изменение ролей — на запуск такого действия бот снимет или выдаст указанные в настройках действия роли. По умолчанию роли изменяются тому участнику, кто вызвал действие командой или компонентом.
4. Встроенная команда — запуск такого действия запустит встроенную команду, указанную в поле шаблона. Например, если вы создадите команду с именем я, а в шаблоне действия напишете юзер, вызов команды !я будет аналогичен вызову встроенной команды !юзер.
5. Выполнение кода шаблона — запуск такого действия просто выполнит указанный в шаблоне код и ответит стандартным сообщением об успешном выполнении операции. Данный тип действия полезно использовать для запуска других действий в зависимости от каких-либо условий.

Запуск одного действия из другого

Если вы продвинутый пользователь, способный справиться с расширенными возможностями шаблонов сообщений, Вы можете использовать тег run для запуска одного действия из другого. Как это делается подробно описано здесь.

Параметры

Во все шаблоны действия передаётся переменная parameters, которая используется для передачи каких-либо данных между действиями. Например, для передачи данных из действия отправки сообщения в действия, назначенные на компоненты этого сообщения, или в другие запускаемые действия.

Подробная информация

Для более подробной информации о параметрах пользовательских команд и их использовании обратитесь к статье Параметры.