bongram 0.1.0

Фреймворк для мгновенного создания Telegram-ботов на готовых шаблонах

Bongram

Bongram — фреймворк для мгновенного создания Telegram-ботов на готовых шаблонах. Экономьте часы разработки: магазин, поддержка, рассылка или опрос — соберите бота из модулей за минуты. Поддержка платежей, админки, аналитики и кастомизации из коробки. Python-стиль, документация и примеры. Создавайте, а не кодируйте повторно!

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

Установка

pip install bongram

Запуск бота за 5 минут

bongram support YOUR_BOT_TOKEN
bongram faq YOUR_BOT_TOKEN
bongram giveaway YOUR_BOT_TOKEN

Где YOUR_BOT_TOKEN — токен вашего бота от @BotFather.

📦 Доступные шаблоны

Support (Поддержка)

Бот для обработки вопросов пользователей с админ-панелью.

Возможности:

• Пользователи могут задавать вопросы через кнопку
• Администраторы получают уведомления о новых вопросах
• Ответы администраторов автоматически отправляются пользователям
• Управление администраторами через команды

Команды для пользователей:

• /start — начать работу с ботом

Команды для администраторов:

• /admin — открыть админ-панель
• /addadmin <user_id> — добавить администратора

FAQ (База знаний)

Бот с часто задаваемыми вопросами и поиском по базе знаний.

Возможности:

• Категории вопросов и ответов
• Поиск по базе знаний
• Админ-панель для управления вопросами
• Добавление, редактирование и удаление вопросов
• Статистика по категориям

Команды для пользователей:

• /start — открыть меню категорий
• /search <запрос> — поиск по базе знаний

Команды для администраторов:

• /addadmin <user_id> — добавить администратора
• Админ-панель доступна через меню

Giveaway (Розыгрыши)

Бот для проведения розыгрышей и конкурсов.

Возможности:

• Создание розыгрышей с настраиваемым количеством победителей
• Регистрация участников
• Автоматическое определение победителей
• Таймер до окончания розыгрыша
• Статистика и управление розыгрышами

Команды для пользователей:

• /start — просмотр активных розыгрышей

Команды для администраторов:

• /create — создать новый розыгрыш
• /addadmin <user_id> — добавить администратора

Настройка администраторов: После первого запуска используйте команду /addadmin <ваш_user_id> в боте, чтобы добавить себя в администраторы. Ваш user_id можно узнать у бота @userinfobot.

📝 Примеры использования

Запуск бота поддержки

bongram support 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

Запуск FAQ бота

bongram faq 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

Запуск бота розыгрышей

bongram giveaway 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

🛠 Разработка

Установка для разработки

git clone https://github.com/THWEDOKA/bongram.git
cd bongram
pip install -e .

👨‍💻 Автор

Triazov Kirill

• 🌐 Сайт: triazov.ru
• 💻 GitHub: @THWEDOKA

📄 Лицензия

MIT License

🤝 Вклад в проект

Мы приветствуем вклад в развитие Bongram! Создавайте issues и pull requests.

📞 Поддержка

Если у вас возникли вопросы или проблемы:

• Создайте issue в репозитории
• Напишите на triazov.ru