Integración domótica IMAP Mail, gratuita y de código abierto
Correos recibidos como desencadenantes, contadores de no leídos y un widget de últimos correos.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Convierta los correos que recibe en activadores de escena de Gladys: vigile hasta tres buzones IMAP, reaccione a un correo de un remitente, un dominio o una carpeta concretos, o cuyo asunto contenga una palabra clave, y pase a la escena su remitente, su asunto y un breve extracto. Cada buzón se convierte además en un dispositivo con su contador de no leídos, y un widget del panel lista los últimos correos.
Esta integración recibe correos. Para enviar correos desde Gladys, use la integración SMTP oficial (gladys-smtp).
Probado con un servidor de pruebas GreenMail, todavía no con todos los proveedores: sus comentarios son bienvenidos en las issues.
Qué hace la integración
- Tiempo real: la primera carpeta vigilada de cada buzón se sigue con IMAP IDLE, un correo nuevo dispara su activador en uno o dos segundos. Las demás carpetas, y los servidores sin IDLE, se comprueban con el intervalo elegido.
- Solo lectura: nada se envía, mueve, elimina ni marca como leído, salvo mediante la acción de escena «Marcar como leído» cuando una escena lo pide. Los correos se leen con
BODY.PEEK, que los deja sin leer. - Solo correos nuevos: en el primer inicio, los correos que ya están en el buzón no disparan nada. Tras un reinicio, los correos recibidos mientras tanto sí disparan (20 por carpeta como máximo, los más recientes).
- No se guarda nada: la integración solo almacena el número del último correo visto en cada carpeta, en
/data. Ni asunto, ni remitente, ni contenido.
Requisitos
- Gladys Assistant 5.1 o posterior.
- Una cuenta IMAP accesible desde Gladys: la dirección del servidor, el usuario (normalmente la dirección de correo) y la contraseña.
- Gmail, Outlook, iCloud, Yahoo: una contraseña de aplicación, creada en la configuración de seguridad de la cuenta (la verificación en dos pasos debe estar activada). Estos proveedores rechazan la contraseña habitual. El inicio de sesión OAuth2 no es compatible.
Configuración
En Integraciones → IMAP Mail → Configuración, rellene un bloque por buzón (hasta tres):
| Campo | Significado |
|---|---|
| Servidor IMAP | p. ej. imap.gmail.com, outlook.office365.com, imap.mail.me.com. Déjelo vacío para desactivar el bloque. |
| Puerto | 993 para TLS (por defecto), 143 para STARTTLS. |
| Seguridad | TLS o STARTTLS. Un servidor que no ofrece ninguno de los dos se rechaza: la contraseña nunca viaja en claro. |
| Usuario | Normalmente la dirección de correo completa. |
| Contraseña | La contraseña (de aplicación). Gladys la guarda como secreto, nunca se escribe en los registros. |
| Carpetas que vigilar | Separadas por comas, 5 como máximo, INBOX por defecto. La primera va en tiempo real. |
| Aceptar un certificado autofirmado | Solo para un servidor propio cuyo certificado haya creado usted mismo. |
Después, las opciones:
- Palabras clave del asunto: palabras separadas por comas (p. ej.
factura, paquete, alarma). Un correo cuyo asunto contenga una de ellas dispara «Palabra clave en el asunto de un correo». Se ignoran las mayúsculas y los acentos. - Pasar un breve extracto a las escenas: los primeros 200 caracteres del texto del correo (activado por defecto). Desactivado, solo el remitente y el asunto salen del servidor de correo.
- Comprobación completa cada: 1, 2 (por defecto), 5 o 15 minutos, para las demás carpetas y los contadores de no leídos.
- Idioma de los nombres y mensajes: francés por defecto.
Guarde y haga clic en Probar la conexión: una línea por buzón, con su número de no leídos o el motivo del fallo.
Proveedores
| Proveedor | Servidor | Puerto, seguridad |
|---|---|---|
| Gmail | imap.gmail.com | 993, TLS |
| Outlook.com | outlook.office365.com | 993, TLS |
| iCloud | imap.mail.me.com | 993, TLS |
| Yahoo | imap.mail.yahoo.com | 993, TLS |
| Orange | imap.orange.fr | 993, TLS |
| Free | imap.free.fr | 993, TLS |
Gmail presenta sus etiquetas como carpetas: [Gmail]/Spam, una etiqueta Alertas es la carpeta Alertas.
Dispositivos
En Integraciones → IMAP Mail → Descubrir, cada buzón configurado aparece como un dispositivo con el nombre de su dirección, con una característica: el número de correos no leídos en sus carpetas vigiladas. Añádalo a Gladys para verlo en el panel, representarlo en un gráfico o usarlo en una condición de escena («más de 10 no leídos»). Sigue los cambios hechos en otro lugar (un correo leído en su teléfono) dentro del intervalo de comprobación, al instante para la primera carpeta.
Activadores de escena
En una escena, elija Integraciones y luego uno de estos activadores. Un filtro vacío significa «cualquiera».
Correo recibido
Ha llegado un correo nuevo a una carpeta vigilada. Filtros: el buzón, la dirección del remitente (exacta, en minúsculas), el dominio del remitente (lo que sigue a la @, en minúsculas) y la carpeta (tal como está escrita en la configuración).
Palabra clave en el asunto de un correo
Un correo nuevo cuyo asunto contiene una de las palabras clave del asunto de la configuración. Filtros: el buzón, la palabra clave (escrita como en la configuración; vacía: cualquiera) y la dirección del remitente. Un asunto que contiene dos palabras clave dispara el activador dos veces, una por palabra clave.
Información transmitida a la escena
Ambos activadores transmiten: Buzón, Carpeta, Nombre del remitente, Dirección del remitente, Asunto, Extracto (vacío si está desactivado), Recibido el (hora local, 2026-10-14 08:05) y Referencia del correo (para la acción «Marcar como leído»). «Palabra clave en el asunto de un correo» añade la Palabra clave encontrada. Insértelas en un mensaje con el selector de variables.
Acciones de escena
Leer el número de no leídos
Pide al servidor, al instante, el número de correos no leídos de un buzón. Su resultado, «Correos no leídos», puede usarse en una condición o en un mensaje de las acciones siguientes.
Marcar como leído
Marca como leído el correo del activador. Elija el buzón y ponga la variable Referencia del correo del activador en el campo «Referencia del correo». Solo se toca ese correo; si el servidor ha reconstruido la carpeta mientras tanto, la acción falla en lugar de tocar otro correo. Resultado: «Marcado como leído».
Widget
Añada el widget Últimos correos a un panel: el contador de no leídos y los 8 últimos correos recibidos (remitente, asunto, hora; nunca el contenido). Elija un buzón en su configuración, o déjelo vacío para verlos todos. Un buzón que el servidor rechaza muestra una línea roja.
Ejemplos de escenas
- Paquete entregado: palabra clave
entregadoen la configuración; activador «Palabra clave en el asunto de un correo» (palabra claveentregado); acción «Enviar mensaje»: «📦 {{Asunto}} — {{Extracto}}». - Alarma por correo: activador «Correo recibido», dirección del remitente
[email protected]; acciones: encender la luz del recibidor, enviar una notificación con el asunto; luego «Marcar como leído» con la Referencia del correo. - Resumen matinal: activador «Cada día a las 7:30»; acción «Leer el número de no leídos»; condición «Correos no leídos» mayor que 0; mensaje «Tiene {{Correos no leídos}} correos no leídos».
Solución de problemas
- «inicio de sesión rechazado»: compruebe el usuario y la contraseña. Gmail, Outlook e iCloud necesitan una contraseña de aplicación. Tras una contraseña rechazada, la integración espera 30 minutos antes de volver a intentarlo (algunos proveedores bloquean la cuenta tras fallos repetidos): guarde la configuración para reintentar enseguida.
- «conexión segura imposible»: el puerto y la seguridad no coinciden (993 con TLS, 143 con STARTTLS), o el certificado es autofirmado: marque «Aceptar un certificado autofirmado» solo para un servidor propio.
- «el servidor de correo no responde»: dirección de servidor incorrecta, o Gladys no tiene acceso a Internet. La integración se reconecta sola, con una espera creciente de hasta 5 minutos.
- «Carpetas no encontradas»: el nombre de la carpeta debe ser el del servidor, con su carpeta padre (
Trabajo/AlertasoTrabajo.Alertassegún el servidor). - Ningún activador para un correo antiguo: es intencionado, solo disparan los correos que llegan después del primer inicio.
- Un correo movido a una carpeta vigilada cuenta allí como un correo nuevo.
- Registros detallados: defina la variable de entorno
LOG_LEVEL=debug; los remitentes y los asuntos aparecen entonces en los registros, nunca la contraseña.
Límites
- Tres buzones, cinco carpetas por buzón.
- Tiempo real solo en la primera carpeta; las demás siguen el intervalo de comprobación.
- Los filtros del editor de escenas comparan por igualdad: «el asunto contiene» pasa por las palabras clave de la configuración.
- Sin inicio de sesión OAuth2 (las cuentas de Gmail y Microsoft necesitan una contraseña de aplicación; algunas cuentas profesionales de Microsoft 365 las desactivan).
- Sin adjuntos, sin contenido más allá del extracto de 200 caracteres, sin envío (vea gladys-smtp).
- El servidor de correo es un servicio remoto: la integración depende de él y de la conexión a Internet.
Parámetros de configuración
Estos son los parámetros que IMAP Mail te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus buzones de correo | section | No | Hasta tres buzones IMAP. Gladys solo lee: no se envía, elimina ni marca nada como leído, salvo con la acción de escena «Marcar como leído». Gmail, Outlook e iCloud requieren una contraseña de aplicación. |
| Buzón 1 | section | No | Deje el servidor vacío para desactivar este buzón. |
| Servidor IMAP | string | No | |
| Puerto | number | No | 993 para TLS, 143 para STARTTLS. |
| Seguridad | select | No | |
| Usuario | string | No | |
| Contraseña | secret | No | La contraseña de aplicación para Gmail, Outlook o iCloud. |
| Carpetas que vigilar | string | No | Separadas por comas, 5 como máximo. La primera se vigila en tiempo real (IDLE). |
| Aceptar un certificado autofirmado | boolean | No | Solo para un servidor propio cuyo certificado creó usted mismo. |
| Buzón 2 | section | No | Deje el servidor vacío para desactivar este buzón. |
| Servidor IMAP | string | No | |
| Puerto | number | No | 993 para TLS, 143 para STARTTLS. |
| Seguridad | select | No | |
| Usuario | string | No | |
| Contraseña | secret | No | La contraseña de aplicación para Gmail, Outlook o iCloud. |
| Carpetas que vigilar | string | No | Separadas por comas, 5 como máximo. La primera se vigila en tiempo real (IDLE). |
| Aceptar un certificado autofirmado | boolean | No | Solo para un servidor propio cuyo certificado creó usted mismo. |
| Buzón 3 | section | No | Deje el servidor vacío para desactivar este buzón. |
| Servidor IMAP | string | No | |
| Puerto | number | No | 993 para TLS, 143 para STARTTLS. |
| Seguridad | select | No | |
| Usuario | string | No | |
| Contraseña | secret | No | La contraseña de aplicación para Gmail, Outlook o iCloud. |
| Carpetas que vigilar | string | No | Separadas por comas, 5 como máximo. La primera se vigila en tiempo real (IDLE). |
| Aceptar un certificado autofirmado | boolean | No | Solo para un servidor propio cuyo certificado creó usted mismo. |
| Opciones | section | No | |
| Palabras clave del asunto | string | No | Separadas por comas. Un correo cuyo asunto contenga una activa «Palabra clave en el asunto de un correo» (sin distinguir mayúsculas ni acentos). |
| Pasar un breve extracto a las escenas | boolean | No | Los primeros 200 caracteres del texto. Desactivado: solo el remitente y el asunto salen del servidor. |
| Comprobación completa cada | select | No | Las demás carpetas y los contadores de no leídos. La primera carpeta sigue en tiempo real. |
| Idioma de los nombres y mensajes | select | No | Se usa para el nombre del contador y los mensajes de las acciones. |
Cómo instalar IMAP Mail en Gladys
- En Gladys, abre Integraciones: IMAP Mail 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/guim31/gladys-imap:1.0.0), 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/guim31/gladys-imap.
IMAP Mail 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
IMAP Mail 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 guim31, 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