Saltar al contenido principal

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

Integración Mail and Packages para Gladys Assistant

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​

  1. Abre la pestaña Configuración de la integración.
  2. 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.
  3. Elige las carpetas que analizar: INBOX por defecto. Separa varias con comas, p. ej. INBOX, Compras.
  4. Desmarca si quieres los transportistas que nunca usas. Las tiendas o transportistas que faltan se añaden en Otros remitentes (direcciones o dominios).
  5. Guarda y pulsa Probar la conexión.
  6. En la pestaña Descubrimiento, añade los dispositivos que quieras.
ProveedorServidor IMAPPuertoSeguridadContraseña
Gmailimap.gmail.com993TLScontraseña de aplicación
iCloudimap.mail.me.com993TLScontraseña de aplicación
Yahooimap.mail.yahoo.com993TLScontraseñ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ámetroTipoObligatorioDescripción
Tu buzónsectionNoLa 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 IMAPstringSí
PuertonumberSí993 con TLS, 143 con STARTTLS.
SeguridadselectSí
UsuariostringSí
Contraseña (o contraseña de aplicación)secretSí
CarpetasstringSíCarpetas que analizar, separadas por comas (p. ej. INBOX, Compras). Las etiquetas de Gmail son carpetas.
Aceptar un certificado autofirmadobooleanNoSolo para un servidor de correo en tu propia red. Déjalo desactivado para un proveedor en línea.
TransportistassectionNoAparece un dispositivo por cada transportista marcado en la pestaña Descubrimiento, junto al dispositivo resumen «Correo y paquetes».
Transportistas que detectarmulti_selectNo
Otros remitentesstringNoTiendas o transportistas que faltan en la lista: direcciones o dominios, separados por comas. Se cuentan en «Otros remitentes».
AvanzadosectionNo
Intervalo de análisis (minutos)numberNo
Días de correos que leernumberNoUn paquete sigue «en tránsito» mientras sus correos sean más recientes que esto.
Idioma de los nombres de dispositivosselectNo
Zona horariastringNoDecide cuándo empieza «hoy». Vacío: la zona horaria del servidor Gladys.

Cómo instalar Mail and Packages en Gladys​

  1. En Gladys, abre Integraciones: Mail and Packages aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. 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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