Модуль триггеры групп

Триггеры - это специальные ключевые слова. Если бот видит такое ключевое слово в группе - он может реагировать на него отправкой заданного сообщения в ту же группу.

Для настройки Триггеров перейдите в меню редактирования группы:
🔐Админ | 🧫Каналы и Группы
● Выберите Группу (Триггеры настраиваются для каждой группы отдельно)
● Перейдите в раздел «Триггеры»

❖ Настройки триггеров

Настройки Триггеров могут быть Глобальными и Индивидуальными.

ВАЖНО: Механика работы Глобальных и Индивидуальных Настроек Триггеров.

Глобальные Настройки задаются на всю Группу и являются "единым источником истины" для всех Триггеров. Изменяя одну Глобальную Настройку, вы автоматически обновляете её значение для всех Триггеров которые используют Глобальное значение, так как при каждом срабатывании они (не имея своего значения) обращаются напрямую к этому (глобальному) источнику.

Индивидуальные Параметры каждого Триггера могут брать значения из Глобальных Настроек (если это возможно), а также иметь Индивидуальные значения. В Индивидуальных Настройках Триггера любое Глобальное значение можно переназначить - сделав его Индивидуальным. Если вы задали триггеру Индивидуальное значение, сходное с Глобальной Настройкой - оно НЕ изменится при изменении Глобальной Настройки, так как уже зафиксировано как Индивидуальное.

При создании нового Триггера, в его Индивидуальных Параметрах будут присутствовать значения из Глобальных Настроек (где это возможно) и Индивидуальные значения по умолчанию - для тех параметров у которых не может быть Глобального значения.

Глобальные Настройки Триггеров

Доступ к Системным Триггерам

Определяет, кто имеет доступ к использованию Системных Триггеров отправленных в группу.
Режимы:
Админы Группы - только Админы Группы.
Админы Бота - только Админы Бота.
Все Админы - Админы Группы и Админы Бота.

СИСТЕМНЫЕ ТРИГГЕРЫ - это все триггеры указанные в этом разделе, а так же все триггеры из раздела «Модуль Модерации»

Доступ к Управлению Триггерами

Определяет, кто имеет право добавлять и удалять Обычные Триггеры (те что вы добавляете сами).
Режимы:
Админы Группы - только Админы Группы.
Админы Бота - только Админы Бота.
Все Админы - Админы Группы и Админы Бота.

Доступ к Обычным Триггерам

Определяет, кто имеет доступ к использованию Обычных Триггеров (тех что вы добавили сами) отправленных в группу.
Режимы:
Админы Группы - только Админы Группы.
Админы Бота - только Админы Бота.
Все Админы - Админы Группы и Админы Бота.
Все - доступ имею все - и обычные Юзеры в том числе.

Удалять Сообщение с Триггером

Определяет, будут ли удаляться сообщения с триггерами после того, как бот на них ответит (сюда входят как триггеры отправленные в группу, так и использованные в сообщениях (по вхождению)).
Режимы:
Выкл ⏹️ - функция выключена (сообщение с триггером останется в чате).
Вкл ▶️ - функция включена (сообщение с триггером будет удалено).

Отвечать на Триггер

Определяет, будет ли ответ на триггер отправлен как "Ответ" (reply).
Режимы:
Выкл ⏹️ - функция выключена (будет отправлен как обычное сообщение).
Вкл ▶️ - функция включена (будет отправлен как "Ответ" (reply)).

Настройка будет проигнорирована, если режим «Удалять Сообщение с Триггером» - включён, потому что это подразумевает удаление сообщения с триггером.

Ответ на Ответ

Если триггер был отправлен как ответ (Reply) на некоторое сообщение в чате, то бот будет также отправлять ответ на это сообщение как "Reply".
Режимы:
Выкл ⏹️ - функция выключена (отправлять как обычное сообщение).
Вкл ▶️ - функция включена (отправлять как Ответ (Reply)).

Индивидуальные Настройки Триггеров

Настройка Индивидуальных Параметров Триггеров доступна в Мастере редактирования Триггеров (см. ниже) - при добавлении нового Триггера или при редактировании существующего.

Доступ к Этому Триггеру

Определяет кто может использовать Триггер (эта настройка переопределяет Глобальную).
Режимы:
Как Глобально - по умолчанию - состояние берётся из Глобальных Настроек Триггеров.
Все - доступ имею все - и обычные Юзеры в том числе.
Админы Группы - только Админы Группы.
Админы Бота - только Админы Бота.
Все Админы - Админы Группы и Админы Бота.

