Действия

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

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

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

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

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

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

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

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

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

Параметры#

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

Компоненты сообщения хранят в себе все параметры, имеющиеся ранее и сохраненные в рамках отправки его собственного шаблона сообщения. Это значит, что действие, запускаемое компонентом, получит те же самые параметры, которые были в момент отправки сообщения с этим самым компонентом.

Внимание

Время жизни передаваемых из действия в компоненты параметров — 15 минут с момента последнего обращения к ним!