Действия автоматизаций
Действие — это «тогда». Список закрытый. Действий в правиле — до 5, и порядок имеет значение: они выполняются сверху вниз.
Список
| Действие | Чему нужен предмет | Право Kizora у автора правила | Право Discord у бота |
|---|---|---|---|
| выдать роль | участник события | automations.manage, roles.manage | Управление ролями |
| снять роль | участник события | automations.manage, roles.manage | Управление ролями |
| написать в канал | канал назначения | automations.manage, messages.manage | Отправка сообщений |
| написать в личные | участник события | automations.manage, messages.manage | — |
| поставить реакцию | сообщение-повод | automations.manage, messages.manage | Добавление реакций |
| закрепить сообщение | сообщение-повод | automations.manage, messages.manage | Управление сообщениями |
| удалить сообщение | сообщение-повод | automations.manage, moderation.act | Управление сообщениями |
| выдать тайм-аут | участник события | automations.manage, moderation.act | Тайм-ауты участникам |
| записать в журнал | — | automations.manage | — |
Каждое действие требует automations.manage плюс право того модуля, в который оно вмешивается. Право редактировать правила не даёт права банить: см. Права автоматизаций.
Подстановки в тексте
В тексте сообщения допустимы поля того события, которое стало поводом: имя участника, канал, уровень, номер обращения. Список полей — на странице Условия.
Значение подставляется как текст. Шаблон не может позвать @everyone и не может притвориться другим полем.
Длина текста — до 2000 символов.
Что бывает не так
| Действие | Когда не сработает |
|---|---|
| выдать роль | роль удалена, роль не ниже бота, роль административная, участник вышел |
| снять роль | роли у участника нет, роль удалена, участник вышел |
| написать в канал | канал удалён или недоступен боту |
| написать в личные | у участника закрыты личные сообщения |
| поставить реакцию | сообщение удалено, значок недоступен |
| закрепить сообщение | сообщение удалено, лимит закреплений исчерпан |
| удалить сообщение | сообщение уже удалено |
| выдать тайм-аут | роль участника не ниже роли бота, участник вышел |
| записать в журнал | — |
Действие, которому нечего делать (роли уже нет, участник вышел, канал удалён), помечается как «пропущено» — это не ошибка, но и не успех, и в журнале об этом говорится прямо.
Часовой предел
На сервер приходится не больше 500 действий автоматизаций в час. Автоматизация, разославшая тысячу сообщений за минуту из-за одного налёта, — не автоматизация, а соучастник.
Когда предел исчерпан, запуски помечаются соответствующим статусом и возобновляются в следующем часе.
Проверить, не выполняя
Прежде чем включать правило с действиями «тайм-аут» или «удалить сообщение», прогоните его вхолостую: Проверка вхолостую.