Триггер По Вхождению

Триггер будет распознан внутри предложения. Триггеры "по вхождению" например, "бонус", будут искаться по вхождению в текст сообщения и срабатывать на фразы типа: "как получить бонус".
Режимы:
Выкл ⏹️ - по умолчанию - это обычный Триггер и будет проигнорирован если нет чёткого соответствия.
Вкл ▶️ - Триггер будет распознан даже внутри текста предложения.

Чьи Данные (в Сообщении)

Настройка определяет чьи данные помещать в Макросы сообщения Триггера.
Режимы:
По умолчанию - Зависит от Контекста - будет работать "как и сейчас работает" - везде данные Автора Ответа, в Формах - Данные Юзера.
Автора Исходного Сбщ. - принудительно везде в Макросах сообщения будут данные Автора исходного сообщения (того на которое отвечают Триггером)
Автора Ответа - принудительно везде в Макросах сообщения будут данные Автора Ответа (того кто отправил Триггер - обычно это Админ).

Удалять Имя Триггера

Определяет нужно ли автоматически удалять сообщение содержащее Имя Триггера в чате (эта настройка переопределяет Глобальную).
Режимы:
Как Глобально - по умолчанию - состояние берётся из Глобальных Настроек Триггеров.
Выкл ⏹️ - не будет удалять.
Вкл ▶️ - будет удаляться.

Удалять Исходное Сбщ.

Позволяет удалять исходное сообщение (то на которое был отправлен ответ ("reply") с Триггером).
Режимы:
Как Глобально - по умолчанию - состояние берётся из Глобальных Настроек Триггеров.
Выкл ⏹️ - не будет удалять.
Вкл ▶️ - будет удаляться.

Не Отправлять Ответ

Триггер не отправит своё Ассоциированное Сообщение (только исполнит ВСЕ остальные действия - если есть).
Режимы:
Выкл ⏹️ - по умолчанию - будет отправлять (нормальное поведение).
Вкл ▶️ - не будет отправлять.
Используется в комбинации с другими настройками - например с «Удалять Исходное Сообщение».

Ограничить Юзера

Настройка позволяет накладывать ограничения на пользователя исходного сообщения.
Режимы:
Выкл ⏹️ - по умолчанию - ограничение не накладывается.
⛔️ Бан - запрет юзеру писать в группу (мут (mute)).
📛 Кик - удалит юзера из группы.
Это давняя, оригинальная терминология из документации Телеграм - однажды мы приведём её в порядок. 😁

❖ Как добавить триггеры

На данный момент в боте есть 2 вида триггеров.

Триггер Кнопок - связывается с кнопками бота. Чтобы задать триггер вы должны создать кнопку, добавить в неё сообщение (либо выбрать имеющуюся кнопку с существующим сообщением) и связать нужный текст триггера с ней.

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

Для Триггера Кнопок, неважно, доступна ли кнопка из меню, закрыта Условием или скрыта: триггер всегда будет работать для неё.

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

Все триггеры регистронезависимы: они всегда сохраняются маленькими буквами и будут работать, в каком бы регистре их не ввели, например "Test trigger" or "TeSt TrIgGer".

Сообщения, которые показаны в группе при помощи триггеров, могут содержать свои инлайн кнопки. Из всех инлайн кнопок этого сообщения, инлайн кнопки содержащие команды не будут показаны в группе. Однако если это же сообщение показано в самом боте, например если триггер использован в ответ на сообщение юзера из формы QnA чата (и соответственно сообщение по триггеру будет отправлено юзеру в бот) - то все кнопки будут показаны полностью и юзер сможет воспользоваться такой кнопкой с командой, как и обычной инлайн кнопкой в боте. На этом можно создавать интересные механики.

Для кнопок, специально созданных под триггеры, хорошей практикой является создание специального подменю (или нескольких подменю), скрытия входа в него с помощью режима кнопки «Только Админ» и уже внутри неё создания кнопок и сообщений для триггеров. Ну, по крайней мере, мы так делаем. :)

Новый «Триггер Кнопки»

1. Выберите «➕ Триггер Кнопки»

Вы увидите все кнопки вашего меню в виде дерева.

2. Выбор Кнопки

Выберите кнопку, к которой вы хотите привязать триггер, нажав её команду в дереве меню:

3. Имя Триггера и его Индивидуальные настройки.

