📚 Документация Ботя AI Assistant

Полное руководство по использованию всех возможностей бота

🚀 Начало работы

Добавление бота в группу

  1. Найдите @botyaai в Telegram
  2. Нажмите "Добавить в группу"
  3. Выберите вашу группу
  4. Дайте боту права администратора

💡 Совет: Для полной функциональности боту требуются права администратора с возможностью управления пользователями и сообщениями.

Первая настройка

После добавления бота используйте команду /settings для начальной настройки.

⚡ Команды

Для всех пользователей

/help

Показать список всех доступных команд

Пример: /help

/profile [@username]

Посмотреть профиль пользователя

Пример: /profile @username

/mystats

Ваша личная статистика

Показывает: сообщения, предупреждения, репутацию

/top [число]

Топ активных пользователей

Пример: /top 10

/aifun [текст]

Общение с AI-ассистентом

Пример: /aifun расскажи анекдот

Для администраторов

/ban @username [причина]

Забанить пользователя

Пример: /ban @spammer Спам в чате

/mute @username [время] [причина]

Замутить пользователя

Пример: /mute @user 1h Флуд

/warn @username [причина]

Выдать предупреждение

Пример: /warn @user Мат в чате

/login

Получить ссылку для входа в веб-панель

Доступ к полному функционалу

📅 Умные автопосты

Создание через естественный язык

Просто опишите что хотите, и AI настроит всё сам!

/autopost пости новости с варшавы каждые 5 часов
/autopost музыка из топ чартов раз в день
/autopost фото котиков каждые 3 часа

Как это работает

  1. AI анализирует ваш запрос (тема, локация, интервал)
  2. Находит источник (RSS, новостные сайты)
  3. Настраивает расписание
  4. Запускает автопост

✨ AI обработка: Каждый пост автоматически переписывается AI для уникальности и генерируются релевантные хэштеги.

Управление

/autopost list - список автопостов
/autopost stop  - остановить
/autopost start  - запустить
/autopost delete  - удалить

Источники контента

  • 🌐 URL - Веб-сайты и блоги
  • 📡 RSS - Новостные ленты
  • ✈️ Telegram - Другие каналы
  • ▶️ YouTube - Видео-каналы

🛡️ AI Модерация

Автоматическая защита

Бот использует Google Gemini 2.0 для анализа сообщений на:

  • Спам и флуд
  • Токсичность и оскорбления
  • Запрещённые слова
  • Подозрительные ссылки
  • Рейды и массовые нарушения

Настройка в админ-панели

Войдите через /login и перейдите в раздел "Модерация":

  • Уровень чувствительности
  • Автоматические действия (предупреждение/мут/бан)
  • Белый список пользователей
  • Настройка фильтров

⚠️ Важно: AI может ошибаться. Регулярно проверяйте логи модерации в админ-панели.

🤖 AI Функции

Стили общения

AI поддерживает два стиля:

  • Ассистент - Вежливый и полезный
  • Дерзкий - С юмором и сарказмом

Переключение: Настройки профиля в веб-панели

Обучение

AI запоминает:

  • Ваши предпочтения
  • Любимые темы
  • Стиль общения

Лимиты

  • Бесплатно: 10 сообщений/день
  • Premium: Безлимит

⚙️ Веб-панель администратора

Доступ

  1. В боте: /login
  2. Перейдите по полученной ссылке
  3. Автоматический вход

Разделы

Dashboard

Общая статистика чата и активность

Чаты

Управление всеми подключёнными чатами

Модерация

Настройки AI-модерации и логи

Автопосты

Создание и управление автопостами

Аналитика

Детальная статистика и графики

Пользователи

База пользователей и их активность

🔌 API

Endpoints

Автопосты

GET /api/autoposts - Все автопосты
POST /api/autoposts - Создать автопост
PUT /api/autoposts/:id - Обновить
DELETE /api/autoposts/:id - Удалить
PATCH /api/autoposts/:id/toggle - Вкл/Выкл

AI Ассистент

POST /api/assistant/chat - Диалог с AI
POST /api/assistant/quick - Быстрый ответ
GET /api/assistant/faq - Список FAQ

🔒 Авторизация: Все API запросы требуют действующую сессию. Войдите через /login.

Нужна помощь? Задайте вопрос AI-ассистенту в правом нижнем углу! 💬