IMAP Read

Tipo: imap-read · Paquete: SMTP / IMAP Email Activities v1.0.0 · Salida: List

Lee correos de un servidor IMAP y devuelve una lista de mensajes (ZoanMail). Es el punto de partida de los procesos que reaccionan al correo entrante, con potentes filtros para traer solo lo que te interesa. Es la opción recomendada para leer correo (más completa que POP3).

Cómo funciona

Se conecta al servidor IMAP, abre la carpeta indicada (por defecto INBOX) y devuelve hasta limit correos que cumplan los filtros. Por defecto trae solo los no leídos (unreadOnly = true). Cada correo tiene .Id (su UID), .Subject, .From, .Body, .Attachments — ver ZoanMail.

Parámetros requeridos

Parámetro	Editor	Descripción
`host`	texto	Servidor IMAP (ej. `imap.gmail.com`).
`username`	texto	Usuario.
`password`	credencial	Contraseña o App Password. Usa `= credential(...)`.

Parámetros opcionales

Parámetro	Editor	Descripción
`port`	número	Puerto IMAP. Por defecto `993`.
`folder`	texto	Carpeta. Por defecto `INBOX`.
`unreadOnly`	booleano	Solo no leídos. Por defecto `true`.
`subject`	texto	Filtro: el asunto contiene este texto.
`from`	texto	Filtro: el remitente contiene este texto.
`since`	texto	Filtro: recibidos desde esta fecha (`YYYY-MM-DD`).
`before`	texto	Filtro: recibidos antes de esta fecha (`YYYY-MM-DD`).
`hasAttachments`	booleano	Filtro: solo correos con adjuntos.
`includeAttachments`	booleano	Descargar el contenido de los adjuntos en `.Attachments`. Por defecto `false`.
`limit`	número	Máximo de correos a devolver. Por defecto `10`.
`security`	lista	Cifrado: `auto` · `none` · `ssl` (def.) · `starttls`.

Salida

Devuelve una List de correos (ZoanMail). Recórrela con For Each.

Ejemplo

Leer los correos no leídos con “Pedido” en el asunto y procesarlos:

IMAP Read
  host     = "imap.gmail.com"
  username = = credential("bot")["user"]
  password = = credential("bot").ToPlainText()
  unreadOnly = true
  subject    = "Pedido"
  hasAttachments = true
  → output: correos

For Each   items = = correos   itemVariable = correo
 └─ activities:
      IMAP Save Attachment   host = "imap.gmail.com"   username = = credential("bot")["user"]   password = = credential("bot").ToPlainText()
                             mailId = = correo.Id   outputPath = "C:/pedidos"
      IMAP Mark Read   host = "imap.gmail.com"   username = = credential("bot")["user"]   password = = credential("bot").ToPlainText()   mailId = = correo.Id

Actividades relacionadas

IMAP Save Attachment — guardar adjuntos.
IMAP Mark Read / IMAP Move — gestionar los correos leídos.
Tipos de datos › ZoanMail — propiedades de cada correo.