Un bot de Telegram moderno y seguro para la gestión de suscripciones y servicios premium, con verificación automática de transacciones de criptomonedas.
- ✅ Gestión de Suscripciones: Sistema completo de suscripciones premium
- 🔐 Verificación de Transacciones: Soporte para BSC y TRON
- 🛡️ Seguridad Robusta: Validación de datos y autenticación segura
- 📊 Sistema de Textos: Textos personalizables sin tocar código
- 🌐 Arquitectura Moderna: Async/await, Docker, configuración flexible
- 📱 Interfaz Intuitiva: Menús interactivos y navegación fluida
- Framework: aiogram 3.x (async/await)
- Base de Datos: MySQL para persistencia de datos
- Validación: Pydantic para validación robusta
- Contenedores: Docker + Docker Compose
- Configuración: Variables de entorno flexibles
subscribe_bot/
├── app/
│ ├── config/ # Configuración y sistema de textos
│ ├── handlers/ # Handlers de comandos de Telegram
│ ├── keyboards/ # Teclados interactivos
│ └── main.py # Punto de entrada
├── texts/ # Sistema de textos personalizables
├── docs/ # Documentación completa
├── docker-compose.yml # Configuración con MySQL
└── requirements.txt # Dependencias
cp env.example .envEditar .env:
BOT_TOKEN=tu_token_de_telegram_aqui
ADMIN_USER_IDS=123456789,987654321
DEBUG=False# Construir y ejecutar todos los servicios
docker-compose up --build
# Ejecutar en segundo plano
docker-compose up -d- Busca tu bot en Telegram
- Envía
/start - Explora las opciones del menú
- 🚀 Inicio Rápido - Configuración y ejecución rápida
- 🔄 Flujo de la Aplicación - Diagramas y estructura de navegación
- ⚙️ Sistema de Configuración - Configuración flexible y Docker Compose
- 📝 Sistema de Textos - Personalización de textos sin código
/start- Iniciar el bot y mostrar menú principal- Navegación completa por menús interactivos
-
Menú Principal: 4 opciones principales
- 📋 Mi Suscripción
- 💳 Suscribirse
- ❓ Ayuda
- 📊 Consultar Planes
-
Gestión de Suscripciones: Submenú con opciones
- 🔍 Consultar estado
- 🔑 Ver credenciales
- 👥 Acceso al grupo VIP
- ✅ Sistema de textos personalizables
- ✅ Sistema de base de datos MySQL
- ✅ Configuración flexible con Docker Compose
- ✅ Teclados interactivos con navegación
- ✅ Logging estructurado
- ✅ Documentación completa
- Handlers: Manejan comandos y callbacks de Telegram
- Keyboards: Teclados interactivos y navegación
- Config: Sistema de configuración y textos
- Texts: Archivos JSON para personalización
-
Copia el archivo de ejemplo:
cp texts/custom_texts.example.json texts/custom_texts.json
-
Edita
texts/custom_texts.jsoncon tus textos -
Reinicia el bot para aplicar cambios
# Probar configuración
python test_bot.py
# Verificar imports
python test_imports.py- ✅ Configuración Segura: Variables de entorno para secrets
- ✅ Autenticación: Sistema seguro de usuarios y roles
- ✅ Validación de Datos: Con Pydantic
- ✅ Logging Estructurado: Para auditoría y debugging
- ✅ Textos Separados: Sin hardcodeo en el código
- Bot funcional con comando
/start - Sistema completo de gestión de suscripciones
- Teclados interactivos con navegación
- Sistema de textos personalizables
- Integración con MySQL
- Configuración flexible con Docker Compose
- Documentación completa
- Implementar verificación real de transacciones
- Integrar base de datos PostgreSQL
- Sistema de pagos automático
- Panel de administración
- Testing completo
- Configurar variables de entorno de producción
- Configurar webhook de Telegram (opcional)
- Desplegar con Docker Compose
- Monitorear logs
- MySQL para persistencia de datos
- Arquitectura async para mejor rendimiento
- Contenedores Docker para fácil escalado
- Configuración flexible para diferentes entornos
- Fork el proyecto
- Crear rama para feature (
git checkout -b feature/nueva-funcionalidad) - Commit cambios (
git commit -am 'Agregar nueva funcionalidad') - Push a la rama (
git push origin feature/nueva-funcionalidad) - Crear Pull Request
Este proyecto está bajo la Licencia MIT. Ver LICENSE para más detalles.
Para soporte y preguntas:
- Crear un issue en GitHub
- Revisar la documentación en
docs/ - Contactar al administrador del bot
Subscription Bot - Gestión moderna de suscripciones en Telegram 🚀