В данной статье мы разберем вкладку Триггеры для групп.


Для работы с Триггерами необходимо подключить группу к сервису, подробнее о том как это сделать в этой статье.



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


Для создания Триггера необходимо:

  • Задать слово, фразу-условие или иное условие, по которому Триггер будет срабатывать;
  • Задать действие, которое будет происходить, если условие выполнено.


Например: задать в условие фразу «Привет», а в действие отправку сообщения «И тебе привет!».


Разберем возможности условий и действий подробнее.



Условия



В каждом триггере можно задать множество (в зависимости от тарифа) групп условий, которые разделены полоской с союзом «И», это означает, что данный триггер сработает только при наличии в сообщении всех условий.



Внутри условия можно добавить множество (в зависимости от тарифа) фраз. Триггер сработает при наличии в сообщении только одной фразы из всех перечисленных.


Типы условий:

  • Полное совпадение — при данном типе триггер сработает, только если сообщение отправленное пользователем полностью соответствует указанной фразой-условия в Триггере.
    Пример: указав фразу «Привет», триггер будет срабатывать, если пользователь отправит: «Привет», но триггер не будет срабатывать, если пользователь отправит: «О, привет друг!», «Ну привет», «Приветик» и так далее. В данном случае проверяется сообщение полностью.

  • Сообщение содержит — при данном типе триггер сработает, если сообщение и/или фраза в нем частично соответствует фразе-условию.
    Пример: указав фразу «Прив», триггер будет срабатывать, если пользователь отправит: «Привет», «Приветик», «О, привет друг!», «Ну привет», но триггер не будет срабатывать, если пользователь отправит: «Здравствуй», «Рад видеть». В данном случае проверяется каждая фраза по отдельности на наличие фразы-условия.

  • Сообщение начинается — при данном типе триггер сработает, если сообщение начинается с заданной фразы-условия.
    Пример: указав фразу «Привет», триггер будет срабатывать, если пользователь отправит: «Привет», «Привет, рад видеть», но триггер не будет срабатывать, если пользователь отправит: «О, привет друг!», «Ну привет». В данном случае проверяется слово или фраза в начале сообщения на наличие фразы-условия.

  • Сообщение заканчивается — при данном типе триггер сработает, если сообщение заканчивается на заданную фразу-условие.
    Пример: указав фразу «Привет», триггер будет срабатывать, если пользователь отправит: «Привет», «О, привет друг!», «Ну привет», но триггер не будет срабатывать, если пользователь отправит: «Привет, рад видеть». В данном случае проверяется слово или фраза в конце сообщения на наличие фразы-условия.

  • Регулярное выражение — особый тип условия, который позволяет проверять сообщения пользователя по определенному шаблону. Подробнее о регулярных выражениях.
    Пример: указав регулярное выражение «^((8|\+7)[\- ]?)?(\(?\d{3}\)?[\- ]?)?[\d\- ]{7,10}$», но триггер будет срабатывать, если пользователь пришлет номер телефона.

  • Длина сообщения меньше — при данном типе триггер сработает, если сообщение содержит символов меньше заданного количества.

  • Длина сообщения больше — при данном типе триггер сработает, если сообщение содержит символов больше заданного количества.


Типы сообщений:

  • Любое — условие будет проверяться на любых сообщениях.
  • Ответ — условие будет проверяться только на ответных (реплай или цитирование) сообщениях.
  • Ответ к боту — условие будет проверяться только на ответных сообщениях к ботам.
  • Ответ к пользователю — условие будет проверяться только на ответных сообщениях к подписчикам группы.
  • Ответ к текущему боту — условие будет проверяться только на ответных сообщениях к текущему боту.
  • Не ответ — условие будет проверяться на сообщениях, которые не являются ответными (реплай или цитирование).
  • Первое сообщение пользователя — условие будет проверяться на сообщения подписчиках группы, которые ранее ничего не писали.



Операторы


Для уточнения условия, по которому будет вызван триггер, можно добавить специальные операторы. Операторы состоят из специального символа, который необходимо поставить вначале фразы.


Виды операторов:

  1. Минус-фраза — специальный символ "-", добавляет условие, при котором триггер не сработает, если в нём присутствует указанная фраза.
    Пример: указав фразу «Привет» и минус-фразу «Друг» (в триггере с типом условия Сообщение содержит), триггер будет срабатывать, если пользователь отправит: «Привет», «Привет всем», но триггер не будет срабатывать, если пользователь отправит: «Привет Друг».

Важно! При добавлении только минус-фраз (без других условий) триггер будет срабатывать на все сообщения, в которых нет заданной минус фразы.

      2. Точная-фраза — специальный символ "!", позволяет внутри условия Сообщение содержит вставить фразу, которая будет работать по принципу условия Полное совпадение.

          Пример: указав точную-фразу «Привет» (в триггере с типом условия Сообщение содержит), триггер будет срабатывать, если пользователь отправит: «Привет», но триггер не будет срабатывать, если пользователь отправит: «Приветик».

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



Действия



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


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

  • Текстовое сообщение.
  • Команда. Важно! Обычная клавиатура, формы ввода, таймауты и функция перехода не будут отправлены.
  • Добавление в категорию.
  • Удалить сообщение.
  • Запретить отправлять сообщения.
  • Удалить пользователя.
  • Заблокировать пользователя.


Дополнительные настройки Триггеров:

  • Шанс срабатывания — вероятность срабатывания триггера, задается в процентах.
  • Приоритетность — если у нескольких подходящих под условия триггеров совпадает приоритет, то они все будут выполнены. Если приоритет разный, то выполнится триггер с максимальным приоритетом. Значение от 1 до 100.
  • Для категории — триггер сработает на пользователях только из выбранных категорий.
  • Повторное срабатывание — если у пользователя сработал триггер, то в течение указанного времени для него данный триггер больше не будет срабатывать.
Статьи в этом разделе: