Saltearse al contenido
Nappai Documentation

Google Drive Webhook

El componente Google Drive Webhook es un puente inteligente entre tus archivos en Google Drive y tus flujos de automatización en Nappai. Su propósito principal es actuar como un receptor que avisa a tu sistema cuando algo cambia en tus carpetas de Drive.

En lugar de tener que revisar manualmente tus carpetas o usar procesos pesados, este componente se encarga de escuchar las “señales” enviadas por Google. Cuando se añade, modifica o elimina un archivo, este componente captura esa información, la organiza y la prepara para que otros componentes de tu automatización (como un bot de chat o un motor de IA) puedan reaccionar inmediatamente.

¿Cómo funciona?

Este componente funciona de manera pasiva y reactiva, similar a un timbre de puerta. No “busca” los datos activamente, sino que espera a recibirlos de Google Drive.

  1. Escucha del Servicio: Cuando se configura correctamente, el sistema utiliza la API de Google Drive para monitorear las actualizaciones. Google Drive envía una notificación (un “webhook” o evento) cada vez que ocurre un cambio en los archivos.
  2. Procesamiento del Mensaje: Cuando el componente recibe esta notificación, lee el mensaje y verifica qué tipo de archivo fue tocado (por ejemplo, un PDF o una imagen).
  3. Generación de Datos: Transforma la notificación cruda de Google en un formato estructurado y fácil de entender. Si no hay cambios, devuelve un mensaje indicando que está todo tranquilo. Si hay cambios, extrae detalles clave como el nombre del archivo, la hora de la modificación y el tipo de evento (añadido, borrado, etc.).

Esto permite que el resto de tu flujo de trabajo en Nappai actúe solo cuando realmente es necesario, ahorrando tiempo y recursos.

Conexión y Credenciales

Para que este componente pueda hablar con Google Drive, es necesario establecer una conexión segura. Esto se hace mediante una credencial específica.

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

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Google Drive y guarda los campos requeridos (necesitarás acceso al Proyecto de Google Cloud, el Client ID y el Client Secret).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

A continuación, se detallan los campos que puedes configurar para personalizar cómo este componente monitorea tus archivos.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Watch Folder: Permite especificar la carpeta exacta de Google Drive que deseas vigilar. Al seleccionar una carpeta, el componente se enfocará solo en los cambios que ocurran dentro de ese directorio. Si no seleccionas ninguna carpeta, el sistema monitoreará todo tu Drive por defecto.

    • Visible en: Operación principal

  • Events: Define qué tipo de cambios te interesan. Puedes seleccionar uno o varios de estos eventos:

    • File Added: Se activa cuando se crea un nuevo archivo.
    • File Modified: Se activa cuando un archivo existente se actualiza.
    • File Deleted: Se activa cuando un archivo se elimina o se mueve a la papelera.
    • Visible en: Operación principal

  • Credential: Permite seleccionar la conexión segura (credencial) configurada previamente que otorga permiso al sistema para leer los datos de tu Google Drive.

    • Visible en: Operación principal

Salidas

El componente produce una salida estructurada llamada Data que contiene toda la información relevante sobre el evento detectado. Esta salida puede conectarse a otros componentes para procesar la información, guardar logs o activar respuestas automáticas.

Si no hay cambios recientes, la salida indicará claramente que no hay nuevos eventos. Si hay cambios, la salida contendrá detalles como el nombre del archivo, su tipo (mime type) y la hora exacta de la modificación.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de lo que recibirás en la salida Data cuando se detecte un cambio en un archivo (en este caso, un archivo PDF modificado): json { “text”: “[modified] report_final.pdf (application/pdf)”, “data”: { “event”: “modified”, “fileId”: “1a2b3c4d5e6f”, “fileName”: “report_final.pdf”, “mimeType”: “application/pdf”, “modifiedTime”: “2023-10-27T14:30:00Z” } }

Conectividad

Este componente está diseñado para funcionar como un desencadenante (trigger) en un flujo de trabajo.

  • Conexión Lógica: Generalmente, la salida Data de este componente se conecta a componentes que requieren información en tiempo real sobre archivos, como:
    • Componentes de IA (LLMs) para analizar el contenido de nuevos archivos.
    • Componentes de Bases de Datos para registrar el historial de cambios.
    • Componentes de Notificaciones (como Slack o Email) para avisar a usuarios cuando se suben documentos importantes.

El componente actúa como la “primera línea de defensa” o la “puerta de entrada” para los datos que provienen del ecosistema de Google Drive hacia tu automatización en Nappai.

Ejemplo de Uso

Escenario: Automatización de revisión de documentos

Imagina que tienes un sistema donde los clientes suben informes PDF a una carpeta específica de Google Drive y deseas que el sistema revise estos informes automáticamente.

  1. Configuras el componente Google Drive Webhook para vigilar la carpeta “Informes_Clientes”.
  2. Seleccionas el evento “File Added” en Events.
  3. Cuando un cliente sube un PDF, el componente detecta el cambio.
  4. La salida Data se conecta a un componente de Texto de IA.
  5. La IA analiza el contenido del PDF recién llegado y extrae los puntos clave.

Consejos y Mejores Prácticas

  • Selecciona Carpetas Específicas: Para mantener tu flujo de trabajo limpio y eficiente, intenta siempre usar la entrada Watch Folder para seleccionar una carpeta concreta en lugar de monitorear todo el Drive. Esto reduce el “ruido” de notificaciones innecesarias de otros archivos.
  • Revisa los Eventos: Si solo te interesa saber cuando llegan nuevos archivos, desmarca la opción “File Modified” o “File Deleted” en el campo Events. Esto simplifica la lógica y hace que el flujo sea más fácil de entender.
  • Manejo de Errores: El componente está diseñado para ser robusto. Si no recibe datos válidos, devolverá un mensaje claro (“No data provided”), lo que ayuda a depurar fallos en la conexión con Google Drive.

Consideraciones de Seguridad

  • Permisos de Credencial: Asegúrate de que la credencial de Google Drive que configures tenga los permisos adecuados para leer los archivos de la carpeta seleccionada, pero evita conceder permisos de “Escritura” o “Eliminación” si no son estrictamente necesarios para tu flujo, siguiendo el principio de menor privilegio.
  • Datos Sensibles: Ten en cuenta que el componente expone metadatos de los archivos (como nombres y tipos). Si estás procesando información sensible, asegúrate de que el siguiente componente en tu flujo de trabajo (al que se conecta la salida Data) tenga las medidas de seguridad necesarias para proteger esa información.