В данной статье мы разберем вкладку Триггеры для групп.
Для работы с Триггерами необходимо подключить группу к сервису, подробнее о том как это сделать в этой статье.
Важно! Вкладка "Триггеры" доступна только для групп и бизнес-аккаунтов.
Чтобы найти вкладку перейдите на главную страницу проекта, далее выберите группу.
Если у вас еще не подключена группа, то подключите по инструкции: Как добавить бота в ресурс
Триггеры — вкладка для групп и бизнес-аккаунтов позволяющая задавать различные слова, фразы и иные условия, при отправки которых бот будет производить определенное действие: отправлять сообщение, команду, блокировать пользователя, лишать возможности писать, удалять из чата и прочее.
Для создания Триггера необходимо:
Задать слово, фразу-условие или иное условие, по которому Триггер будет срабатывать;
Задать действие, которое будет происходить, если условие выполнено.
Примеры использований:
- Задать в условии фразу «Привет», а в действие отправку сообщения «И тебе привет!» - если необходима ответ на определенное слово.
- Задать 2 условия с фразами "Помощь" и "Оплата", если требуется отравить сообщение для помощи в оплате. Не сработает на: «Нужна помощь с настройкой бота» (нет слова «оплата»).
Разберем возможности условий и действий подробнее.
Условия
Услoвия в настройках триггера определяют на какие слова, фразы или типы сообщений будет срабатывать триггер и выполняться действие.
В каждом триггере можно задать множество групп условий, которые разделены полоской с союзом «И», это означает, что данный триггер сработает только при наличии в сообщении всех условий.
Внутри условия можно добавить множество фраз. Триггер сработает при наличии в сообщении хотя бы одной фразы из всех перечисленных.
Типы условий
Полное совпадение — при данном типе триггер сработает, только если сообщение отправленное пользователем полностью соответствует указанной фразой-условия в Триггере.
Пример: указав фразу «Привет», триггер будет срабатывать, если пользователь отправит: «Привет», но триггер не будет срабатывать, если пользователь отправит: «О, привет друг!», «Ну привет», «Приветик» и так далее. В данном случае проверяется сообщение полностью.
Сообщение содержит — при данном типе триггер сработает, если сообщение и/или фраза в нем частично соответствует фразе-условию.
Пример: указав фразу «Прив», триггер будет срабатывать, если пользователь отправит: «Привет», «Приветик», «О, привет друг!», «Ну привет», но триггер не будет срабатывать, если пользователь отправит: «Здравствуй», «Рад видеть». В данном случае проверяется каждая фраза по отдельности на наличие фразы-условия.
Сообщение начинается — при данном типе триггер сработает, если сообщение начинается с заданной фразы-условия.
Пример: указав фразу «Привет», триггер будет срабатывать, если пользователь отправит: «Привет», «Привет, рад видеть», но триггер не будет срабатывать, если пользователь отправит: «О, привет друг!», «Ну привет». В данном случае проверяется слово или фраза в начале сообщения на наличие фразы-условия.
Сообщение заканчивается — при данном типе триггер сработает, если сообщение заканчивается на заданную фразу-условие.
Пример: указав фразу «Привет», триггер будет срабатывать, если пользователь отправит: «Привет», «О, привет друг!», «Ну привет», но триггер не будет срабатывать, если пользователь отправит: «Привет, рад видеть». В данном случае проверяется слово или фраза в конце сообщения на наличие фразы-условия.
Регулярное выражение — особый тип условия, который позволяет проверять сообщения пользователя по определенному шаблону. Подробнее о регулярных выражениях.
Пример: указав регулярное выражение «^((8|\+7)[\- ]?)?(\(?\d{3}\)?[\- ]?)?[\d\- ]{7,10}$», но триггер будет срабатывать, если пользователь пришлет номер телефона.
Длина сообщения меньше — при данном типе триггер сработает, если сообщение содержит символов меньше заданного количества.
Длина сообщения больше — при данном типе триггер сработает, если сообщение содержит символов больше заданного количества.
Типы сообщений
Все — любой тип сообщений
Текст — условие будет проверяться только для текстовых сообщений, в которых нет медиа.
Изображение — условие будет проверяться только для отправленных изображений и описания к ним.
Видео — условие будет проверяться только для отправленных видео и описания к ним.
Документ — условие будет проверяться только для отправленных документов и описания к ним.
Офисный документ — условие будет проверяться только для отправленных документов и описания к ним.
Аудио — условие будет проверяться только для отправленных аудио сообщений и описания к ним.
Голосовая запись — условие будет выполняться только при наличии голосовых сообщений.
Видеосообщение — условие будет выполняться только при наличии видеосообщений (кружки).
Геолокация — условие будет выполняться только при отправке геолокации.
Контакт — условие будет выполняться только при отправке контакта.
Типы отправки
Любое — условие будет проверяться на любых сообщениях.
Пересланное — условие будет проверять только на пересланных сообщений из других групп, каналов или личных сообщений.
Ответ (любой) — условие будет проверяться только на ответных (реплай или цитирование) сообщениях.
Ответ к боту — условие будет проверяться только на ответных сообщениях к ботам.
Ответ к пользователю — условие будет проверяться только на ответных сообщениях к подписчикам группы.
Ответ к текущему боту — условие будет проверяться только на ответных сообщениях к текущему боту.
Не ответ — условие будет проверяться на сообщениях, которые не являются ответными (реплай или цитирование).
Первое сообщение пользователя — условие будет проверяться на сообщения подписчиках группы, которые ранее ничего не писали.
Операторы
Для уточнения условия, по которому будет вызван триггер, можно добавить специальные операторы. Операторы состоят из специального символа, который необходимо поставить вначале фразы.
Виды операторов:
Минус-фраза — специальный символ "-", добавляет условие, при котором триггер не сработает, если в нём присутствует указанная фраза.
Пример: указав фразу «Привет» и минус-фразу «Друг» (в триггере с типом условия Сообщение содержит), триггер будет срабатывать, если пользователь отправит: «Привет», «Привет всем», но триггер не будет срабатывать, если пользователь отправит: «Привет Друг».
Важно! При добавлении только минус-фраз (без других условий) триггер будет срабатывать на все сообщения, в которых нет заданной минус фразы.
Точная-фраза — специальный символ "!", позволяет внутри условия Сообщение содержит вставить фразу, которая будет работать по принципу условия Полное совпадение.
Пример: указав точную-фразу «Привет» (в триггере с типом условия Сообщение содержит), триггер будет срабатывать, если пользователь отправит: «Привет», но триггер не будет срабатывать, если пользователь отправит: «Приветик».
Важно! Для игнорирования работы оператора необходимо поставить специальный символ дважды "--" или "!!" (для добавления фразы "-Привет" необходимо указать "--Привет"). Для использования оператора в фразе-условия, которое начинается на символ присвоенный оператору — необходимо поставить специальный символ трижды "---" или "!!!" (для добавления минус-фразы "-Привет" необходимо указать "---Привет").
Действия
Действия триггера - настройка позволяющая указать действия и их последовательность при срабатывании триггера.
Для действий можно задать порядок их отправки, используя стрелочки, или выбрать случайный порядок.
Типы действий
Текстовое сообщение — отправка только текстового сообщения.
Команда или условие — возможность указать команду из раздела Конструктор, будет отправлено содержимое команды.
Важно! Если в команде созданы: Обычная клавиатура, Форма ввода, Таймауты или Действия то они не будут выполнены или отправлены.Добавление в категорию — изменение категорий пользователю.
Удалить сообщение — это действие удалит сообщение пользователя, на которое сработал триггер. Используется для удаления спама или запрещенных слов.
Запретить отправлять сообщения — действие с возможностью ограничить на время или запретить навсегда возможность отправки сообщений.
Удалить пользователя — действие удалит пользователя написавший триггерное сообщение.
Заблокировать пользователя — временная или постоянная блокировка пользователя.
Удалить обычную клавиатуру — действие для удаления клавиатуры в группе, если ранее она была закреплена.
Запись сообщения в переменную — действие запишет сообщение, на которое сработал триггер, в указанную переменную пользователя.
Изменить переменную — изменение значения переменной на произвольный текст.
Дополнительные настройки Триггера
Выполнить для пользователя получившего ответ — функция доступная для некоторых действий, позволяет выполнить действие не тому кто написал сообщение, а тому на чье сообщение ответили. Например можно создать функцию блокировки пользователя, ответив на его сообщение словом "бан", или реализовать функционал начисления баллов, например начислять пользователю "Карму", если на его сообщение ответили «спасибо».
Шанс срабатывания — вероятность срабатывания триггера, задается в процентах.
Приоритетность — если у нескольких подходящих под условия триггеров совпадает приоритет, то они все будут выполнены. Если приоритет разный, то выполнится триггер с максимальным приоритетом. Значение от 1 до 100.
Для категории — триггер сработает на пользователях только из выбранных категорий. Настройка идеально подходит, если нужно сделать срабатывание определенных триггеров только для администраторов, например функции блокировки или мута пользователей.
Ожидать от пользователя нажатие на кнопку — При включенной функции нажать на инлайн кнопки в триггере сможет только тот пользователь, на которого сработал триггер. Данная функция не работает на кнопки с действием "Ссылка".
Время до повторного срабатывания (на пользователя) — если установить 1 день, то один и тот же пользователь сможет вызвать триггер не чаще 1 раз за сутки.
Время до повторного срабатывания (глобально) — если установить 1 день, то вызвать триггер можно не чаще 1 раз за сутки на всех пользователей.
Количество срабатываний (на пользователя) — максимальное количество срабатываний для одного пользователя.
Количество срабатываний (глобально) — общее количество срабатываний триггера. При достижении лимита триггер прекратит работу.
Запретить срабатывание триггера при ответе самому себе — настройка запрещает выполнение действий при настройке "Выполнить для пользователя получившего ответ" с типом отправки "Ответ пользователю".
Запуск по дням и времени — возможность указать дни недели и время суток действия триггера.