QZy BOT manual

QZy BOT

Public manual

Актуальный мануал по QZy BOT для админов Telegram-чата

Нормальная карта команд, /panel-флоу и живых сценариев без legacy-шума. Здесь только публичный и admin-facing слой: то, что реально нужно для запуска, настройки и повседневной модерации.

Актуальность runtime map 2026-04-11
Контур public + admin
Формат отдельная manual-page
6 команд в личке
2 групповых команды для всех
15 админ-команд
6 автосценариев

Quick start

Как запустить QZy BOT без хаоса

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

01

Открой бота в личке

Запусти /start, посмотри welcome-меню и убедись, что открывается /panel.

02

Добавь бота в чат

Подключи QZy BOT в нужную группу и сразу проверь, что чат появился в панели.

03

Выдай права админа

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

04

Включи базовую защиту

Через /panel включи mod, anti-link и flood, а потом только докручивай лимиты.

05

Проверь статистику

После первых живых дней смотри /stats и /stats7, чтобы подкрутить правила по фактам, а не по ощущениям.

Roles

Кто и как пользуется ботом

Участник / пользователь

Использует личку бота для запуска, языка, помощи и базовых user-facing функций. Это безопасный слой, с которого начинается знакомство с ботом.

/start /panel /help /language /fact

Админ чата

Управляет повседневной модерацией, включает защиту, настраивает лимиты и смотрит нагрузку через /stats и /stats7.

/warn /mute /ban /panel anti-link flood

Commands

Команды, которые реально нужны в работе

Без внутреннего служебного слоя. Только то, что относится к user/admin сценариям и актуально для живого чата.

Команды в личке

Это стартовый слой: вход в продукт, help и панель доступных чатов.

Все пользователи
Команда Назначение Где работает
/start Старт и приветствие ЛС
/welcome Повторно показать welcome ЛС
/panel Открыть панель чатов ЛС
/language Сменить язык RU/EN ЛС
/help Короткая справка по путям и функциям ЛС
/fact Случайный факт ЛС / группа

Команды в группе для всех

Публичный слой внутри чата без модераторских прав.

Участники чата
Команда Назначение Где работает
/fact Случайный факт в чат Группа
/ai AI-ответ в чат Группа

Команды модерации

Большинство мод-команд применяются как reply к сообщению нарушителя. Это основной рабочий набор для реальной модерации.

Админ чата
Команда Назначение Где работает
/mute [minutes] Мут пользователя Группа / reply
/unmute Снять мут Группа / reply
/warn Выдать предупреждение Группа / reply
/unwarn Снять предупреждение Группа / reply
/warns Показать количество предупреждений Группа / reply
/kick Кик пользователя Группа / reply
/ban [duration] [reason] Бан пользователя Группа / reply
/unban Разбан Группа / reply
/factauto on|off|status [hours] Автофакты по расписанию Группа
/stats Статистика за день Группа
/stats7 Статистика за 7 дней Группа
/config Показать конфиг чата Группа
/del Удалить сообщение Группа / reply
/lock Заморозить чат Группа
/unlock Разморозить чат Группа

Workflow

Что ускоряет работу админов

Алиасы без слэша

Бот понимает короткие мод-команды текстом: «мут», «бан», «удали» и RU/EN-варианты.

Reply-first модерация

Большинство мод-команд рассчитано на reply-сценарий: увидел нарушение, ответил, применил действие.

Inline undo-кнопки

После warn, mute или ban бот может показать быстрый откат: undo, unmute, unban, unwarn.

Natural language триггеры

Часть админских действий можно запускать не только слэшами, но и понятными ключевыми словами.

Panel flow

Как устроен путь через /panel

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

Стартовое меню /start

Первая точка входа: отсюда пользователь уходит в панель, помощь и язык.

  • pan:start
  • pan:help
  • ulang:start
  • add_to_group(url)

Панель /panel

Главный user/admin entrypoint для выбора чатов и перехода к настройкам.

  • pan:chats
  • pan:help
  • pan:lang
  • hide / unhide chat

Настройки конкретного чата

Здесь живут основные operational controls под конкретное сообщество.

  • chat:menu:main:
  • chat:menu:moderation:
  • chat:menu:links:
  • chat:menu:flood:
  • chat:menu:tools:

Automation

Что бот делает сам в живом контуре

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

Known chats sync

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

Проверка новых участников

При входе новых пользователей бот может сразу применить blacklist-логику и базовые правила защиты.

Anti-link

Фильтрует ссылочный шум по режимам basic / invites / domain и по политике наказаний чата.

Flood control

Ловит спам-всплески, повторы и шумовую нагрузку через лимиты и правила антифлуда.

Regex patterns

Даёт дополнительный слой фильтрации по паттернам и blacklist-правилам.

Fact auto

Планировщик /factauto позволяет поддерживать ритм чата без ручной рутины.

Scenarios

Как применять это в реальных чатах

Новый чат

  • Открыть /start и /panel в личке.
  • Добавить бота в группу и выдать админ-права.
  • Включить mod + anti-link + flood без агрессивных лимитов.

Активное сообщество

  • Настроить flood_limit и warn_limit через /panel.
  • Подключить /stats7 и смотреть топ нарушителей.
  • Оставить предупреждения как первую ступень перед жёсткими санкциями.

Команда админов

  • Использовать reply-команды как общий рабочий протокол.
  • Опирайся на aliases и inline undo для быстрых действий.
  • Правила и лимиты держи централизованно в /panel, а не в голове.

Чат с высокой нагрузкой

  • Сначала докрути anti-link и flood, потом уже ужесточай punishment ladder.
  • Проверяй /stats и /stats7 после каждого заметного изменения правил.
  • Смотри на ложные срабатывания, чтобы защита не ломала живой чат.

FAQ

Частые рабочие вопросы

Бот не реагирует в группе. Что смотреть первым?

Проверь, что бот добавлен в чат, получил админ-права и сам чат появился в /panel.

Почему /panel не показывает нужный чат?

Обычно проблема в том, что бот ещё не увидел чат как доступный или ему не выданы нужные права.

Команда модерации не срабатывает.

Проверь права админа и формат вызова: часть команд ожидает reply на сообщение нарушителя.

Фильтры режут слишком жёстко.

Снизь чувствительность anti-link/flood и проверь статистику, прежде чем менять punishment на более жёсткий.

AI в группе молчит.

Проверь, разрешён ли AI-сценарий для этого чата и не упирается ли он в текущую конфигурацию или cooldown.

Next step

Дальше уже можно идти в живой чат

Открой бота, проверь /panel и запусти базовую защиту на практике.

Написать боту На главную