Документация Guapena Bot

Полное руководство по всем функциям бота. Узнайте, как настроить AI-ассистента, защиту группы, аналитику и многое другое.

Обзор

Guapena Bot — это AI-платформа для автоматизации и защиты Telegram-групп. Бот использует модель GPT-4o-mini для интеллектуальных ответов на вопросы пользователей, а также предоставляет мощную систему модерации, антиспам-фильтры и инструменты для создания контента.

💡
Ключевые преимущества:
  • Работа 24/7 без остановок
  • AI на базе GPT-4o-mini
  • Умная модерация и антиспам
  • Запуск за 5 минут
  • Гибкая настройка под любой бизнес

Архитектура: два бота

Система Guapena работает на основе двух взаимосвязанных ботов, каждый из которых выполняет свою роль:

⚙️

Админ-бот

Панель управления для владельца. Через этого бота вы настраиваете все параметры:

  • Настройка AI-режима и промптов
  • Управление базами знаний
  • Создание постов с кнопками
  • Настройка фильтров защиты
  • Просмотр статистики
  • Управление подключёнными чатами
💬

Рабочий бот

Бот, который работает непосредственно в вашей Telegram-группе:

  • Отвечает на вопросы пользователей
  • Фильтрует спам и рекламу
  • Модерирует чат
  • Отправляет запланированные посты
  • Защищает группу от нарушителей
  • Собирает аналитику

Быстрый старт

Запустите своего AI-бота за 4 простых шага:

1

Создайте ботов в @BotFather

Откройте @BotFather в Telegram и создайте двух ботов: один будет админ-панелью, второй — рабочим ботом для группы. Сохраните полученные токены.

2

Зарегистрируйтесь в @GuapenaBot

Перейдите в @GuapenaBot, введите токены обоих ботов и ваш Telegram username. Система автоматически свяжет ботов и настроит базовую конфигурацию.

3

Настройте бота через админ-панель

Откройте вашего админ-бота и настройте промпт AI, создайте базы знаний, включите нужные фильтры защиты и создайте посты с кнопками.

4

Активируйте бота в группе

Добавьте рабочего бота в вашу Telegram-группу, дайте ему права администратора, а затем активируйте чат через админ-панель. Готово!

🧠 AI-ответы

Рабочий бот использует модель GPT-4o-mini для генерации интеллектуальных, контекстных ответов на вопросы пользователей в вашей группе. AI работает круглосуточно и может обрабатывать сотни запросов одновременно.

Контекстные ответы

AI анализирует контекст вопроса и подбирает наиболее релевантную информацию из базы знаний для ответа.

Настраиваемое поведение

Через промпт вы определяете тон, стиль и область знаний бота — от техподдержки до продаж.

Автоматический выбор контекста

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

Работа 24/7

Бот отвечает мгновенно в любое время дня и ночи без перерывов и выходных.

⚙️ Режимы AI

Guapena Bot предоставляет несколько готовых режимов работы AI, каждый из которых оптимизирован для определённых сценариев:

🎓

Эксперт

Глубокие, профессиональные ответы на вопросы. Подходит для технических сообществ, образовательных чатов и экспертных группы.

🛎️

Поддержка

Вежливые, пошаговые ответы для клиентской поддержки. Идеален для бизнеса и сервисных групп.

💰

Продажи

Убедительные ответы с фокусом на конверсию. Подходит для коммерческих чатов и промо-групп.

✏️
Кастомный режим: Вы также можете написать полностью собственный промпт, определяющий поведение AI в соответствии с уникальными задачами вашего проекта.

📚 Базы знаний

Базы знаний — это ключевой инструмент для точных ответов AI. Вы загружаете информацию о вашем продукте, услуге или проекте, и бот использует её для генерации ответов.

Возможность Описание
Неограниченное количество Создавайте сколько угодно баз знаний для разных тем и продуктов
Привязка к постам Каждая база знаний может быть привязана к конкретному посту с кнопками
Умный поиск AI автоматически определяет, какая база знаний наиболее подходит для ответа на конкретный вопрос
Ключевые слова Настройте ключевые слова для каждой базы, чтобы бот точнее определял контекст
Редактирование Обновляйте базы знаний в любой момент через админ-панель

✏️ Настройка промптов

Промпт — это инструкция для AI, которая определяет его поведение, тон общения и область знаний. Правильно настроенный промпт — залог качественных ответов.

💡
Советы по написанию промпта:
  • Опишите роль бота (например, «Ты — консультант по криптовалютам»)
  • Укажите тон общения (дружелюбный, профессиональный, формальный)
  • Определите границы — на какие вопросы отвечать, а какие игнорировать
  • Добавьте примеры идеальных ответов
  • Укажите ссылки и CTA, которые бот должен упоминать

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

🧠 AI-антиспам

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

Режим «Удаление» Спам-сообщение удаляется, пользователь получает предупреждение
Режим «Бан» Пользователь мгновенно блокируется, сообщение удаляется
⚠️
Важно: AI-антиспам не влияет на сообщения администраторов группы. Все админы автоматически находятся в белом списке.

🛡️ Фильтр новичков

