Инструкции
June 2, 2022

Персональные команды в Group Help

Group Help позволяет создавать персональные команды и ответы для решения различных задач:



I. Персональные команды

Команды-триггеры, начинающиеся с /. При выполнении заданной команды бот отправит в группу соответствующее сообщение.

Есть несколько способов создания персональной команды:

Метод 1

/personal в ответ на сообщение

Синтаксис:

/personal [имя команды]

С кнопками:

/personal [имя команды] {[кнопка - example.com]}

Инструкция:

  1. Отправьте сообщение (текст, медиа, стикер, gif и т. д.) в группу
  2. Ответьте на это сообщение: /personal имя_команды
  3. Выберите нужные параметры:
    - Разрешение на использование: кто может вызывать команду:
    Только администраторы [Админ] или все пользователи [Все]?
    - Место отправки: куда должно быть отправлено сообщение:
    В личные сообщения с ботом [Приват] или в группу [Группа]?
    - Несколько ответов: следует ли отправить все ответы одновременно, [Отправить все] или только один случайный [1 случайный]?
  4. Подтвердите: [Сохранить ✔️ ]

Пример:

Выбираем параметры и нажимаем "сохранить"

Когда кто-то вызовет команду /test - бот отправит заданное сообщение

Внимание:

Имя команды не может содержать пробелы;
Допустимые символы*: буквы, цифры и знак подчеркивания: _

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

[наверх]


Метод 2

/personal

Синтаксис:

/personal [имя команды] [текст]

С кнопками:

/personal [имя команды] [текст] {[кнопка - example.com]}

Инструкция:

  1. Отправьте сообщение начинающееся сразу с /personal имя_команды текст ответа в группу
  2. Выберите нужные параметры:
    - Разрешение на использование: кто может вызывать команду:
    Только администраторы [Админ] или все пользователи [Все]?
    - Место отправки: куда должно быть отправлено сообщение:
    В личные сообщения с ботом [Приват] или в группу [Группа]?
    - Несколько ответов: следует ли отправить все ответы одновременно, [Отправить все] или только один случайный [1 случайный]?
  3. Подтвердите создание: [Сохранить ✔️ ]

Пример:

/personal test Это тестовая команда

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

Если сообщение содержит ссылку, для которой требуется предварительный просмотр ссылки, вам нужно только ввести <link> где-нибудь в тексте (<nolink>, с другой стороны, принудительно удаляет предварительный просмотр ссылки).

[наверх]


Удаление персональной команды

/unpersonal

Синтаксис:
/unpersonal [имя команды]

Пример:

/unpersonal test

Для удаления персональной команды можно использовать также /remove, вместо /unpersonal

удаление персональной команды через /remove

[наверх]


II. Персональные ответы

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

Персональные ответы доступны в группе только при наличии платного тарифа PRO или UltraPRO

Есть несколько способов создания персонального ответа:

Метод 1

/reply в ответ на сообщение

Синтаксис:

/reply [слово-триггер]
/reply [фраза-триггер]

С кнопками:

/reply [слово-триггер] {[кнопка - example.com]}

Инструкция:

  1. Отправьте сообщение (текст, медиа, стикер, gif и т. д.) в группу
  2. Ответьте на это сообщение: /reply слово-триггер
  3. Выберите нужные параметры:
    - Разрешение на использование: кто может вызывать команду:
    Только администраторы [Админ] или все пользователи [Все]?
    - Место отправки: куда должно быть отправлено сообщение:
    В личные сообщения с ботом [Приват] или в группу [Группа]?
    - Несколько ответов: следует ли отправить все ответы одновременно, [Отправить все] или только один случайный [1 случайный]?
  4. Подтвердите: [Сохранить ✔️ ]

Пример:

  1. Отправьте в группу следующий текст: Спасибо, {MENTION}, вам тоже хорошего дня!
  2. Ответьте на это сообщение: /reply Добрый день и
    /reply Всем хорошего дня и задайте параметры:
Не забудьте сохранить

Когда кто-то отправит сообщение с ключевым словосочетанием Всем хорошего дня, бот отправит в ответ нужный текст:

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

Для того, чтобы бот среагировал на триггер, текст отправленного сообщения должен точно совпадать с «ключевым словом/фразой» 1:1 — как указано: ни словом, ни буквой больше или меньше. Верхний и нижний регистр также учитывается (баг с кириллическими символами).

