Outlook 365 — Connect

Outlook 365 — Connect

Tipo: outlook365-connect  ·  Paquete: Outlook 365 v1.0.4  ·  Salida: ZoanOutlookMailSession

Abre una sesión autenticada con Outlook 365 (Microsoft 365) a través de Microsoft Graph. Es el punto de partida del paquete: todas las demás actividades (enviar, buscar, responder, mover…) trabajan sobre esta sesión.

Cómo funciona

Se autentica con una conexión OAuth de Microsoft 365 de Zoan Cloud. Tiene dos formas de uso:

• Con body: las actividades que coloques dentro heredan la sesión automáticamente; al terminar el bloque (también si algo falla dentro), la sesión se cierra sola.
• Sin body: devuelve la sesión como salida; guárdala en una variable, pásala por session a las demás actividades y ciérrala con Outlook 365 — Close.

Al conectar:

1. Lee el token de acceso de la conexión. Si viene vacío, falla en el acto.
2. Si indicaste mailbox, la sesión trabaja sobre ese buzón. Intenta leer su dirección principal en Graph; si no puede (por ejemplo, porque la conexión no tiene permiso para leer usuarios), usa el valor de mailbox tal cual y continúa.
3. Sin mailbox, consulta el usuario de la conexión (/me) y trabaja sobre su buzón.

Connect no comprueba todavía que tengas acceso a los correos: si faltan permisos, el error aparece en la primera actividad que los use.

Autenticación y permisos

El tipo de autenticación (delegada o solo de aplicación) lo define la conexión OAuth de Microsoft 365. La aplicación de la conexión necesita los permisos de Microsoft Graph Mail.ReadWrite (leer, mover, marcar, categorizar, eliminar) y Mail.Send (enviar, responder, reenviar); para buzones compartidos con acceso delegado, sus variantes .Shared. Con acceso solo de aplicación (app-only) indica siempre mailbox, porque no hay un usuario «actual». A diferencia de Gmail, este paquete no usa cuentas de servicio.

El token se toma al conectar

La sesión usa el token que tenía la conexión en el momento de conectar. Zoan Cloud lo renueva para las conexiones siguientes, pero no dentro de una sesión ya abierta, y los tokens de Microsoft duran alrededor de una hora. Si un proceso mantiene la sesión abierta más tiempo, trabaja por lotes y vuelve a conectar en cada lote.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
credential	credential	—	Conexión OAuth de Microsoft 365 de Zoan Cloud. Elígela en el selector del Designer o escribe credential("nombre-clave") con su nombre clave.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
mailbox	string	—	Buzón sobre el que operar (correo o UPN, p. ej. facturacion@example.com). Obligatorio con acceso solo de aplicación o para buzones compartidos. Vacío = el buzón del usuario de la conexión.

Sub-flujos

body opcional

Actividades a ejecutar dentro de la sesión. Heredan la sesión automáticamente y, al terminar, esta se cierra.

Salida

Devuelve un ZoanOutlookMailSession solo si no usas body; con body la actividad no devuelve nada (la sesión se hereda sola). La sesión expone dos propiedades de lectura:

Propiedad	Tipo	Contenido
Email	string	Dirección del buzón conectado (la principal, si Graph la pudo leer).
UserKey	string	Identificador con el que se consulta el buzón en Graph: el mailbox indicado o el UPN del usuario de la conexión.

Errores comunes

Mensaje	Causa y solución
'credential' no contiene un access_token válido. Revisa la conexión OAuth de Microsoft 365 en Zoan Cloud.	La conexión no entregó token: está pendiente de autorizar o se revocó. Ábrela en Zoan Cloud y verifica que esté Conectada.
No se pudo resolver el usuario con sesión iniciada (/me). Para acceso solo de aplicación, indica el parámetro 'mailbox'.	Sin mailbox, Graph no devolvió el usuario actual: la conexión es solo de aplicación o el token no puede leer el perfil. Indica mailbox.
No se pudo resolver el usuario del buzón.	Graph respondió a /me sin UPN ni ID. Indica mailbox explícitamente.
Parameter 'credential' is of type 'credential' but the value was null. …	La conexión indicada no existe en el ambiente, o se usó el nombre legible en lugar del nombre clave.

Ejemplo

Outlook 365 — Connect   credential = credential("m365-soporte")
 └─ body:
      Outlook 365 — Get emails   folder = "inbox"   unreadOnly = true   → output: nuevos
      For each   correo in nuevos
       └─ Outlook 365 — Reply   id = correo["id"]   body = "Recibimos tu mensaje; te respondemos pronto."

Sin body, sobre un buzón compartido:

Outlook 365 — Connect   credential = credential("m365-soporte")   mailbox = "facturacion@example.com"   → output: buzon
Outlook 365 — Get emails   session = buzon   subject = "Factura"   → output: facturas
Outlook 365 — Close   session = buzon

Carpetas por nombre

Las actividades que reciben una carpeta aceptan los nombres conocidos de Graph (inbox, sentitems, drafts, deleteditems, archive, junkemail) o el ID de cualquier carpeta.

Actividades relacionadas

• Outlook 365 — Send — enviar un correo.
• Outlook 365 — Get emails — buscar correos.
• Outlook 365 — Close — cerrar la sesión (modo sin body).
• Todas las actividades de Outlook 365