OneDrive Webhook
OneDrive Webhook pone en marcha un flujo cada vez que cambia un archivo en tu OneDrive: cuando se sube uno nuevo, cuando se modifica uno existente o cuando se elimina. Puedes vigilar todo tu OneDrive o solo una carpeta.
NappAI revisa tu OneDrive cada poco tiempo y, si encuentra cambios, ejecuta el flujo con los datos de cada archivo afectado. No tienes que configurar nada en Microsoft: basta con la credencial y con suscribir el flujo.
Cuándo usarlo
- Un cliente o un compañero deja facturas en una carpeta de OneDrive y quieres procesarlas en cuanto llegan.
- Quieres avisar a tu equipo por correo o por Teams cuando se actualiza un documento importante.
- Necesitas llevar un registro de los archivos que se eliminan de una carpeta compartida.
- Quieres que un agente de IA lea y resuma cada contrato nuevo que se guarda en una carpeta.
Configuración
Necesitas una credencial Microsoft One Drive, que se conecta iniciando sesión con tu cuenta de Microsoft. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Microsoft One Drive de la cuenta que quieres vigilar. |
| Watch Folder | La carpeta de OneDrive que se vigila. Si la dejas vacía, se vigila todo el OneDrive. |
| Events | Los cambios que inician el flujo: File Added (se crea un archivo), File Modified (se modifica un archivo) y File Deleted (se elimina o se envía a la papelera). Por defecto, los tres. Si no eliges ninguno, se usan los tres. |
| Data | Campo de prueba. Te permite probar el flujo con un evento de ejemplo sin esperar a que ocurra un cambio real en OneDrive. Déjalo vacío en el uso normal. |
Activar la suscripción
El flujo solo recibe cambios cuando está suscrito:
- Guarda el flujo y publica una versión. Para suscribirte necesitas una versión publicada del flujo. Consulta Versiones y publicación.
- En el panel de ajustes del nodo pulsa Suscribirse.
- En el panel que se abre pulsa Suscribirse. El estado pasa a Sincronizado.
Si después cambias la carpeta o los eventos, el estado aparece como Desincronizado: vuelve a suscribirte para aplicar los cambios. Desde el mismo panel puedes Cancelar suscripción cuando ya no quieras recibir cambios.
Resultado
La salida Data contiene un elemento por cada archivo que ha cambiado, con el tipo de cambio (added, modified o deleted), el identificador y el nombre del archivo, su tipo y la fecha de modificación. Si llegan varios cambios a la vez, salen todos juntos.
Conéctala a un componente que lea el archivo, como Files, a un agente de IA o a un componente de correo o mensajería.
Ejemplo
Una gestoría recibe las facturas de sus clientes en la carpeta Facturas pendientes de OneDrive.
- Añade OneDrive Webhook y elige la credencial Microsoft One Drive de la gestoría.
- En Watch Folder selecciona la carpeta
Facturas pendientesy en Events deja soloFile Added. - Conecta la salida Data a Files con la operación
Get Filepara leer el contenido de cada factura, y después a un agente que extraiga el importe y el proveedor. - Publica el flujo y pulsa Suscribirse.
Buenas prácticas
- Vigila una carpeta concreta en lugar de todo el OneDrive: el flujo se ejecuta menos veces y solo con lo que te interesa.
- Si el flujo guarda archivos en la misma carpeta que vigila, se volverá a ejecutar con sus propios archivos. Guarda los resultados en otra carpeta.