https://github.com/vgvr0/correos-tracking-bot
🚀 Bot de Telegram para seguimiento automático de envíos de Correos España con notificaciones en tiempo real
https://github.com/vgvr0/correos-tracking-bot
correos-api correos-spain python-telegram-bot seguimiento-envios shipping-api tracking-ships tracking-telegram-bot
Last synced: 8 months ago
JSON representation
🚀 Bot de Telegram para seguimiento automático de envíos de Correos España con notificaciones en tiempo real
- Host: GitHub
- URL: https://github.com/vgvr0/correos-tracking-bot
- Owner: vgvr0
- Created: 2024-10-29T22:03:28.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-28T00:28:05.000Z (over 1 year ago)
- Last Synced: 2025-03-21T02:18:12.815Z (about 1 year ago)
- Topics: correos-api, correos-spain, python-telegram-bot, seguimiento-envios, shipping-api, tracking-ships, tracking-telegram-bot
- Language: Python
- Homepage:
- Size: 293 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
📦 Correos Tracking Bot
Bot de Telegram para el seguimiento automático de envíos de Correos España con notificaciones en tiempo real.
## ✨ Características
- 🔄 **Seguimiento automático**: Monitorización continua de tus envíos
- 📱 **Notificaciones instantáneas**: Recibe alertas cuando hay actualizaciones
- 🎯 **Comandos intuitivos**: Interfaz fácil de usar mediante comandos de Telegram
- 📊 **Historial detallado**: Consulta el historial completo de cada envío
- 🔔 **Gestión automática**: Sugerencia de eliminación cuando el envío está entregado
- 💾 **Persistencia de datos**: Los seguimientos se mantienen entre reinicios
- 🔐 **Configuración segura**: Credenciales separadas del código principal
## 📁 Estructura del Proyecto
```plaintext
proyecto/
├── config.py # Configuración y constantes
├── correos_tracker.py # Código principal
├── .gitignore # Archivos a ignorar en git
├── tracking_data.pkl # Se creará automáticamente
└── __pycache__/ # Creado por Python
```
La estructura del proyecto es simple y modular:
- `config.py`: Almacena todas las configuraciones y credenciales
- `correos_tracker.py`: Contiene la lógica principal del bot
- `.gitignore`: Especifica qué archivos no deben incluirse en el control de versiones
- `tracking_data.pkl`: Archivo de datos generado automáticamente para persistencia
- `__pycache__/`: Directorio de cache de Python (generado automáticamente)
## 🚀 Instalación
1. Clona el repositorio:
```bash
git clone https://github.com/yourusername/correos-track-bot.git
cd correos-track-bot
```
2. Instala las dependencias:
```bash
pip install requests
```
3. Crea un archivo `config.py` con tus credenciales:
```python
TELEGRAM_BOT_TOKEN = "TU_BOT_TOKEN"
TELEGRAM_CHAT_ID = "TU_CHAT_ID"
CHECK_INTERVAL = 300
COMMAND_CHECK_INTERVAL = 1
CORREOS_API_URL = "https://api1.correos.es/digital-services/searchengines/api/v1/"
```
## 🔧 Configuración
### Crear un bot de Telegram:
1. Habla con [@BotFather](https://t.me/botfather) en Telegram
2. Usa el comando `/newbot` y sigue las instrucciones
3. Guarda el token que te proporciona
### Obtener el Chat ID:
1. Inicia un chat con tu bot
2. Envía cualquier mensaje
3. Visita: `https://api.telegram.org/bot/getUpdates`
4. Busca el número `chat_id` en la respuesta
## 💻 Uso
### Iniciar el bot:
```bash
python correos_tracker.py
```
### Comandos disponibles:
- `/add NUMERO` - Añade un envío al seguimiento
- `/status NUMERO` - Muestra el estado actual de un envío
- `/list` - Lista todos los envíos en seguimiento
- `/remove NUMERO` - Elimina un envío del seguimiento
- `/help` - Muestra la ayuda
## 📸 Capturas de pantalla
## 🛠️ Tecnologías utilizadas
- [Python](https://www.python.org/) - Lenguaje de programación
- [Telegram Bot API](https://core.telegram.org/bots/api) - API para bots de Telegram
- [Correos API](https://api1.correos.es) - API de seguimiento de Correos
- [Requests](https://docs.python-requests.org/) - Cliente HTTP para Python
## 🚀 Mejoras Futuras
- [ ] Añadir soporte para varios idiomas en las notificaciones
- [ ] Incluir autenticación de usuarios en Telegram
- [ ] Ampliar la funcionalidad con nuevas APIs de seguimiento
- [ ] Optimizar la frecuencia de chequeo para reducir el consumo de recursos
- [ ] Mejorar el manejo de errores para conexiones inestables
- [ ] Añadir pruebas unitarias para cada componente
- [ ] Crear un sistema de alertas basado en tiempo estimado de entrega
## 📝 Licencia
Este proyecto está bajo la Licencia MIT - ver el archivo [LICENSE](LICENSE) para más detalles.
## 🤝 Contribuir
Las contribuciones son bienvenidas. Por favor, abre primero un issue para discutir los cambios que te gustaría realizar.
1. Haz un Fork del proyecto
2. Crea tu rama de características (`git checkout -b feature/AmazingFeature`)
3. Haz commit de tus cambios (`git commit -m 'Add some AmazingFeature'`)
4. Haz Push a la rama (`git push origin feature/AmazingFeature`)
5. Abre un Pull Request
## ⭐ Muestra tu apoyo
Si este proyecto te ha resultado útil, considera darle una estrella ⭐️
## 📧 Contacto
Project Link: [https://github.com/vgvr0/correos-tracking-bot](https://github.com/vgvr0/correos-tracking-bot)