OneDriveWebhook

En el sistema Nappai, este componente te permite mantener un “ojo vigilante” sobre tus archivos en OneDrive. Su propósito es detectar automáticamente cuando algo cambia en una carpeta de tu almacenamiento en la nube y enviar esa información a tu flujo de automatización, permitiéndote reaccionar al instante a nuevas novedades sin intervención manual.

¿Cómo funciona?

Este componente actúa como un puente seguro entre OneDrive y Nappai. Internamente, se conecta periódicamente a la API de Microsoft Graph para sondear tu almacenamiento en la nube, buscando similitud con revisar una bandeja de entrada de manera continua.

Cuando detecta un cambio (como agregar, modificar o eliminar un archivo), el componente captura la información clave del evento y la estructura de forma limpia. Esta información se entrega lista para ser usada por los pasos siguientes de tu automatización. De esta manera, Nappai puede ejecutar acciones específicas basadas en el estado actual de tus archivos, garantizando que tu flujo de trabajo responda de manera rápida y precisa a los cambios en tu OneDrive.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio de OneDrive:

Dirígete a la sección de Credenciales en tu panel de Nappai.
Crea una nueva credencial del tipo Microsoft One Drive y guarda los campos requeridos (Client ID, Client Secret, Tenant ID, etc.).
En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Los siguientes campos están disponibles para configurar este componente:

Watch Folder: Selecciona la carpeta de OneDrive específica que deseas monitorizar para detectar cambios. Si no seleccionas ninguna carpeta, el componente monitoreará toda la unidad de OneDrive.
Events: Define qué tipo de cambios de archivos quieres que este componente procese. Puedes seleccionar opciones como File Added (se crea un archivo), File Modified (se actualiza un archivo) o File Deleted (se elimina un archivo). Si no seleccionas nada, se asume por defecto que se procesarán todos los eventos disponibles.

Salidas

Al ejecutarse, este componente produce una salida llamada Data que contiene la información estructurada de los cambios detectados. Esta salida incluye detalles como el tipo de evento, el ID del archivo, el nombre del archivo, el tipo de documento y la hora de la modificación. Puedes conectar esta salida a otros componentes que necesiten leer nombres de archivos, identificar cambios específicos o ejecutar acciones condicionales basadas en el evento.

Ejemplo de Respuesta JSONjson

{ “event”: “modified”, “fileId”: “01ABCDEFGHIJKLMNOPQRSTUVWXYZ123456”, “fileName”: “Presupuesto_2024.xlsx”, “mimeType”: “application/vnd.openxmlformats-officedocument.spreadsheetml.sheet”, “modifiedTime”: “2024-05-22T14:30:00Z” }

Conectividad

Este componente es ideal para iniciar flujos de trabajo que dependan de archivos en la nube. Lógicamente, se conecta a salidas de otros nodos que requieren procesar metadatos de archivos, como componentes de “Procesar Archivo”, “Enviar Notificación”, “Guardar en Base de Datos” o “Ejecutar Modelo de IA”. También puede recibir datos previos si necesitas filtrar cambios basados en una condición inicial definida por otros componentes.

Ejemplo de Uso

Imagina que necesitas automatizar la revisión de contratos cuando se suben al sistema. Conecta este componente a la carpeta “Contratos” en OneDrive y selecciona el evento File Added. Conecta la salida Data a un componente de “Notificación por Email”. Ahora, cada vez que un usuario agregue un archivo a esa carpeta, Nappai detectará el cambio y enviará un correo automático avisando del nuevo archivo, permitiendo una reacción inmediata y organizada sin tener que revisar la carpeta manualmente.

Consejos y Mejores Prácticas

Filtrar por Carpeta: Para un mejor rendimiento y precisión, selecciona siempre una Watch Folder específica en lugar de dejar el campo vacío, ya que esto reduce la carga de monitoreo a solo el contenido que te interesa.
Gestión de Eventos: Usa el campo Events para limitar el monitoreo solo a los cambios que te importan. Por ejemplo, si solo necesitas reaccionar a nuevos archivos, desmarca “File Modified” y “File Deleted” para simplificar el flujo y evitar procesamientos innecesarios.
Permisos de Credencial: Asegúrate de que la credencial Microsoft One Drive tenga los permisos adecuados en Microsoft Azure para leer los cambios de archivos en las carpetas seleccionadas.

Consideraciones de Seguridad

Asegúrate de proteger tus credenciales de Microsoft One Drive y nunca compartas el Client Secret públicamente.
La integración utiliza la API de Microsoft Graph, que opera con los permisos de seguridad establecidos en la credencial; verifica que la credencial tenga acceso solo a los recursos necesarios para mantener la seguridad de tus datos.