Microsoft 365 Calendar

Descripción

Este modulo integra Microsoft Outlook Calendar mediante Microsoft Graph API. Ofrece las siguientes operaciones:

• Listar calendarios: Obtiene todos los calendarios del usuario.
• Listar eventos: Lista eventos con filtros de fecha y paginación. Devuelve información completa incluyendo asistentes, ubicación y enlaces a reuniones online.
• Obtener evento: Recupera detalles completos de un evento especifico, incluyendo recurrencia, importancia y sensibilidad.
• Crear evento: Crea eventos con soporte para asistentes, ubicación, recordatorios, importancia y reuniones online de Teams.
• Actualizar evento: Modifica campos parciales de un evento existente.
• Eliminar evento: Elimina un evento por ID.
• Responder a evento: Acepta, rechaza o responde tentativamente a una invitación.
• Buscar disponibilidad: Encuentra horarios libres entre múltiples asistentes.

La operación se determina automáticamente por el sub-nodo utilizado. Utiliza OAuth2 con Microsoft Graph mediante microsoftOAuthService.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Microsoft OAuth configurada
operation	select	Si	Operación a realizar

Sub-nodo List Events

Parámetro	Tipo	Requerido	Descripción
startDateTime	string	No	Fecha inicio ISO 8601
endDateTime	string	No	Fecha fin ISO 8601
top	string	No	Máximo de eventos (default: 50)
outputKey	string	No	Clave de salida (default: events)

Sub-nodo Create Event

Parámetro	Tipo	Requerido	Descripción
subject	string	Si	Título del evento
startDateTime	string	Si	Fecha/hora inicio ISO 8601
endDateTime	string	Si	Fecha/hora fin ISO 8601
body	string	No	Descripción del evento
timeZone	string	No	Zona horaria (default: UTC)
location	string	No	Ubicación del evento
attendees	string	No	Emails separados por coma
isAllDay	string	No	Evento de dia completo (true/false)
reminderMinutes	string	No	Minutos antes para recordatorio
isOnlineMeeting	string	No	Crear reunion Teams (true/false)

Sub-nodo Update Event

Parámetro	Tipo	Requerido	Descripción
eventId	string	Si	ID del evento a actualizar
subject	string	No	Nuevo título
body	string	No	Nueva descripción
startDateTime	string	No	Nueva fecha inicio
endDateTime	string	No	Nueva fecha fin
location	string	No	Nueva ubicación

Sub-nodo Delete Event / Get Event

Parámetro	Tipo	Requerido	Descripción
eventId	string	Si	ID del evento

Credenciales

Requiere credenciales de tipo Microsoft OAuth2. Se necesitan:

• Client ID y Client Secret de Azure AD App Registration
• Scopes: Calendars.ReadWrite
• El modulo gestiona el refresh del token automáticamente

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "events": [
      {
        "id": "AAMkAD...",
        "subject": "Reunion de equipo",
        "start": "2026-03-25T10:00:00",
        "end": "2026-03-25T11:00:00",
        "location": "Sala A",
        "isAllDay": false,
        "organizer": "usuario@empresa.com",
        "attendees": [{ "email": "asistente@empresa.com", "name": "Asistente", "status": "accepted", "type": "required" }],
        "webLink": "https://outlook.office365.com/...",
        "onlineMeetingUrl": "https://teams.microsoft.com/l/meetup-join/..."
      }
    ]
  },
  "_meta_": { "operation": "listEvents", "microsoftService": "calendar" }
}

Ejemplo de Uso

Caso básico - Crear evento con reunion Teams

{
  "credentials_id": "mi-cuenta-ms365",
  "operation": "createEvent",
  "subject": "Standup diario",
  "startDateTime": "2026-03-25T09:00:00",
  "endDateTime": "2026-03-25T09:15:00",
  "timeZone": "Europe/Madrid",
  "isOnlineMeeting": "true",
  "attendees": "dev1@empresa.com,dev2@empresa.com"
}

API Utilizada

• Microsoft Graph API - Calendar endpoints (/me/calendar/events, /me/calendars, /me/findMeetingTimes)

Notas

• Los asistentes se pueden pasar como string separado por comas o como array
• La operación findMeetingTimes usa duración en formato ISO 8601 (ej: PT1H para 1 hora)
• Se registra auditoria OAuth por cada operación y también en caso de error
• Soporta continueOnError para que el flujo no se detenga ante errores

Nodos Relacionados

• MS365 Outlook - Correo electronico con Microsoft Outlook
• MS365 Teams - Canales, mensajes y reuniones de Teams
• MS365 Excel - Archivos Excel en OneDrive