Microsoft 365 Outlook

Descripcion

Este modulo integra Microsoft Outlook mediante Microsoft Graph API. Operaciones disponibles:

• Listar correos: Lista correos de una carpeta especifica (inbox, sentitems, drafts, deleteditems) con filtros OData y opcion de solo no leidos.
• Buscar correos: Busca correos por texto libre en todo el buzon.
• Leer correo: Obtiene el contenido completo de un correo incluyendo cuerpo HTML, adjuntos, CC, BCC y conversationId. Opcion de marcar como leido.
• Enviar correo: Envia correos con soporte para HTML, CC, BCC, importancia, adjuntos (Base64) y guardado en Enviados.
• Eliminar correo: Elimina un correo por ID.
• Mover correo: Mueve un correo a otra carpeta.
• Obtener adjuntos: Obtiene la lista de adjuntos de un correo con contenido en Base64.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Microsoft OAuth configurada
operation	select	Si	Operacion a realizar

Sub-nodo Send Email

Parametro	Tipo	Requerido	Descripcion
to	string	Si	Destinatarios separados por coma
subject	string	Si	Asunto del correo
body	textarea	Si	Cuerpo del mensaje
cc	string	No	Destinatarios en copia
bcc	string	No	Destinatarios en copia oculta
isHtml	string	No	Si el cuerpo es HTML (default: true)
saveToSentItems	string	No	Guardar en Enviados (default: true)

Sub-nodo List Emails

Parametro	Tipo	Requerido	Descripcion
folder	select	No	Carpeta: inbox, sentitems, drafts, deleteditems (default: inbox)
top	string	No	Maximo de correos (default: 20)
filter	string	No	Filtro OData (ej: from/emailAddress/address eq ‘test@mail.com’)
unreadOnly	string	No	Solo no leidos (true/false)

Sub-nodo Read Email

Parametro	Tipo	Requerido	Descripcion
messageId	string	Si	ID del mensaje a leer
markAsRead	string	No	Marcar como leido (true/false)

Sub-nodo Search Emails

Parametro	Tipo	Requerido	Descripcion
searchText	string	Si	Texto a buscar
top	string	No	Maximo de resultados (default: 20)

Sub-nodo Delete Email

Parametro	Tipo	Requerido	Descripcion
messageId	string	Si	ID del mensaje a eliminar

Credenciales

Requiere credenciales de tipo Microsoft OAuth2 con:

• Scopes: Mail.ReadWrite, Mail.Send
• El modulo gestiona el refresh del token automaticamente

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "sendResult": {
      "success": true,
      "message": "Email enviado correctamente",
      "to": "destinatario@empresa.com",
      "subject": "Informe mensual",
      "sentAt": "2026-03-23T10:00:00Z"
    }
  },
  "_meta_": { "operation": "sendEmail", "microsoftService": "outlook" }
}

Ejemplo de Uso

Caso basico - Enviar correo HTML

{
  "credentials_id": "mi-cuenta-ms365",
  "operation": "sendEmail",
  "to": "cliente@empresa.com",
  "subject": "Resumen semanal",
  "body": "<h1>Resumen</h1><p>Adjunto el informe.</p>",
  "isHtml": "true"
}

API Utilizada

• Microsoft Graph API - Mail endpoints (/me/messages, /me/sendMail, /me/mailFolders)

Notas

• Los destinatarios se pueden pasar como string separado por comas o como array
• Los adjuntos se envian como fileAttachment con contenido en Base64
• Los correos se ordenan por fecha de recepcion descendente
• La busqueda utiliza $search de Microsoft Graph que busca en asunto, cuerpo y remitente
• Soporta continueOnError para continuar el flujo ante errores

Nodos Relacionados

• MS365 Calendar - Calendario de Microsoft 365
• MS365 Teams - Canales, mensajes y reuniones de Teams
• MS365 OneDrive - Archivos en OneDrive