Персональные команды в Group Help
Group Help позволяет создавать персональные команды и ответы для решения различных задач:
I. Персональные команды
Команды-триггеры, начинающиеся с /
. При выполнении заданной команды бот отправит в группу соответствующее сообщение.
Есть несколько способов создания персональной команды:
Метод 1
/personal
в ответ на сообщение
/personal [имя команды] {[кнопка - example.com]}
- Отправьте сообщение (текст, медиа, стикер, gif и т. д.) в группу
- Ответьте на это сообщение:
/personal имя_команды
- Выберите нужные параметры:
- Разрешение на использование: кто может вызывать команду:
Только администраторы [Админ] или все пользователи [Все]?
- Место отправки: куда должно быть отправлено сообщение:
В личные сообщения с ботом [Приват] или в группу [Группа]?
- Несколько ответов: следует ли отправить все ответы одновременно, [Отправить все] или только один случайный [1 случайный]? - Подтвердите: [Сохранить ✔️ ]
Имя команды не может содержать пробелы;
Допустимые символы*: буквы, цифры и знак подчеркивания: _
*другие символы, такие как точка, дефис, тире и прочие тоже допустимы, но мы не рекомендуем их использовать во избежание возникновения проблем
Метод 2
/personal
/personal [имя команды] [текст]
/personal [имя команды] [текст] {[кнопка - example.com]}
- Отправьте сообщение начинающееся сразу с
/personal имя_команды текст ответа
в группу - Выберите нужные параметры:
- Разрешение на использование: кто может вызывать команду:
Только администраторы [Админ] или все пользователи [Все]?
- Место отправки: куда должно быть отправлено сообщение:
В личные сообщения с ботом [Приват] или в группу [Группа]?
- Несколько ответов: следует ли отправить все ответы одновременно, [Отправить все] или только один случайный [1 случайный]? - Подтвердите создание: [Сохранить ✔️ ]
/personal test Это тестовая команда
Используя этот метод, вы также можете добавить практически все типы медиафайлов - поместив команду в подпись медиафайла.
Если сообщение содержит ссылку, для которой требуется предварительный просмотр ссылки, вам нужно только ввести <link>
где-нибудь в тексте (<nolink>
, с другой стороны, принудительно удаляет предварительный просмотр ссылки).
Удаление персональной команды
/unpersonal
Синтаксис:/unpersonal [имя команды]
Пример:
Для удаления персональной команды можно использовать также /remove
, вместо /unpersonal
II. Персональные ответы
Слова-триггеры, при обнаружении заданного слова бот отправит в группу соответствующее сообщение. Работают аналогично персональным командам, но без необходимости использования символа команды /
Персональные ответы доступны в группе только при наличии платного тарифа PRO или UltraPRO
Есть несколько способов создания персонального ответа:
Метод 1
/reply
в ответ на сообщение
/reply [слово-триггер]
/reply [фраза-триггер]
/reply [слово-триггер] {[кнопка - example.com]}
- Отправьте сообщение (текст, медиа, стикер, gif и т. д.) в группу
- Ответьте на это сообщение:
/reply слово-триггер
- Выберите нужные параметры:
- Разрешение на использование: кто может вызывать команду:
Только администраторы [Админ] или все пользователи [Все]?
- Место отправки: куда должно быть отправлено сообщение:
В личные сообщения с ботом [Приват] или в группу [Группа]?
- Несколько ответов: следует ли отправить все ответы одновременно, [Отправить все] или только один случайный [1 случайный]? - Подтвердите: [Сохранить ✔️ ]
- Отправьте в группу следующий текст:
Спасибо, {MENTION}, вам тоже хорошего дня!
- Ответьте на это сообщение:
/reply Добрый день
и/reply Всем хорошего дня
и задайте параметры:
Когда кто-то отправит сообщение с ключевым словосочетанием Всем хорошего дня
, бот отправит в ответ нужный текст:
В отличие от персональных команд, слово-триггер также может содержать пробелы и являться фразой-триггером. Таким образом, триггер может включать в себя несколько слов или даже полное предложение.
Для того, чтобы бот среагировал на триггер, текст отправленного сообщения должен точно совпадать с «ключевым словом/фразой» 1:1 — как указано: ни словом, ни буквой больше или меньше. Верхний и нижний регистр также учитывается (баг с кириллическими символами).
Метод 2
/reply
/reply [триггер] {[кнопка - example.com]}
- Отправьте сообщение начинающееся сразу с
/reply триггер текст ответа
в группу - Выберите нужные параметры:
- Разрешение на использование: кто может вызывать команду:
Только администраторы [Админ] или все пользователи [Все]?
- Место отправки: куда должно быть отправлено сообщение:
В личные сообщения с ботом [Приват] или в группу [Группа]?
- Несколько ответов: следует ли отправить все ответы одновременно, [Отправить все] или только один случайный [1 случайный]? - Подтвердите создание: [Сохранить ✔️ ]
/reply привет Здравствуй, {MENTION}
При использовании этого метода слово-триггер НЕ должно содержать пробелов
Используя этот метод, вы также можете добавить практически все типы медиафайлов - поместив команду в подпись медиафайла.
Если сообщение содержит ссылку, для которой требуется предварительный просмотр ссылки, вам нужно только ввести <link>
где-нибудь в тексте (<nolink>
, с другой стороны, принудительно удаляет предварительный просмотр ссылки).
Удаление персонального ответа
/unreply
Синтаксис:/unreply [триггер]
Пример:
III. Псевдонимы команд
Команды-псевдонимы используются для переименования или клонирования команд бота, для блокировки или отключения команд.
С их помощью, команды можно адаптировать к индивидуальным требованиям.
В сочетании с персональными командами могут выполняться совместные действия и, таким образом, можно выполнить в основном пять задач.
1. Переименовать существующую команду:
/alias [псевдоним] [команда]
2. Заблокировать существующую команду, чтобы она больше не работала:
/alias [команда]
3. Заблокировать существующую команду и дать той же функции новое имя:
/alias [псевдоним] [команда]
/alias [команда]
4. Подготовить и стандартизировать команду.
/alias [псевдоним] [команда] [время] [причина]
5. Создать команду как в пункте 4 + кнопка:
/alias [псевдоним] [команда] [время] [причина] {[кнопка - ссылка]}
Переименование команды
Прежде всего, можно создать псевдоним команды, при этом функция существующей команды клонируется, а имя существующей команды может быть изменено.
/alias [псевдоним_команда] [существующая_команда]
⚠️ Исключение составляет команда @admin.
/alias go start
В этом случае команда «/start» все еще будет работать, но в то же время будет добавлена и «/go» с той же функцией.
Блокировка (отключение) стандартной команды
Во втором случае может быть создана команда, блокирующая существующую, чтобы последняя больше не работала.
Синтаксис:
/alias [существующая команда]
Пример:
/alias start
В этом случае команда «/start» больше не будет работать.
Переименование команды и блокировка (отключение) стандартной
В третьем примере может случиться так, что администратор слишком часто использует команду, например, «/me», и, таким образом, злоупотребляет ею.
Синтаксис:
◾️/alias [псевдоним_команда] [существующая_команда]
➕/alias [существующая_команда]
/alias Tests me
/alias me
Пояснения:
На первом этапе создается клон "/me" и активируется с помощью "/Tests"
на втором шаге "/me" заблокирована...
Настройка псевдонимов команд
Команды-псевдонимы можно использовать для индивидуальной подготовки и стандартизации команд:
Например, команда, удаляющая сообщение, заглушающая пользователя на определенное время и при этом сообщающая причину действия, это можно задать следующим образом:
Синтаксис:
/alias [псевдоним_команда] [существующая_команда] [промежуток времени] [причина]
Пример:
/alias offtopic delmute 10d 7h 4m Повторное размещение постов не по теме в группе
Так что с этого момента вам нужно только писать /offtopic вместо того, чтобы каждый раз:
/delmute 10d 7h 4m Повторное размещение постов не по теме в группе
Псевдоним команды + сообщение + встроенная клавиатура
Создайте команду, которая включает в себя другие.
Синтаксис:
/alias [псевдоним_команда] [существующая_команда] [промежуток времени] [причина]
/personal [псевдоним_команда] [текст] {[кнопка - ссылка]}
1. Сначала определяется схема отключения звука:
/alias offtopic delmute 2 дня 23 часа 59 минут
2. ... а затем текст сообщения с кнопкой.
/personal offtopic Здравствуйте, {mention}, так как вы неоднократно <b><u>публиковали сообщения не по теме</></>, вы были заблокированы на <b>"3 дня ".
{[Info - popup: Любой текст][help group - example.com] [close - delu]}
Как только команда псевдонима /offtopic будет выполнена, вы получите следующий результат
Кнопка "info" выдает вам заготовленый текст.
Кнопка "help group" переводит вас на указанный сайт
кнопка "close" удаляет это сообщение.
В этом сообщении можно использовать заполнители [{ID}, {MENTION}, {NAME}, {SURNAME}, {USERNAME}, {GROUPNAME} и др.], форматирование HTML и встроенную клавиатуру.
Псевдоним команды: удаление
Синтаксис:
/remove [Псевдоним]
Пример:
/remove offtopic
IV. Инструкция по использованию cmd/cmdu
Cmd/cmdu - тип кнопки, нажав на которую можно активировать команду в том же сообщении.
- Cmd - кнопка активации команды, с которой взаимодействовать может любой.
- Cmdu - кнопка активации команды, с которой взаимодействовать может только тот, кто вызвал команду с этой кнопкой.
Это доступно только в группах PRO/ULTRAPRO.
С помощью команды cmd можно выполнить или вызвать «вторую» персональную команду нажатием кнопки.
Синтаксис: - t.me/DemoGHRU/10
/personal command01 Чтобы узнать больше, нажмите <b>"Далее"</b> {[Далее - cmd:tests]}
Если активировать команду /command01, появится следующее сообщение:
Если нажать на кнопку "далее", то сообщение изменится на текст команды "/tests" (если такая имеется).
Создание меню из нескольких кнопок:
🔰 О каком синтаксисе идет речь, можно посмотреть в @ruDemoGH.
1. Отправляем в чат сообщение с синтаксисом, пример:
Видим текст и синтаксис для двух кнопок.
• Создаем для этого сообщения персональную команду, к примеру: page1
2. Отправляем в чат команду page1 и получаем сообщение из нескольких кнопок:
• В данный момент кнопки "Вторая" и "Третья" работать не будут, так как к ним не прикреплены никакие команды, поэтому нам нужно и для этих кнопок создать команду.
3. В кнопке "Вторая" у нас вписана команда /page2. Отправляем в чат сообщение, пример:
• Создаем для этого сообщения персональную команду, к примеру: /page2.
ℹ️ Как можете увидеть, помимо обычного текста, здесь также будет кнопка с командой page1. Если еще не забыли, то к данной команде прикреплена первая страница. То есть при нажатий на эту кнопку, оно будет выполнять роль команды page1 и текст будет меняться на текст этой команды.
• Теперь при отправке команды /page2 в чат, мы увидим:
3. Теперь тоже самое проворачиваем и с кнопкой "Третья".
• Отправляем в чат сообщение, пример:
• Создаем для этого сообщения персональную команду, к примеру: page3.
Теперь при отправки команды page3 в чат, мы увидим:
Эта кнопка работает также как и кнопка Вторая, то есть кнопка назад ведет к первой странице и в нее вписана команда page1.
ℹ️ Это лишь маленький пример создания меню из нескольких команд.
Необязательно брать названия, текст или сами персональные команды из этого примера, все под вашей властью.
- del - кнопка удаления, с которой может взаимодействовать любой.
- delu - кнопка удаления, с которой может взаимодействовать только тот, кто вызвал команду.
Popup - кнопка, по нажатию которой открывается окно сообщения с текстом до 60 символов.
В случае если нужно что-то исправить или дополнить, обращайтесь к администрации русскоязычной группы поддержки.