Список команд
Данная статья может быть устаревшей. Она находится на стадии актуализации.
Все актуальные команды расположены по следующим ресурсам:
- В боте: .команды — весь существующий список команд;
- Более подробно: https://eskacm.gitbook.io — но пока что не все команды расписаны.
Значения в тексте
- Указание целевого пользователя: {целевой пользователь / админ} — указание ссылки на пользователя или админа (смотря, что указано в скобках) в одном из удобных форматов:
- Ссылка — ссылка на пользователя в формате https://t.me/username или t.me/username
- Ид пользователя — ID пользователя
- Юзернейм — логин пользователя в Телеграме, отображаемый через @, например: @username
- Реплай — ввод команды в ответ на сообщение другого пользователя
- Команда может применяться ко всей аудитории команды только в тех местах, где в аргументах явно прописано "целевой пользователь / все"
Термин "целевой пользователь" — обозначает пользователя, в сторону которого применяется та или иная команда / действие.
- Текст, указанный в квадратных скобках <> — вы можете выбрать одно из значений через слеш /. То есть, если написано .<бан/варн/мут>, значит вы можете ввести одну из трех команд: .бан, .варн или .мут
- Параметры команд, указанные в {} или в [] - означают обязательные и необязательные, соответственно.
- "❌ | ..." или "✅ | ..."— символы, означающие статус переноса данной функциональности в новую версию бота. Связано с тем, что на данный момент идет разработка бота. Если одним из этих символов помечен раздел, значит он весь соответствует ему.
- Обозначения доступность команд:
🍀 Реферальная система ❌
С помощью приглашения других пользователей в бот, вы можете получать по одному голосовому и одному текстовому запросам к искуственному интеллекту, а приглашенные пользователи будут получать их в количестве 10 штук в каждом из видов запроса к ИИ.
- Чтобы создать реферальный код, введите команду .реферал {одно любое слово/выражение}
- После этого, когда бот вам ответит "Ваш реферальный код успешно создан! 🎉", вы можете приглашать пользователей в бот в виде специальной ссылки: https://t.me/eskacm_bot?start=*ваш реферальный код*, например: https://t.me/eskacm_bot?start=eska
- После того, как пользователь переходит именно по этой ссылке вводит команду /start в боте, ему начисляется 10 голосовых и текстовых запросов к ИИ, а вам начисляется по 1 штуке каждого запроса за каждого зарегистрированного пользователя.
Реферальный код может быть только один, если вы введёте другой код в команде .реферал — система спросит у вас, хотите ли вы сменить реферальный код, если нажать на кнопку "Да" — введённый вами код сменит прошлый, а также покажет новую ссылку для приглашения пользователей.
Общие команды
Команды в этом разделе не привязаны только к чату или только к личке с ботом — их можно использовать везде и без ограничений по рангу
- ❌ | .баланс — показывает баланс эсков, а также на что их можно обменять.
- ❌ | .баланс чата — показывает баланс эсков в чате.
- ❌ | .эски в чат {количество} — внести собственное количество эсков на баланс чата ❌
- ❌ | .добавить бота — покажет кнопку, по нажатию на которую вам нужно выбрать чат, куда добавить бота, после выбора вам предложит изменить установленные права администратора — чтобы бот работал исправно, никакую из кнопок изменять не нужно. ❌
- 👥 ✅ |.чатссылка {+/-} [ранее созданная пригласительная ссылка, которую нужно удалить] — манипулирование ссылкой на текущий чат. Если чат публичный, то выдаст ссылку на него (вне зависимости от состояния: "+" или "-"), иначе, в зависимости от состояния:
💢 Ссылка, сгенерированная ботом - действует только в одном экземпляре (то есть, если вы последовательно сгенерировали 2 ссылки, то работать будет только последняя из них).
Возможность удаления сделана для любых приватных ссылок в чате (например, сгенерированных другими ее админами)
- ✅ | ?{команда} — посмотреть информацию о команде: ее доступности, параметрах и прочем. Например: ?приветствие /
- ✅ | ?{часть команды} — посмотреть все команды, содержающие введенную часть. Например: ?при
- 👥 ✅ | .отвязать чат — отвязать привязанный чат от текущего
- 👥 ✅ | .отвязать от чатов — отвязать текущий чат от всех, к которым он привязан
- 👥 ✅ | .привязки чата — показать все чаты, где в привязках участвует текущий чат: и то, какой чат привязан к текущему, и то, к каким чатам привязан текущий
Важно: в привязываемом чате вы должны быть владельцем или модератором. Привязанный чат может быть только 1. Если вы привязали сначала один чат, потом другой — привязан будет последний.
- 👥 ✅ | .чат инфо — полная информация о чате.
- 👥 ✅ | .созвать {админов / всех} [эмодзи для реакции] [сообщение] — в зависимости от указанной аудитории будут созваны либо администрация всех рангов, либо весь чат.
С командой: .созвать админов — бот упомянет всех администраторов в чате по их @username (те администраторы, у кого юзернейм не установлен — упомянуты не будут), а также придет в личку ко всем админам чата с сообщением, что какой-то из других админов чата созывает всю администрацию.
Также бот покажет, скольких админов из числа всех он уведомил в личку.
С командой: .созвать всех — бот отправит сообщение в чат и автоматически закрепит его.
Вы так же в любом из обоих типов созыва вы можете указать эмодзи для реакции, одно из 72 штук, поддерживаемых Телеграмом, плюс к этому еще и указать сообщение. Бот автоматически проставит его, а другие пользователи смогут нажимать на него — может понадобится, когда вы хотите видеть, кто конкретно прочитал сообщение от начала до конца.
Например: .созвать админов 👍 Приглашаю всю администрацию на вечеринку в эту среду в 19:00. Дополнительную информацию вышлю за пару часов до начала.
В обоих случаях бот удалит ваше сообщение с вызовом команды, чтобы сообщения от вас и бота не дублировались.
🗣️ При созыве вы можете не указывать вообще никакой из двух аргументов команды, либо вызывать только один, либо вызвать оба.
- ❌ | .стата по смс — отобразит топ пользователей по сообщениям в вашем чате + общее кол-во сообщений за текущий день.
- ❌ | .АИ+/- — включает/выключает возможность взаимодействия пользователей чата с искуственным интеллектом
- ❌ | .уведы ИИ+/- — включает/выключает уведомления о том, что в текущем чате выключено взаимодействие с искуственным интеллектом.
- ❌ | .уведы — посмотреть список типов уведомлений.
- ❌ | .увед {тип уведомления}{-/+} — отключить / выключить уведомление команды. Например: .увед команды- — отключит уведомление со статьей с командами.
Системы чата
Вызвать можно командой .чат системы
.
С помощью этого можно управлять, на данный момент, 7 системами чата:
- Приветствие.
- Мониторинг банвордов.
- Капча для новых участников.
- Бан за три накопительных варна у пользователя.
- Перевыдача наказаний
Первые 4 системы можно только включить / выключить. С Перевыдачей наказаний все интереснее.
Перевыдача наказаний
При нажатии на кнопку управления этой системой вам показывается:
- ◼️◻️ Состояние: включена / выключена;
- ⏺️ Условие срабатывания;
- ✳️ Доступные условия для смены.
Его можно только "тоггнуть", то есть включить, если выключен, и наоборот.
- 👮 Перевыдача только админами с рангом 🔼 выше;
- 👮 Перевыдача только админами с рангом 🔽 ниже;
- ⏳ Только если срок наказания 🔼 увеличивается;
- ⏳ Только если срок наказания 🔽 уменьшается;
- 👮☑️ Конкретный список администраторов
Если из первых четырех вы можете просто заменить их один на другой, то при установке пятого...
👮☑️ Конкретный список администраторов
Этот список определяет список администраторов с возможностью перевыдачи наказания поверх уже существующего.
Всего мест в списке — 3. В случае, если список будет пустым, перевыдать наказание не сможет никто — даже 6-ой ранг администрация (владельцы чата).
Доступны для выбора все модераторы и владельцы чата, от 1 до 6 ранга.
✳️ Доступные условия для смены
Отображаются все системы с возможностью изменения на конкретную из них, кроме уже выбранной.
Репутация ❌
Репутация на данный момент пока что привязана к пользователю, а не к отдельным чатам у пользователя. То есть считается вне зависимости от чатов.
Изначально у каждого из пользователей установлена начальная модерская и пользовательская репутации:
- Модерская показывается в профиле пользователя, он в чате, где вызывает команду "кто я" или "кто ты", является модератором.
- Пользовательская показывается, если пользователь не является в этом чате модератором.
На данный момент нельзя понизить репутацию другому пользователю больше нулевого значения, из-за того, что статусы для минусовых значений ещё не созданы — это будет введено в ближайшем будущем.
Всего на данный момент есть по 10 модерских и по 10 пользовательских статусов. Статусы определяются баллами репутации пользователя / модератора.
Всего баллов, в рамках которых реализованы статусы — 10000.
- Модерские:
- Начальный — Зеленый страж
- Строгий смотритель — 10 репутации
- Неукротимый — 30 репутации
- Повелитель порядка — 100 репутации
- Хранитель справедливости — 300 репутации
- Великий мудрец — 500 репутации
- Модератор-гуру — 1000 репутации
- Непоколебимый — 3000 репутации
- Легендарный модератор — 5000 репутации
- Модератор-супергерой — 10000 репутации
- Пользовательские:
Когда вы пишите "+", "❤️", "👍", или "спасибо" {целевой пользователь} — для увеличения репутации этого пользователя или "👎", "-" — для её уменьшения, бот совершает несколько действий:
- Если модератор — увеличивает модерский балл, если пользователь — пользовательский балл;
- Если в чате пользователь является модератором и ему присваивается репутационный статус — будет установлен модерский в этом чате, в ином случае — пользовательский.
Пример ввода команды: + @username ИЛИ + t.me/username ИЛИ + (ответом на сообщение другого пользователя)
Для владельцев чатов ❌
Команды в этом разделе доступны только создателям чатов, либо тем, кому эту роль передали в чате на уровне самого Телеграма, не в боте.
- .владелец {целевой пользователь} — выдача владельца другому пользователю в чате. Владельцев в чате может быть только 2.
- .забрать владельца {целевой пользователь} — выдача владельца другому пользователю в чате. Владельцев в чате может быть только 2.
- !удалить чат — удаляет чат полностью из базы данных. Чтобы его снова инициализировать, владельцу или администраторам чата (именно назначенным через Телеграм) нужно написать любое сообщение в чат.
- .восстсозд — восстановит вас в создателе, если вы являетесь им на уровне Телеграма (т.е. в самом чате, а не в боте)
Банворды ✅
- 👥 ✅ | .банворд {+, -, /} {слово / словосочетание} — добавить (+) или удалить банворд (-) из мониторинга. Переключить состояние системы — /
Мониторинг банвордов будет отлавливать запрещенные слова / словосочетания в чате, например: .банворд + Банворд — будет смотреть отлавливать сообщения, где есть это есть слово (либо словосочетание), даже если это словосочетание написано вроде "блинБанвордблин" — выловит Банворд.
Уведомления об отловленных банвордах работают следующим образом:
- Если автор сообщения с банвордами является владельцем чата, переход к п. 2. В ином случае - отправление уведомления ему в личку.
- Если в п. 1 отправка не случилась и у текущего чата есть привязанный логгинг-чат - отправка будет в него, в ином случае - переход к п. 3.
- Если оба выше перечисленных варианта неуспешны - уведомление будет отправлено в тот же чат, где банворды были отловлены.
🔗 В привязанные чаты уведомления отсылаются раз в 3 секунды — связано это с лимитами Телеграма.
При этом даже если какие-то сообщения не были доставлены по причине отвязки чата — при повторной привязке чата эти сообщения будут доставлены автоматически.
Кнопки ограничения "бан / варн / мут" в сообщении с уведомлением создаются только в случае, если автор сообщения с банвордом не является админом чата на уровне Телеграма и, следовательно, бот сможет применить эти ограничения к пользователю.
Для правильного распознавания нескольких банвордов придерживайтесь следующих перечислений:
- Количество использований банворда уникально количеству юзеров, которые его использовали. То есть если 1 юзер использовал банворд 6 раз, он все равно будет отображен в списке банвордов, как 1 использование - и так с каждым юзером.
- Юзер убирается из списка использований банворда только в случае, когда получает одно из трех ограничений (бан / варн / мут) из меню ограничения — оно присылается в привязанный чат, в личку владельцу (если привязанного чата нет) или в чат, где этот банворд был употреблен (если оба других варианта недоступны) - только в такой последовательности.
- ❌ | С подпиской вы также можете управлять количеством слов одновременно используемых в одном предложении.
Капча ✅
Вариант с добавлением одного пользователя в чат:
- Бот поприветствует пользователя, а также отключает ему возможность писать в чат до момента, пока он не решит отправленную в чат капчу.
Администрирование
- 👥 ✅ | .модеры — показать список модераторов с краткой информацией о них
- 👥 ✅ | .модер {целевой пользователь} [ранг или +/-] — показать полную информацию о конкретном модераторе или выдать ему новый ранг (если указан).
- Информация о последнем изменении ранга модератора не будет обновлена, если это изменение применялось ко всем модерам (с аргументом "все", вместо указания целевого пользователя)
- 👥 ✅ | .дк {команда} {ранг доступа} — регулировка доступов к разным командам.
- 👥 | .чат {-/+} [время] — открыть (+) или закрыть (-) чат. Без указания времени чат закрывается до тех пор, пока вручную не будет открыт.
- 👥 | .адмварн {целевой админ} — выдача варна администратору чата. При накоплении 3 варнов админ автоматически снимается с должности. Количество варнов отображается в команде .модер.
- 👥 | .адмразварн {целевой админ} — выдача варна администратору чата. При накоплении 3 варнов админ автоматически снимается с должности.
- 👥 ✅ | .истнаруш [целевой пользователь] — выведет наказания пользователя в количестве 7 штук и/или за последние 7 дней
По какому принципу я добавляю эти нарушения в историю юзера:
- Когда наказание выдается через Эску в любом из чатов, это наказание автоматически пересылается мне
- Если наказание действительно является ризонным* - оно добавляется в историю нарушений юзера
* Ризонным нарушением в истории юзера считается:
- Не выданное юзеру случайно
- Соответствует нарушению правил в большинстве чатов (например, оскорбление и т.п.)
История нарушений юзера отображает последние 7 штук или за последние 7 дней и только те, которые действительно могут принести вред коммьюнити / атмосфере большинства чатов.
- ❌ | редактранг — регулировка доступа к редактированию команд. На данный момент является единственной командой, которая предназначена только для регулировки доступа, а не для использования. ❌
Приветствие
Плейсхолдер в системе бота предназначен заменять текст, при этом достаточно гибко: в разных местах вы можете указать плейсхолдер с разными параметрами на выбор.
Начинаются плейсхолдеры с обязательного (юзер и заканчиваются).
Внутри вы можете указать следующие аргументы: -ссылка, -ид, -имфам, -юзернейм.
⚠️ Важно! То же самое будет написано и в случае отсутствия имени и фамилии в плейсхолдерах или у самого аккаунта пользователя.
- -ссылка - убирает ссылку на профиль пользователя. То есть невозможно будет нажать на имя / фамилию пользователя.
⚠️ Важно! Если пользователь отключил ссылку на свой профиль в настройках - она будет отключена, даже если -ссылка не будет в параметрах плейсхолдеров.
- -ид - убирает айди пользователя. При наличии этот параметр будет выглядеть так: (ID: 123456789)
- -имя / -фам - убирает имя и/или фамилию (в зависимости, что укажете) из ссылки или просто из упоминания (в случае, если ссылка отключена)
- -юзернейм - убирает юзернейм из приветствия. В случае, если у юзера он есть, будет выглядеть так: @username
🖌️ Например, вы вводите: .приветствие Привет, (юзер -имя -фам -ссылка). При добавлении нового пользователя в чат текст будет следующим:
Привет, Пользователь (ID: 1234567890)
- 👥 ✅ | .приветствие плейсхолдеры — узнать о существующих тегах для применения в приветствии
- 👥 ✅ | .приветствие - — удаляет установленное приветствие
- 👥 ✅ | .приветствие — показывает установленное на данный момент приветствие в чате
- ❌ | .приветствие подписка / — включает/выключает режим разных приветствий при присоединении новых участников к вашему чату. Доступно только с подпиской (кликабельно). Пример: .приветствие подписка+ — включит функцию. Важно: использовать нужно с + или - в конце, без пробелов.
Сеть чатов ❌
Для создания сети чатов используйте команду .сеть чатов создать, после чего выберите чаты и нажмите кнопку ✳️ Создать сеть чатов.
В процессе создания и после него вы можете удалить какой-либо чат из сети, нажав кнопку 🧨 Удалить определенный чат
Рассылка в чат(ы) ❌
Чтобы создать первую свою рассылку, нажмите на кнопку ⚙️ Управлять рассылками, после чего на 📧 Создать рассылку, далее создайте следуйте указаниям бота.
Если у вас нет подписки на сеть чатов, вы сможете создавать только одну отложенную рассылку. С подпиской их количество повышается до 10-ти.
Автоматизация
Триггеры.
С их помощью вы можете настроить авто-действия, срабатывающие при конкретном условии.
- Пересылка из другого канала. Любое сообщение, в котором пользователь чата переслал пост из какого-либо канала.
- Капс. Предел количества процентов или букв (на выбор) в Верхнем регистре (КАПС).
- Ссылка. Любая ссылка.
- Флуд. 3 сообщения подряд в пределах 60-ти секунд.
- Повторяющиеся сообщения. Количество одинаковых сообщений в пределах 60-ти секунд.
- Длина сообщения. Предел количества символов в сообщении.
- Содержание бранных слов. Содержание в сообщении одного или нескольких из, на данный момент, ~1300 бранных слов.
- Выход админа из чата.
Возможные действия со сработанным сообщением (применимо ко всем, кроме Выхода админа из чата):
- Переслать в привязанный чат. Перешлет сообщение в привязанный логгинг-чат.
- Удалить сообщение. Удалит сообщение — это действие недоступно в триггере Выход админа из чата.
- Ограничение. Выполнит любое из трех назначенных ограничений.
- Снятие с должности. Снимет вышедшего администратора из чата с его ранга — это действие доступно только в триггере Выход админа из чата.
Заметки ❌
После создания авто-действия вы можете управлять им через меню .автом.
- .заметка {название} — посмотреть заметку в чате.
- .заметка создать {название} {текст} — создать заметку в чате.
- .заметка изменить название {название заметки} {новое название} — изменить название заметки в чате.
- .заметка изменить текст {название заметки} {новый текст} — изменить текст заметки в чате.
- .заметка удалить {название} — удалить заметку в чате.
- .заметки — все заметки в чате.
Изначально вам доступны 5 заметок с добавлением фото или видео. Далее — по подписке Заметок.
Заметки могут быть как и просто в виде текста, так и с видео или фото, а также вне зависимости от вложений текст может содержать гиперссылки.
Ограничение пользователей
Срок указывается в одной букве формата времени:
Причина - указывается в формате текста, допустимы любые символы (цифры, буквы, смайлики).
- 👥 ✅ | .раз<бан/варн/мут> {целевой пользователь} [причина] — снять бан/варн/мут пользователю. Параметры те же, что и в прошлом пункте.
- 👥 ✅ | .бан за три варна {время / состояние (- / +)} — настройка срока бана пользователя, когда он набирает 3 варна в чате, формат времени например:
- .бан за три варна 10с — формат времени тот же, что и здесь
- .бан за три варна / — изменит текущее состояние (включит, если выключен, и наоборот)
- 👥 ✅ | .<бан/варн/мут>инфо {целевой пользователь} — снять бан/варн/мут пользователю
- 👥 ✅ | .<бан/варн/мут>лист {целевой пользователь} — показать всех пользователей с указанным ограничением
- 👥 ✅ | .правила [- или текст]
Пользовательские
- ✅ | .профиль [целевой пользователь] — покажет информацию об указанном пользователе (о вас, если пользователь не указан)
- ❌ | .ник — управление своим ником в чате
При вводе в личке с ботом - выведет обычный список команд по категориям по дефолту установленных рангов.
При вводе в чате - выведет этот же список команд, но уже с распределением по рангам команд из чата. То есть будут выводиться и дефолтные значения рангов в командах, где это не было изменено, и те команды, ранги которых были изменены через команду .дк
- ❌ | топ — вывести топ сообщений пользователей по всему боту
- ❌ | .ктовчате {вопрос} — указывает, кто из людей в чате является тем, кто указан в вопросе. Пример: .ктовчате разработчик бота
- ❌ | .привет {целевой пользователь} {текст} — поприветствовать человека от лица бота с помощью кастомного текста. Не путайте с приветствием при входе.
- ✅ | .репорт {ответ на сообщение} — отправить жалобу на человека с доказательством его нарушения. Поддерживается только формат ответа на сообщение.
Искуственный интеллект ❌
- .Эска, {текст} — общаться с искуственным интеллектом.
- войсы боту — общаться с искуственным интеллектом в формате голоса. ИИ отвечает текстом. Не нужно вводить эту команду, просто отправляйте войс.
РП-команды ❌
- .предлрп {команда} {действие} {смайлик(и)} {18+ команда или нет} — предложить добавление глобальной РП-команды в бот.
Пример: .предлрп тронуть тронул(а) 🙂 нет:
- Тронуть — команда. Должна быть написана только в формате "что сделать?": тронуть, обнять, погладить.
- Тронул(а) — действие. Должно быть написано только в формате "что сделал(а)?": тронул(а), сходил(а) в кино с, посмеялся(ась) с шутки.
- Смайлик(и) — могут быть добавлены в количестве от 1 до 3.
- 18+ команда или нет — возрастное ограничение команды. Должно быть написано только в одном из двух вариантов: да или нет
ВАЖНО! За публикацию списка найденных вами РП-команд в боте вы получаете полное обнуление вашего аккаунта и пожизненный бан в боте
РП-команды не лежат в общем списке. Вам необходимо находить их самостоятельно.
Использование РП-команд возможно как к одному пользователю, так и к нескольким, просто перечисляя их, например: +{РП-команда} @eskanderrr @telegram @username
Личные РП ❌
Без подписки вы можете владеть максимум 2 личными РП.
- .рп создать {команда} {эмодзи} — позволяет создать свою личную РП-команду, которую вы сможете использовать в любом из чатов, где установлен чат-менеджер.
- Команда — действие, например: укусить, укусить за бочок
- Не может содержать менее 5 и/или более 15 символов.
- Должно быть хотя бы одно действие (т.е. слово, содержащее окончание "ть"), например: "укусить", "оторвать", "слезть с" — да, вы можете создавать команды из нескольких слов :)
- Эмодзи — должно быть от 1 до 3.
- .рп мои — посмотреть существующие личные РП, управлять ими: например, удалить, изменить саму команду или эмодзи в ней.
В этом же меню вы можете нажать на нужную РП-команду, после чего изменить её: установить другую команду, эмодзи, либо вовсе удалить.
Если у вас закончится подписка ЛРП — вы всё так же сможете использовать только первые 2 созданные вами РП.
Прочее ❌
Ссылки
Разработчик бота: @eskanderrr
Официальный канал: t.me/TeleEscalade
Чат тестировщиков: t.me/chat_eska