[наверх]


Метод 2

/reply

Синтаксис:

/reply [триггер] [текст]

С кнопками:

/reply [триггер] {[кнопка - example.com]}

Инструкция:

  1. Отправьте сообщение начинающееся сразу с /reply триггер текст ответа в группу
  2. Выберите нужные параметры:
    - Разрешение на использование: кто может вызывать команду:
    Только администраторы [Админ] или все пользователи [Все]?
    - Место отправки: куда должно быть отправлено сообщение:
    В личные сообщения с ботом [Приват] или в группу [Группа]?
    - Несколько ответов: следует ли отправить все ответы одновременно, [Отправить все] или только один случайный [1 случайный]?
  3. Подтвердите создание: [Сохранить ✔️ ]

Пример:

/reply привет Здравствуй, {MENTION}

При использовании этого метода слово-триггер НЕ должно содержать пробелов

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

Если сообщение содержит ссылку, для которой требуется предварительный просмотр ссылки, вам нужно только ввести <link> где-нибудь в тексте (<nolink>, с другой стороны, принудительно удаляет предварительный просмотр ссылки).

[наверх]


Удаление персонального ответа

/unreply

Синтаксис:
/unreply [триггер]

Пример:

/unreply всем хорошего дня

[наверх]


III. Псевдонимы команд

/alias


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


с помощью псевдонима можно:

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?

  • Cmd - кнопка активации команды, с которой взаимодействовать может любой.
  • Cmdu - кнопка активации команды, с которой взаимодействовать может только тот, кто вызвал команду с этой кнопкой.

Примечание:

Это доступно только в группах PRO/ULTRAPRO.

Описание:

С помощью команды cmd можно выполнить или вызвать «вторую» персональную команду нажатием кнопки.
Синтаксис: - t.me/DemoGHRU/10

Пример:

/personal command01 Чтобы узнать больше, нажмите <b>"Далее"</b> {[Далее - cmd:tests]}

Если активировать команду /command01, появится следующее сообщение:

Если нажать на кнопку "далее", то сообщение изменится на текст команды "/tests" (если такая имеется).

Создание меню из нескольких кнопок:

🔰 О каком синтаксисе идет речь, можно посмотреть в @ruDemoGH.

1. Отправляем в чат сообщение с синтаксисом, пример:

Синтаксис первой страницы.

Видим текст и синтаксис для двух кнопок.

• Создаем для этого сообщения персональную команду, к примеру: page1
2. Отправляем в чат команду page1 и получаем сообщение из нескольких кнопок:

Команда page1.

• В данный момент кнопки "Вторая" и "Третья" работать не будут, так как к ним не прикреплены никакие команды, поэтому нам нужно и для этих кнопок создать команду.

3. В кнопке "Вторая" у нас вписана команда /page2. Отправляем в чат сообщение, пример:

Синтаксис для кнопки Вторая.

• Создаем для этого сообщения персональную команду, к примеру: /page2.
ℹ️ Как можете увидеть, помимо обычного текста, здесь также будет кнопка с командой page1. Если еще не забыли, то к данной команде прикреплена первая страница. То есть при нажатий на эту кнопку, оно будет выполнять роль команды page1 и текст будет меняться на текст этой команды.

• Теперь при отправке команды /page2 в чат, мы увидим:

Работоспособность кнопки "Вторая" .

3. Теперь тоже самое проворачиваем и с кнопкой "Третья".

• Отправляем в чат сообщение, пример:

Синтаксис для кнопки Третья.

• Создаем для этого сообщения персональную команду, к примеру: page3.
Теперь при отправки команды page3 в чат, мы увидим:

Кнопка Третья.

Эта кнопка работает также как и кнопка Вторая, то есть кнопка назад ведет к первой странице и в нее вписана команда page1.

ℹ️ Это лишь маленький пример создания меню из нескольких команд.
Необязательно брать названия, текст или сами персональные команды из этого примера, все под вашей властью.

del и delu

  • del - кнопка удаления, с которой может взаимодействовать любой.
  • delu - кнопка удаления, с которой может взаимодействовать только тот, кто вызвал команду.

Popup

Popup - кнопка, по нажатию которой открывается окно сообщения с текстом до 60 символов.


... Вернуться к содержанию

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