Усиленный контроль новых участников в первые часы после вступления в группу. Спамеры чаще всего действуют сразу после входа — этот фильтр нейтрализует их.

Период наблюдения Первые 2 часа после вступления (настраиваемый период)
Детекция токсичности AI анализирует первые сообщения новичка на предмет токсичного поведения
Мгновенный бан При обнаружении нарушения — автоматическая блокировка без задержки

🧯 Антифлуд

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

Умные алгоритмы

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

Система предупреждений

Варн-система: первое нарушение — предупреждение, повторное — мут или бан.

Гибкие наказания

Выбирайте между мутом на время, предупреждением или мгновенным баном.

Исключения

Администраторы и пользователи из белого списка не подвержены ограничениям.

🤬 Антимат

Обнаружение и удаление нецензурных выражений в чате. Система умеет распознавать замаскированные матерные слова (замена букв символами, пробелами и т.д.).

Режим 1 — Удаление Сообщение с матом удаляется, пользователь получает предупреждение
Режим 2 — Мут Пользователь отправляется в мут на настраиваемое время
Режим 3 — Бан Мгновенная блокировка нарушителя

Время мута настраивается индивидуально: от 5 минут до нескольких часов. Система также умеет детектировать маскировку мата (з@мена букв, р.а.з.д.е.л.е.н.и.е символами).

👑 Защита админов

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

AI-анализ

Нейросеть определяет оскорбительный контекст даже без прямых ругательств — сарказм, завуалированные оскорбления.

Точность ~70%

Алгоритм постоянно улучшается. Минимизирует ложные срабатывания при высоком уровне защиты.

Бан или мут

Выберите наказание для нарушителей: мут на время или полная блокировка в группе.

Лог нарушений

Все случаи оскорблений фиксируются в статистике для последующего анализа.

📨 Запрет пересылки

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

Тип источника Описание Настройка
Боты Пересылки от других ботов Telegram Вкл/Выкл
Каналы Пересылки из Telegram-каналов Вкл/Выкл
Группы Пересылки из других групп Вкл/Выкл
Пользователи Пересылки от других пользователей Вкл/Выкл

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

🗑️ Удаление служебных сообщений

Автоматическая очистка чата от технических уведомлений Telegram, которые засоряют ленту сообщений.

Вход/выход участников Удаление уведомлений «User присоединился» и «User покинул группу»
Смена настроек группы Удаление уведомлений об изменении фото, названия или описания группы
Закреплённые сообщения Удаление уведомлений о закреплении сообщений

Результат — чистый чат, где видны только реальные сообщения участников.

🔗 Посты с кнопками

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

До 10 кнопок

Каждый пост может содержать до 10 inline-кнопок с ссылками на любые ресурсы.

4 цветовые схемы

Выбирайте стиль кнопок из 4 доступных цветовых вариантов для визуального разнообразия.

Медиа-вложения

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

Привязка к базе знаний

Свяжите пост с базой знаний — AI будет отвечать на вопросы по теме поста автоматически.

📊 Статистика и аналитика

Подробная аналитика по активности в вашей группе. Отслеживайте рост, вовлечённость и эффективность бота.

Метрика Описание
Пользователи Общее количество участников, новые за период, вышедшие
Сообщения Количество сообщений от пользователей и ответов AI
Конверсия ссылок Сколько пользователей перешли по кнопкам в постах
Нарушения История заблокированных пользователей, удалённого спама и нарушений
Активность AI Количество обработанных вопросов и качество ответов

💬 Управление чатами

Через админ-панель вы управляете всеми подключёнными группами. Для каждой группы настройки фильтров и AI индивидуальны.

Подключение чатов

Добавьте рабочего бота в группу и активируйте чат через админ-панель одной кнопкой.

Индивидуальные настройки

Каждый чат может иметь свои фильтры, промпт AI и базы знаний.

Whitelist

Добавляйте доверенных пользователей в белый список — фильтры не будут к ним применяться.

Авторизация

Система авторизации чатов предотвращает несанкционированное использование бота.

💎 Тарифные планы

Guapena Bot предлагает гибкую систему тарифов для проектов любого масштаба. Начните бесплатно и масштабируйтесь по мере роста.

План Цена Чатов Сообщений/мес Особенности
Free $0 1 500 Все фильтры, AI-ответы, watermark
Starter $10/мес 5 5,000 Все фильтры, AI-ответы, без watermark
Pro $25/мес 10 15,000 Все фильтры, AI-ответы, приоритет поддержки
Business $50/мес 50 50,000 Все фильтры, AI-ответы, premium поддержка
Enterprise $100/мес 100,000+ Все фильтры, AI-ответы, VIP поддержка 24/7

💳 Оплата

Оплата тарифов производится в криптовалюте USDT по сети TRC-20. После оплаты тариф активируется автоматически.

💡
Как оплатить:
  1. Выберите тариф в админ-панели вашего бота
  2. Скопируйте адрес кошелька для оплаты (USDT TRC-20)
  3. Переведите точную сумму
  4. Тариф активируется автоматически после подтверждения транзакции

Готовы начать?

Создайте своего AI-бота прямо сейчас и автоматизируйте вашу Telegram-группу.

Создать бота