Outlook Activities

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

El paquete Outlook automatiza Microsoft Outlook de escritorio: enviar correos, leer la bandeja de entrada, descargar adjuntos, mover mensajes entre carpetas, responder y eliminar. Es ideal para procesos basados en correo: leer pedidos que llegan por email, descargar facturas adjuntas, enviar notificaciones, clasificar mensajes.

Requiere Outlook instalado y configurado

Estas actividades controlan el cliente Outlook de escritorio (vía COM) usando las cuentas que ya tiene configuradas en la máquina. Por tanto, en el equipo donde se ejecute el bot:

• Microsoft Outlook debe estar instalado e iniciada al menos una cuenta.
• Suele necesitar una sesión de usuario activa (modo atendido o un agente con sesión interactiva).

Si necesitas enviar/leer correo sin Outlook (por servidor SMTP/IMAP genérico), usa el paquete SMTP/IMAP.

La cuenta y la sesión (opcional)

La mayoría de las actividades funcionan directamente, sin pasos previos: usan la cuenta por defecto de Outlook. Por ejemplo, puedes poner un Outlook Get Emails solo y leerá tu Bandeja de entrada.

Si necesitas usar una cuenta concreta (no la predeterminada) o hacer varias operaciones seguidas de forma eficiente, abre una sesión con Outlook Connect:

Outlook Connect   account = "soporte@empresa.com"
 └─ body:
      Outlook Get Emails   folder = "Inbox"   → output: correos
      ... procesar ...

Dentro del body, las actividades heredan la sesión (y su cuenta) automáticamente, y se cierra sola al terminar. Sin body, Outlook Connect devuelve la sesión como variable y la cierras con Outlook Close.

El flujo con EntryID

El patrón central de este paquete: Outlook Get Emails devuelve una lista de correos (ZoanMail). Cada correo tiene un identificador único, su EntryID, accesible como .Id. Las demás actividades (guardar adjuntos, mover, marcar, eliminar, responder) reciben ese entryId para saber sobre qué correo actuar.

Outlook Get Emails   folder = "Inbox"   unreadOnly = true   → output: correos
For Each   items = = correos   itemVariable = correo
 └─ activities:
      Outlook Get Attachments   entryId = = correo.Id   outputDir = "C:/adjuntos"   → output: archivos
      Outlook Mark Read         entryId = = correo.Id
      Outlook Move Email        entryId = = correo.Id   targetFolder = "Inbox/Procesados"

Las propiedades de cada correo (.Subject, .From, .Body, .Attachments, .IsRead…) se documentan en Tipos de datos › ZoanMail.

Actividades

Sesión (opcional)

Actividad	Tipo	Salida	Qué hace
Outlook Connect	outlook-connect	ZoanOutlookSession	Abre una sesión (cuenta específica / varias operaciones)
Outlook Close	outlook-close	—	Cierra una sesión abierta

Enviar y responder

Actividad	Tipo	Salida	Qué hace
Outlook Send Email	outlook-send	—	Envía un correo
Outlook Reply	outlook-reply	—	Responde a un correo

Leer

Actividad	Tipo	Salida	Qué hace
Outlook Get Emails	outlook-get-emails	List	Lee correos de una carpeta
Outlook Get Attachments	outlook-get-attachments	List	Guarda los adjuntos de un correo

Organizar

Actividad	Tipo	Salida	Qué hace
Outlook Mark Read	outlook-mark-read	—	Marca un correo como leído/no leído
Outlook Move Email	outlook-move-email	—	Mueve un correo a otra carpeta
Outlook Delete Email	outlook-delete-email	—	Envía un correo a Elementos eliminados

Siguientes pasos

• Outlook Get Emails — leer la bandeja.
• Outlook Send Email — enviar correos.
• Tipos de datos › ZoanMail — las propiedades de un correo.
• SMTP/IMAP — alternativa sin Outlook instalado.