OutlookCalendarWebhook

Este componente en el sistema de automatización Nappai te permite conectar tu calendario de Microsoft Outlook a tus flujos de trabajo. Su función principal es actuar como un “escuchador” que detecta automáticamente cuándo se crea, actualiza o elimina un evento en tu calendario de Outlook. Al recibir estos cambios, el componente los transforma en datos estructurados que pueden ser usados por otros nodos para realizar acciones automatizadas.

¿Cómo funciona?

El componente funciona en tres pasos principales:

1. Monitoreo del Calendario: Al iniciar, el componente se conecta a tu cuenta de Outlook mediante la API de Microsoft Graph. Utiliza el calendario seleccionado para estar atento a cualquier modificación.
2. Recopilación de Datos: Cuando ocurre un cambio en el calendario (como una nueva reunión programada o una modificación de horario), el componente recibe esa información en formato crudo.
3. Transformación y Salida: El componente procesa estos datos crudos, los limpia y los organiza en un formato fácil de entender. Genera un objeto de salida que incluye un resumen legible (por ejemplo, “Se ha creado el evento: Reunión con el equipo”) y una estructura de datos detallada con toda la información relevante del evento.

Si no hay eventos nuevos o datos válidos, el componente te informará mediante un mensaje como “No new events” para mantener tu flujo organizado.

Conexión y Credenciales

Este componente requiere una configuración previa para comunicarse de forma segura con tu calendario de Outlook.

Para utilizarlo correctamente, debes seguir estos pasos:

1. Dirígete a la sección de Credenciales en tu panel de Nappai.
2. Crea una nueva credencial del tipo Microsoft Outlook.
3. Guarda los campos requeridos en la credencial (Client ID, Client Secret, Tenant ID, Microsoft Outlook Access).
4. Vuelve a tu flujo de trabajo y, en el campo Credential de este componente, selecciona la credencial que acabas de guardar.

Sin una credencial válida, el componente no podrá acceder a los datos de tu calendario.

Entradas

A continuación se detallan los campos disponibles para configurar el comportamiento del componente:

• Calendar: Permite seleccionar el calendario específico de Outlook que deseas monitorear para detectar cambios. Este campo puede actualizar la lista de calendarios disponibles dinámicamente.

  • Visible en: Ninguna operación (Componente global)

• Events: Define los tipos de eventos del calendario que el componente debe escuchar y procesar. Si no seleccionas nada explícitamente, el sistema escuchará todos los tipos de eventos por defecto. Las opciones incluyen:

  • Event Created: Un nuevo evento se crea en el calendario.
  • Event Updated: Un evento existente es modificado.
  • Event Deleted: Un evento es cancelado o eliminado.
  • Visible en: Ninguna operación (Componente global)

Salidas

El componente genera una salida estructurada que puede ser conectada a otros nodos para continuar la automatización.

• Data: Produce un objeto de datos que contiene un texto descriptivo legible y un diccionario con la información completa del evento procesado. Esta salida es ideal para alimentar agentes, bases de datos o sistemas de notificación.

Ejemplo de Respuesta JSON

El siguiente es un ejemplo de cómo se estructura la información de salida cuando se detecta un evento: json { “subject”: “Reunión de equipo semanal”, “eventId”: “AAMkAG…”, “start”: “2023-11-15T10:00:00”, “end”: “2023-11-15T11:00:00”, “status”: “confirmed”, “organizer”: “usuario@nappai.com” }

Conectividad

Este componente actúa como un origen de datos basado en eventos. Sus salidas están diseñadas para conectarse lógicamente a nodos downstream (siguientes pasos en el flujo) que requieran información sobre cambios en el calendario. Por ejemplo:

• Agentes de IA: Para tomar decisiones basadas en cambios de agenda.
• Nodos de Almacenamiento: Para guardar un historial de cambios en una base de datos.
• Nodos de Notificación: Para enviar alertas o recordatorios al usuario.

Ejemplo de Uso

Imagina que quieres automatizar la creación de reuniones en tu calendario. Puedes configurar este componente para que escuche cuando se crea un evento específico. Cuando un usuario o sistema externo crea una reunión en Outlook, el componente captura el evento, extrae el sujeto y la hora, y envía estos datos a otro nodo que podría generar un informe o notificar al responsable.

Consejos y Mejores Prácticas

• Utiliza el botón de actualización en el campo Calendar si no ves los calendarios esperados; esto fuerza al sistema a obtener la lista más reciente desde Outlook.
• Asegúrate de que el flujo de trabajo que consume la salida de este componente esté preparado para recibir datos estructurados (JSON) para evitar errores.
• Revisa las credenciales regularmente para garantizar que la autenticación con Microsoft Graph siga siendo válida.

Consideraciones de Seguridad

• Asegúrate de configurar la credencial de Microsoft Outlook en un entorno seguro dentro de Nappai.
• Evita compartir credenciales públicas; utiliza las herramientas de gestión de credenciales proporcionadas por el sistema.
• El componente maneja la autenticación mediante tokens, por lo que no es necesario almacenar contraseñas directamente en los flujos.