Integración domótica Mail and Packages, gratuita y de código abierto

Paquetes y correo detectados en tu buzón (Correos, SEUR, UPS, Amazon…).
Mail and Packages lee las notificaciones de envío que llegan a tu buzón y le dice a Gladys qué paquetes están en camino, llegan hoy, esperan a ser recogidos, se han entregado o tienen una incidencia. Entiende 36 transportistas y tiendas (Correos, Correos Express, SEUR, MRW, GLS, DHL, UPS, FedEx, Amazon, Vinted…) en español, inglés, francés, alemán, italiano, neerlandés y polaco.
Privacidad
- El buzón se lee por IMAP, en solo lectura: no se mueve, marca, lee ni borra nada.
- Solo se descargan los correos de los transportistas activados; los demás solo se ven por su remitente y su asunto, y nunca se guardan.
- Nada sale de tu Gladys: ningún servicio de terceros, ninguna API de seguimiento.
- La integración guarda un pequeño archivo (
/data/state.json) con las notificaciones ya anunciadas a tus escenas, para que un reinicio nunca las dispare dos veces. Ningún contenido de correo, ninguna contraseña.
Configuración
- Abre la pestaña Configuración de la integración.
- Indica el servidor IMAP, el puerto y la seguridad de tu proveedor (ver tabla), y después tu usuario (normalmente tu dirección) y tu contraseña.
- Elige las carpetas que analizar:
INBOXpor defecto. Separa varias con comas, p. ej.INBOX, Compras. - Desmarca si quieres los transportistas que nunca usas. Las tiendas o transportistas que faltan se añaden en Otros remitentes (direcciones o dominios).
- Guarda y pulsa Probar la conexión.
- En la pestaña Descubrimiento, añade los dispositivos que quieras.
| Proveedor | Servidor IMAP | Puerto | Seguridad | Contraseña |
|---|---|---|---|---|
| Gmail | imap.gmail.com | 993 | TLS | contraseña de aplicación |
| iCloud | imap.mail.me.com | 993 | TLS | contraseña de aplicación |
| Yahoo | imap.mail.yahoo.com | 993 | TLS | contraseña de aplicación |
| Outlook / Hotmail | — | — | — | Microsoft ya no acepta contraseñas por IMAP: reenvía a otro buzón |
Consejo: crea un buzón solo para Gladys y reenvía a él los correos de tus transportistas.
Dispositivos
- Correo y paquetes: resumen de todos los transportistas — En tránsito, Llega hoy, Entregados hoy, Por recoger, Incidencias, Correo previsto hoy (USPS Informed Delivery) y Última actualización (texto).
- Paquetes – transportista: los mismos cinco contadores por transportista.
Escenas
Disparadores (categoría «Integraciones»): Paquete enviado, Paquete en
reparto, Paquete listo para recoger, Paquete entregado, Incidencia de
entrega, Correo postal previsto hoy. Se pueden filtrar por transportista;
variables: {{triggerEvent.data.carrier_name}}, tracking, tracking_url,
pickup_code, subject. Cada paso se dispara una sola vez.
Acciones: Analizar el buzón (paquetes) (lee ahora) y Obtener los
contadores de paquetes (inmediato, último análisis). Salidas:
arriving_today, in_transit, pickup, delivered, exception, mail,
expected_today y summary (frase lista para enviar).
Widgets del panel
- Paquetes de hoy: contadores, estado del buzón, último análisis y botón Analizar ahora.
- Seguimiento: paquetes en camino con número de seguimiento, código de recogida y enlace a la página del transportista.
Solución de problemas
- Usuario o contraseña rechazados: Gmail, iCloud y Yahoo exigen una contraseña de aplicación.
- La carpeta no existe: respeta mayúsculas y minúsculas.
- Un paquete no se detecta: indica el remitente y el asunto en GitHub.
Documentación completa: English.
Parámetros de configuración
Estos son los parámetros que Mail and Packages te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Tu buzón | section | No | La integración lee las notificaciones de envío de tu buzón por IMAP, en solo lectura: no mueve, marca ni borra nada. Gmail, iCloud, Yahoo y Outlook exigen una contraseña de aplicación, no tu contraseña habitual. También sirve un buzón dedicado al que reenvíes tus correos de envío. |
| Servidor IMAP | string | Sí | |
| Puerto | number | Sí | 993 con TLS, 143 con STARTTLS. |
| Seguridad | select | Sí | |
| Usuario | string | Sí | |
| Contraseña (o contraseña de aplicación) | secret | Sí | |
| Carpetas | string | Sí | Carpetas que analizar, separadas por comas (p. ej. INBOX, Compras). Las etiquetas de Gmail son carpetas. |
| Aceptar un certificado autofirmado | boolean | No | Solo para un servidor de correo en tu propia red. Déjalo desactivado para un proveedor en línea. |
| Transportistas | section | No | Aparece un dispositivo por cada transportista marcado en la pestaña Descubrimiento, junto al dispositivo resumen «Correo y paquetes». |
| Transportistas que detectar | multi_select | No | |
| Otros remitentes | string | No | Tiendas o transportistas que faltan en la lista: direcciones o dominios, separados por comas. Se cuentan en «Otros remitentes». |
| Avanzado | section | No | |
| Intervalo de análisis (minutos) | number | No | |
| Días de correos que leer | number | No | Un paquete sigue «en tránsito» mientras sus correos sean más recientes que esto. |
| Idioma de los nombres de dispositivos | select | No | |
| Zona horaria | string | No | Decide cuándo empieza «hoy». Vacío: la zona horaria del servidor Gladys. |
Cómo instalar Mail and Packages en Gladys
- En Gladys, abre Integraciones: Mail and Packages aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/gboulvin/gladys-mail-and-packages:1.0.2), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/gboulvin/Gladys-Mail-and-Packages.
Mail and Packages requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Mail and Packages es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene gboulvin, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación