SMTP / IMAP / POP3 Email Activities

Versión: 1.0.0  ·  ID: zoan-packages-smtp  ·  Autor: Zoan Software

Este paquete trabaja con correo electrónico conectándose directamente a un servidor, sin depender de un cliente instalado. Funciona con cualquier servidor estándar: Gmail, Outlook.com / Microsoft 365, o el servidor corporativo de tu empresa.

¿SMTP/IMAP o el paquete Outlook?

• Este paquete (SMTP/IMAP/POP3): se conecta al servidor con usuario y contraseña. No necesita Outlook instalado y funciona perfecto en ejecución desatendida (un servidor sin pantalla). Es la opción recomendada para bots de producción.
• El paquete Outlook: controla el cliente Outlook de escritorio ya configurado en la máquina. Útil si ya usas Outlook con cuentas configuradas y sesión interactiva.

Tres protocolos, tres usos

Protocolo	Para qué	Actividades
SMTP	Enviar correo	SMTP Send
IMAP	Leer y gestionar correo (carpetas, leído/no leído, mover, eliminar) — recomendado	IMAP Read, IMAP Save Attachment, IMAP Mark Read, IMAP Move, IMAP Delete
POP3	Leer de forma básica (sin carpetas ni estado) — solo si no hay IMAP	POP3 Read, POP3 Delete

IMAP vs POP3

Usa IMAP siempre que puedas: soporta carpetas, filtros, marcar como leído, mover y eliminar. POP3 es un protocolo antiguo y limitado (descarga los correos sin estado ni carpetas); úsalo solo si tu servidor no ofrece IMAP.

Conexión al servidor

Como estas actividades no mantienen una sesión, cada una recibe los datos de conexión del servidor. Son los mismos en todas:

Parámetro	Descripción
host	Servidor (ej. smtp.gmail.com, imap.gmail.com, pop.gmail.com)
port	Puerto. Por defecto: SMTP 587, IMAP 993, POP3 995
username	Usuario (normalmente tu dirección de correo completa)
password	Contraseña — usa una credencial, ver abajo
security	Cifrado: auto · none · ssl · starttls. Por defecto el adecuado a cada protocolo

Servidores comunes

Proveedor	SMTP (enviar)	IMAP (leer)
Gmail	smtp.gmail.com : 587	imap.gmail.com : 993
Outlook.com / M365	smtp.office365.com : 587	outlook.office365.com : 993

Gmail / Outlook: usa una “App Password”, no tu contraseña normal

Si la cuenta tiene verificación en dos pasos (lo habitual hoy), no funciona la contraseña normal: debes generar una “contraseña de aplicación” (App Password) en la configuración de seguridad de la cuenta y usar esa. Es una clave específica para aplicaciones como esta.

Seguridad: guarda la contraseña en una credencial

El campo password es de tipo credencial. Nunca escribas la contraseña en texto plano: guárdala en una credencial de Nexus y úsala con = credential("correo-bot").ToPlainText(). Así no queda expuesta en el playbook ni en los logs.

El flujo de lectura: mailId

Igual que en Outlook, IMAP Read (y POP3 Read) devuelven una lista de correos (ZoanMail). Cada correo tiene un identificador, su .Id (UID en IMAP, índice en POP3), que pasas como mailId a las demás actividades para indicar sobre qué correo actuar (guardar adjuntos, marcar, mover, eliminar).

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

For Each   items = = correos   itemVariable = correo
 └─ activities:
      IMAP Save Attachment   ...   mailId = = correo.Id   outputPath = "C:/adjuntos"
      IMAP Mark Read         ...   mailId = = correo.Id

Las propiedades de cada correo (.Subject, .From, .Body, .Attachments…) están en Tipos de datos › ZoanMail.

Actividades

Enviar (SMTP)

Actividad	Tipo	Salida	Qué hace
SMTP Send	smtp-send	—	Envía un correo

Leer y gestionar (IMAP)

Actividad	Tipo	Salida	Qué hace
IMAP Read	imap-read	List	Lee correos con filtros
IMAP Save Attachment	imap-save-attachment	—	Guarda adjuntos de un correo
IMAP Mark Read	imap-mark-read	—	Marca un correo como leído
IMAP Move	imap-move	—	Mueve un correo a otra carpeta
IMAP Delete	imap-delete	—	Elimina un correo

Leer básico (POP3)

Actividad	Tipo	Salida	Qué hace
POP3 Read	pop3-read	List	Lee correos (sin carpetas ni filtros)
POP3 Delete	pop3-delete	—	Elimina un correo

Siguientes pasos

• SMTP Send — enviar correos.
• IMAP Read — leer la bandeja con filtros.
• Uso de credenciales — guardar la contraseña de forma segura.