Saltearse al contenido
Nappai Documentation

Google Drive Webhook

Google Drive Webhook pone en marcha un flujo cada vez que cambia un archivo en tu Google Drive: cuando se crea uno nuevo, cuando se modifica uno existente o cuando se elimina. Puedes vigilar todo tu Drive o solo una carpeta.

NappAI revisa tu Drive aproximadamente cada minuto y, si encuentra cambios, ejecuta el flujo con los datos de cada archivo afectado. No tienes que configurar nada en Google: basta con la credencial y con suscribir el flujo.

Cuándo usarlo

  • Un cliente o un compañero deja facturas en una carpeta de Drive y quieres procesarlas en cuanto llegan.
  • Quieres avisar a tu equipo por correo cuando se actualiza un documento importante.
  • Necesitas llevar un registro de los archivos que se eliminan de tu Drive.
  • Quieres que un agente de IA lea y resuma cada contrato nuevo que se guarda en una carpeta.

Configuración

Necesitas una credencial Google Drive, que se conecta iniciando sesión con tu cuenta de Google. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Google Drive de la cuenta que quieres vigilar.
Watch FolderLa carpeta de Drive que se vigila. Solo cuentan los archivos que están directamente en ella, no los de sus subcarpetas. Si la dejas vacía, se vigila todo el Drive.
EventsLos 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.
DataCampo de prueba. Te permite probar el flujo con un evento de ejemplo sin esperar a que ocurra un cambio real en Drive. Déjalo vacío en el uso normal.

Activar la suscripción

El flujo solo recibe cambios cuando está suscrito:

  1. Guarda el flujo y publica una versión. Para suscribirte necesitas una versión publicada del flujo. Consulta Versiones y publicación.
  2. En el panel de ajustes del nodo pulsa Suscribirse.
  3. En el panel que se abre pulsa Suscribirse. El estado pasa a Sincronizado.

Solo llegan los cambios que ocurren después de suscribirte. Si más adelante 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 del archivo (fileId), su nombre (fileName), su tipo y la fecha de modificación. Si llegan varios cambios a la vez, salen todos juntos.

Conéctala a Drive File Manager con la operación Get para leer el contenido del archivo, 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 Drive.

  1. Añade Google Drive Webhook y elige la credencial Google Drive de la gestoría.
  2. En Watch Folder selecciona la carpeta Facturas pendientes y en Events deja solo File Added.
  3. Conecta la salida Data a Drive File Manager con la operación Get, Mode of Input en By Id y Process File Content activado para leer el texto de cada factura, y después a un agente que extraiga el importe y el proveedor.
  4. Publica el flujo y pulsa Suscribirse.

Buenas prácticas

  • Vigila una carpeta concreta en lugar de todo el Drive: 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.

Componentes relacionados