Опционально, перед вводом Имени Триггера ему можно задать Индивидуальные Настройки. Описание каждой настройки смотри выше в этом документе, или в информационном сообщении самого редактора.

Введите Имя Триггера - когда бот увидит сообщение с этим текстом, он ответит на него сообщениями из кнопки:

Это все.

Теперь вы настроили триггер с Именем "Триггер 1", который будет отправлять в группу сообщение(я) из кнопки "Кнопка Триггера" вашего меню. Сообщение с данными триггера содержит значки его настроек - позволяют визуально понять что делает Триггер не заходя в редактор.

Одной кнопке может быть присвоено несколько триггеров.

Новый «Триггер Сообщения» (из настроек)

1. Выберите «➕ Триггер Сообщ.»

2. Введите или перешлите боту сообщение.

3. Отправьте боту имя Триггера.

Всё - триггер добавлен!

Новый «Триггер Сообщения» (из группы)

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

Удобно, если В ГРУППЕ вы нашли какой-либо полезный ответ, свой (или участника группы) и вы могли бы использовать его позже, чтобы ответить на схожий вопрос.

В ответ (reply) на нужное сообщение отправьте команду:
!tadd trigger_name

Где: trigger_name - это имя триггера который вы хотите создать.

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

При использовании в группах триггеров в виде команд (/trigger) некоторые клиенты Telegram воспринимая триггер как команду передают боту имя триггера с добавленным к нему именем самого бота. При создание триггеров в виде команд для использования в группах дублировать триггер с добавлением имени самого бота - не нужно.
Имя бота, которое автоматически добавляется при использовании в группе, будет отсекаться при обработке.
Например триггер:
/trigger@bot_name
будет обработан как
/trigger.

❖ Как редактировать триггеры

Чтобы отредактировать любой Триггер из списка триггеров, кликните на команду редактирования триггера в настройках триггеров:

Редактирование триггера полностью идентично его добавлению (см. выше).

❖ Как удалять триггеры

Способ 1 (в настройках)

Чтобы удалить любой тип Триггер из списка триггеров, кликните на команду удаления триггера в настройках триггеров:

Способ 2 (в группе)

Триггеры можно удалять прямо в группе, для этого не обязательно идти в сам бот. Отправьте в группу где работает бот команду:

!tdel trigger_name

Где: trigger_name - это имя триггера который вы хотите удалить.

❖ Как импортировать триггеры

Если вы хотите использовать одинаковые триггеры (или их часть) в нескольких группах, вы можете импортировать триггеры из одной группы в другую.

1. Выберите группу

Зайдите в редактирование той группы, в которую вы хотите импортировать триггеры (для этого примера мы выберем группу номер 2).

2. Зайдите в «Триггеры».

3. Выберите «Импортировать»

4. Выберите группу-источник

Выберите группу-источник (Экспортёр), кликнув на команду выбора группы (для этого примера мы выберем группу номер 1).

5. Выберите триггеры для импорта

Бот пришлёт список доступных триггеров в одном сообщении. Выберите триггеры для импорта, введя их номера, разделённые запятыми:

Если вы хотите импортировать все триггеры - используйте кнопку «Все» в нижнем меню.

Теперь такие же триггеры настроены в новой группе.

В процессе импорта триггеры с уникальными Именами - будут добавлены. Триггеры с совпадающими Именами - будут заменены.

❖ Служебные триггеры

В системе предусмотрены специальные триггер-команды для служебных нужд.

t или T (одна буква "t"): отправит все доступные в группе триггеры. Сообщение будет автоматически удалено после отправки любого триггера из её списка.

Другие служебные команды могут быть добавлены позже.

❖ Ошибки при работе с триггерами

 

Бот не реагирует на триггеры в группе

Вариант 1: Триггер был отправлен пользователем группы, а бот настроен на работу только с администраторами - см. настройки и установи нужный параметр.
Вариант 2: Вы только что добавили администратора в группу, и бот ещё не обновил списки администраторов - отправьте команду !admins в чат, чтобы принудительно обновить списки.

 

❖ Дополнительная информация

Как получить больше триггеров

Количество триггеров можно увеличить.

Больше Триггеров.
Для подключения перейдите в вашем боте:
🔐Админ | 🧩Расширения | 📂Каналы и Группы

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

Однажды приобретённые дополнительные триггеры никогда не исчезают. Если вы удалите дополнительный триггер из группы или удалите всю группу целиком - дополнительные триггеры освободятся и могут быть снова использованы в другой группе.