Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt

Use this file to discover all available pages before exploring further.

Google Drive es el sistema de archivos compartido de Google Workspace. A diferencia de integraciones de datos estructurados como Sheets o Supabase, Drive opera sobre archivos y carpetas: documentos, PDFs, imágenes, contratos y cualquier recurso que necesite almacenarse, organizarse o compartirse como parte de un proceso. En Brain Studio, la integración permite que tus flujos creen, busquen, compartan y organicen archivos en Drive directamente desde la conversación, sin que nadie tenga que abrir Drive aparte.

​
Qué habilita Google Drive

Al conectar Google Drive, puedes:
  • Entregar documentos al cliente desde el chat — buscar un archivo, ajustar permisos y compartir el enlace sin que nadie navegue carpetas manualmente
  • Recibir y clasificar archivos del usuario — subir adjuntos a la carpeta correcta con nomenclatura consistente según cliente, caso o proceso
  • Provisionar estructura por cliente o proyecto — crear carpetas, copiar plantillas y compartir con el equipo asignado automáticamente
  • Gobernar colaboración y permisos — compartir recursos, resolver propuestas de acceso y trabajar comentarios en documentos
  • Consultar metadatos y contexto — identificar rutas, versiones y usuario actual antes de tomar decisiones en el flujo

​
Instalación

​
Requisitos previos

  1. Una cuenta de Google con acceso a Google Drive.
  2. Permisos suficientes en los recursos que vas a gestionar (comentarios, compartición o unidades compartidas, según aplique).

​
Cómo conectarla

Puedes conectar Google Drive de dos maneras:
  • Desde el Marketplace — buscas la integración y haces la conexión manual.
  • Desde Jelou Agent — si el agente detecta que necesitas Drive mientras construyes una solución, te pedirá conectarlo en ese momento.
Si estás creando una solución desde cero, lo más habitual es conectar Google Drive desde Jelou Agent. Si ya sabes qué integración necesitas, puedes instalarla manualmente desde el Marketplace.
En ambos casos, el acceso se realiza mediante OAuth con una ventana segura de Google.

Cómo usar integraciones en Brain

Instalación con Jelou Agent o Marketplace, y uso en Canvas frente a AI Agent.

Jelou Agent

Cómo describir tu solución para que Brain sugiera integraciones y arme el flujo.
El siguiente flujo describe la instalación manual desde el Marketplace.
1

Abrir el Marketplace

En Brain Studio, abre Marketplace desde el menú lateral.
2

Buscar Google Drive

Encuentra Google Drive en el catálogo y haz clic en Conectar.
3

Autorizar acceso con Google

Se abrirá una ventana de autorización segura de Google. Inicia sesión si hace falta y acepta los permisos solicitados.
4

Confirmar la instalación

Al volver a Brain Studio, deja finalizar el asistente hasta que la integración aparezca como conectada.
En el Marketplace, Google Drive debe mostrarse como conectada. Desde el Canvas puedes añadir su nodo, y en AI Agent → Herramientas puedes activarla.

​
Tools disponibles

A alto nivel, las acciones se agrupan así:
  • Consultar — buscar/listar archivos, carpetas, unidades, comentarios, respuestas y metadatos.
  • Crear o modificar — crear, copiar, subir, mover, actualizar y compartir recursos.
  • Colaboración y gobierno — comentarios, respuestas, propuestas de acceso y permisos.
  • Eliminar — mover a papelera o eliminar recursos de forma permanente.
La integración expone 37 tools en Brain Studio; a continuación, cada una con propósito, inputs y ejemplo.
Añade un comentario no anclado a un archivo compatible (p. ej. Google Docs): retroalimentación general sin resaltar un fragmento concreto.Inputs:
  • fileId (string) — ID del archivo.
  • content (string) — Texto del comentario (HTML permitido según API).
Ejemplo:
{
  "fileId": "1XyZdocId",
  "content": "Revisar la sección de conclusiones antes de publicar."
}
Documentación de Google: comments.create
Crea un permiso de uso compartido sobre un archivo o carpeta y puede devolver una URL de uso compartido según la configuración.Inputs:
  • fileId (string) — ID del archivo o carpeta.
  • role (enum: reader | writer | commenter | owner) — Nivel de acceso.
  • type (enum: user | group | domain | anyone) — Tipo de destinatario.
  • emailAddress (opcional, string) — Correo si type es user o group.
  • domain (opcional, string) — Dominio si type es domain.
  • sendNotificationEmail (opcional, boolean) — Notificar por correo.
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "role": "writer",
  "type": "user",
  "emailAddress": "[email protected]",
  "sendNotificationEmail": true
}
Ayuda de Google: cómo funciona el uso compartido · permissions.create
Crea una copia de un archivo en tu Drive (u otra ubicación admitida).Inputs:
  • fileId (string) — ID del archivo origen.
  • name (opcional, string) — Nombre de la copia.
  • folderId (opcional, string) — Carpeta destino.
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "name": "reporte-copia.pdf",
  "folderId": "1A2B3CcarpetaID"
}
Documentación de Google: files.copy
Crea un Google Doc a partir de una plantilla. Opcionalmente puedes definir marcadores de posición en la plantilla que la acción sustituye por valores.Inputs:
  • templateFileId (string) — ID del documento plantilla.
  • name (opcional, string) — Título del documento nuevo.
  • folderId (opcional, string) — Carpeta destino.
  • placeholders / replacements (opcional, objeto) — Mapa clave-valor para sustituir marcadores (nombres exactos según Brain Studio).
La sustitución de marcadores en plantillas suele basarse en convenciones tipo mustache; consulta el paquete usado por la integración para el formato exacto de los placeholders.
Ejemplo:
{
  "templateFileId": "1TplAbC123",
  "name": "Contrato - Cliente X",
  "folderId": "1A2B3CcarpetaID",
  "placeholders": {
    "{{nombre}}": "María",
    "{{fecha}}": "2025-03-23"
  }
}
Google: files / Docs · google-docs-mustaches (placeholders)
Crea un archivo nuevo con contenido de texto plano (p. ej. .txt o tipo MIME indicado).Inputs:
  • name (string) — Nombre del archivo.
  • content (string) — Contenido en texto plano.
  • mimeType (opcional, string) — Por defecto suele ser text/plain.
  • folderId (opcional, string) — Carpeta padre.
Ejemplo:
{
  "name": "notas.txt",
  "content": "Línea 1\\nLínea 2",
  "mimeType": "text/plain",
  "folderId": "1A2B3CcarpetaID"
}
Documentación de Google: files.create
Crea una carpeta vacía en la ubicación indicada.Inputs:
  • name (string) — Nombre de la carpeta.
  • parentFolderId (opcional, string) — Carpeta padre.
  • description (opcional, string) — Descripción.
Ejemplo:
{
  "name": "Documentos 2025",
  "parentFolderId": "0B1XyZpadreID",
  "description": "Documentos del año 2025"
}
Documentación de Google: files.create (tipo carpeta)
Crea una unidad compartida nueva (Team Drive).Inputs:
  • name (string) — Nombre de la unidad.
  • requestId (opcional, string) — ID de solicitud idempotente si la API lo requiere.
Ejemplo:
{
  "name": "Proyecto Alpha"
}
Documentación de Google: drives.create
Elimina un comentario por su ID (debes ser propietario del comentario o tener permisos sobre el archivo).Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd"
}
Documentación de Google: comments.delete
Elimina de forma permanente un archivo o carpeta; no lo mueve a la papelera.Inputs:
  • fileId (string) — ID del recurso.
Esta acción es irreversible en el sentido de la API files.delete. Para enviar a la papelera usa Mover Archivo a la Papelera.
Ejemplo:
{
  "fileId": "1XyZarchivoID"
}
Documentación de Google: files.delete
Elimina una respuesta concreta a un comentario.Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
  • replyId (string) — ID de la respuesta.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd",
  "replyId": "reply-id-123"
}
Documentación de Google: replies.delete
Elimina una unidad compartida solo si está vacía (sin contenido).Inputs:
  • driveId (string) — ID de la unidad compartida.
Requisito habitual de la API: la unidad no debe contener archivos ni carpetas. Vacía primero la unidad o usa otras tools para mover o eliminar contenido.
Ejemplo:
{
  "driveId": "0AJxyZunidadID"
}
Documentación de Google: drives.delete
Descarga el contenido de un archivo. El conector puede devolver base64 para archivos pequeños o una URL de descarga para archivos grandes.Inputs:
  • fileId (string) — ID del archivo.
Ejemplo:
{
  "fileId": "1XyZarchivoID"
}
Documentación de Google: descargas
Busca archivos usando criterios admitidos por la API (p. ej. nombre o consulta q).Inputs:
  • name (opcional, string) — Nombre o fragmento.
  • query (opcional, string) — Consulta de búsqueda de archivos.
  • pageSize (opcional, number) — Límite de resultados.
Ejemplo:
{
  "name": "informe",
  "pageSize": 20
}
Documentación de Google: buscar archivos y carpetas
Busca carpetas por nombre (u otra consulta admitida).Inputs:
  • name (opcional, string) — Nombre de la carpeta.
  • query (opcional, string) — Consulta (p. ej. mimeType = 'application/vnd.google-apps.folder').
Ejemplo:
{
  "name": "Facturación",
  "query": "mimeType = 'application/vnd.google-apps.folder' and name contains 'Facturación'"
}
Documentación de Google: buscar archivos y carpetas
Lista o busca Google Forms por nombre (MIME tipo de formulario).Inputs:
  • name (opcional, string) — Nombre del formulario.
  • query (opcional, string) — Consulta personalizada.
Ejemplo:
{
  "name": "Encuesta satisfacción",
  "query": "mimeType = 'application/vnd.google-apps.form'"
}
Documentación de Google: buscar archivos y carpetas
Busca Google Sheets por nombre.Inputs:
  • name (opcional, string) — Nombre de la hoja.
  • query (opcional, string) — Consulta (p. ej. mimeType = 'application/vnd.google-apps.spreadsheet').
Ejemplo:
{
  "name": "Ventas Q1",
  "query": "mimeType = 'application/vnd.google-apps.spreadsheet' and name contains 'Ventas'"
}
Documentación de Google: buscar archivos y carpetas
Obtiene un comentario concreto por commentId en un archivo.Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd"
}
Documentación de Google: comments.get
Devuelve información de la cuenta autenticada vía about.get: nombre, correo, espacio usado, cuota, etc.Inputs:
  • fields (opcional, string) — Campos a devolver (según API).
Ejemplo:
{
  "fields": "user,storageQuota"
}
Documentación de Google: about.get
Obtiene metadatos de un archivo o carpeta por fileId.Inputs:
  • fileId (string) — ID del archivo.
  • fields (opcional, string) — Campos a incluir en la respuesta.
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "fields": "id,name,mimeType,parents,webViewLink"
}
Documentación de Google: files.get
Resuelve el folderId de la última carpeta de una ruta (p. ej. Carpeta1/Carpeta2), creando carpetas intermedias solo si la tool lo indica.Inputs:
  • path (string) — Ruta con separadores (p. ej. / o el formato que muestre Brain Studio).
  • rootFolderId (opcional, string) — Carpeta raíz si no es “Mi unidad” por defecto.
  • createMissing (opcional, boolean) — Crear carpetas faltantes.
Ejemplo:
{
  "path": "Clientes/2025/Contratos",
  "createMissing": true
}
Documentación de Google: buscar archivos y carpetas
Obtiene una respuesta concreta dentro de un comentario.Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
  • replyId (string) — ID de la respuesta.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd",
  "replyId": "reply-id-123"
}
Documentación de Google: replies.get
Obtiene metadatos de una unidad compartida por ID o, según parámetros, información de las unidades accesibles.Inputs:
  • driveId (opcional, string) — ID de la unidad; si se omite, el comportamiento depende de la tool (p. ej. listar todas).
Ejemplo:
{
  "driveId": "0AJxyZunidadID"
}
Documentación de Google: drives.get
Lista propuestas de acceso pendientes para un archivo o carpeta (flujos de solicitud de acceso en Drive).Inputs:
  • fileId (string) — ID del archivo o carpeta.
Ejemplo:
{
  "fileId": "1XyZarchivoID"
}
Documentación de Google: accessProposals.list
Lista todos los comentarios de un archivo.Inputs:
  • fileId (string) — ID del archivo.
  • pageSize (opcional, number) — Tamaño de página.
  • pageToken (opcional, string) — Paginación.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "pageSize": 50
}
Documentación de Google: comments.list
Lista archivos dentro de una carpeta u otros criterios admitidos (files.list).Inputs:
  • folderId (opcional, string) — Carpeta padre.
  • pageSize (opcional, number) — Cantidad de resultados (máx. habitual 100).
  • pageToken (opcional, string) — Token de página siguiente.
  • query (opcional, string) — Filtro adicional.
  • orderBy (opcional, string) — Orden (p. ej. modifiedTime desc).
Ejemplo:
{
  "pageSize": 25,
  "pageToken": "CAoQAA",
  "folderId": "1A2B3CcarpetaID",
  "query": "mimeType != 'application/vnd.google-apps.folder'",
  "orderBy": "modifiedTime desc"
}
Documentación de Google: files.list
Lista las respuestas de un comentario concreto.Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd"
}
Documentación de Google: replies.list
Mueve un archivo (o carpeta) cambiando sus padres a la carpeta destino.Inputs:
  • fileId (string) — ID del ítem a mover.
  • targetFolderId (string) — ID de la carpeta destino.
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "targetFolderId": "1A2B3CnuevaCarpetaID"
}
Documentación de Google: files.update (parents)
Marca el archivo o carpeta como en la papelera (trashed), sin borrado permanente.Inputs:
  • fileId (string) — ID del recurso.
Ejemplo:
{
  "fileId": "1XyZarchivoID"
}
Documentación de Google: files.update
Añade una respuesta a un comentario existente.Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
  • content (string) — Texto de la respuesta.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd",
  "content": "Hecho, revisado el apartado 3."
}
Documentación de Google: replies.create
Acepta o rechaza una propuesta de acceso a un archivo o carpeta.Inputs:
  • fileId (string) — ID del recurso.
  • proposalId (string) — ID de la propuesta.
  • action (enum) — Valor admitido por la API (p. ej. aceptar / denegar).
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "proposalId": "prop-abc-123",
  "action": "accept"
}
Documentación de Google: accessProposals.resolve
Marca un comentario como resuelto (cierra el hilo de revisión en la UI de Docs).Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
  • resolved (opcional, boolean) — Suele ser true para resolver.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd",
  "resolved": true
}
Documentación de Google: comments.update
Busca unidades compartidas con una consulta (q) y opciones de paginación.Inputs:
  • query (opcional, string) — Criterios de búsqueda.
  • pageSize (opcional, number)
  • pageToken (opcional, string)
Ejemplo:
{
  "query": "name contains 'Marketing'",
  "pageSize": 10
}
Documentación de Google: buscar unidades compartidas
Actualiza el contenido de un comentario existente.Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
  • content (string) — Nuevo texto.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd",
  "content": "Texto del comentario corregido."
}
Documentación de Google: comments.update
Actualiza metadatos (nombre, descripción, padres) y/o contenido del archivo según el tipo.Inputs:
  • fileId (string) — ID del archivo.
  • name (opcional, string) — Nuevo nombre.
  • description (opcional, string) — Descripción.
  • content (opcional, string) — Contenido en base64 para archivos binarios de tamaño manejable.
  • mimeType (opcional, string) — Requerido si actualizas contenido.
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "name": "reporte-actualizado.pdf",
  "description": "Versión corregida",
  "content": "JVBERi0xLjQKJcTl8uXrp/Og0MTGCg==",
  "mimeType": "application/pdf"
}
Documentación de Google: files.update
Edita el texto de una respuesta a un comentario.Inputs:
  • fileId (string) — ID del archivo.
  • commentId (string) — ID del comentario.
  • replyId (string) — ID de la respuesta.
  • content (string) — Nuevo contenido.
Ejemplo:
{
  "fileId": "1XyZdocId",
  "commentId": "AAA-BbCcDd",
  "replyId": "reply-id-123",
  "content": "Actualización: ya está publicado."
}
Documentación de Google: replies.update
Actualiza metadatos de una unidad compartida (p. ej. nombre, restricciones según API).Inputs:
  • driveId (string) — ID de la unidad.
  • name (opcional, string) — Nuevo nombre.
  • Otros campos según formulario en Brain Studio.
Ejemplo:
{
  "driveId": "0AJxyZunidadID",
  "name": "Proyecto Alpha (archivado)"
}
Documentación de Google: drives.update
Sube un archivo nuevo a Drive desde URL o contenido en base64, con carpeta y descripción opcionales.Inputs:
  • name (string) — Nombre del archivo.
  • mimeType (string) — Tipo MIME.
  • source (enum: url | base64) — Origen del contenido.
  • content (string) — URL o datos codificados.
  • folderId (opcional, string) — Carpeta destino.
  • description (opcional, string) — Descripción.
Ejemplo:
{
  "name": "reporte.pdf",
  "mimeType": "application/pdf",
  "source": "url",
  "content": "https://ejemplo.com/archivos/reporte.pdf",
  "folderId": "1A2B3CcarpetaID",
  "description": "Reporte mensual de ventas"
}
Documentación de Google: subidas

​
Cómo usar en Brain

Una vez conectada, puedes usar Google Drive en dos superficies:

​
En AI Agent

Ideal cuando el usuario quiere buscar, subir, compartir o comentar archivos en lenguaje natural.
1

Abre el nodo AI Agent

En el Canvas, selecciona o añade el nodo AI Agent.
2

Abre Herramientas

En el panel derecho, entra a la pestaña Herramientas.
3

Agrega Google Drive

Usa Agregar tool, busca Google Drive y actívala.
4

Configura las tools

Elige integración completa o activa solo las acciones que necesites. Ajusta el prompt para confirmar archivo, carpeta o fileId antes de compartir o eliminar, y para pedir aclaración si la intención es ambigua.
Google Drive aparece en la lista de herramientas del agente y puedes abrir su configuración con el icono de ajustes.
El agente decidirá automáticamente cuándo buscar, subir o compartir archivos según la conversación.

​
En Canvas

Ideal cuando necesitas control total del flujo (por ejemplo: subir archivo → ajustar permisos → notificar).
1

Arrastra Google Drive al Canvas

En el panel lateral, abre Marketplace y arrastra Google Drive al flujo.
2

Selecciona la tool

Con el nodo seleccionado, en Tools elige la acción (por ejemplo Subir Archivo).
3

Configura el cuerpo y la memoria

Completa el JSON del cuerpo de la petición y, si aplica, Guardar respuesta en una variable de memoria.
4

Conecta el flujo

Enlaza las salidas Finalizó la tarea y Hubo un error con los nodos siguientes.
El nodo queda listo para ejecutarse en el orden definido por tu flujo.
Ejemplo de configuración: El editor del nodo muestra un cuerpo JSON alineado con la tool de carga o gestión que elijas (este ejemplo corresponde a subir un archivo desde URL). Ajusta mimeType, source y content según el formulario de la tool. 
{
  "name": "{{$memory.nombre_archivo}}",
  "mimeType": "application/pdf",
  "source": "url",
  "content": "{{$memory.url_archivo}}",
  "folderId": "{{$memory.folder_id}}"
}
Si construyes con Jelou Agent, el sistema decide automáticamente cómo usar la integración: puede configurarla dentro de un AI Agent o como nodo en Canvas, según el tipo de proceso.

​
Casos de uso

El cliente pide su factura, contrato o certificado por chat. En lugar de buscarlo manualmente en carpetas compartidas, el flujo lo localiza en Drive, ajusta permisos y entrega el enlace en la misma conversación.Ejemplo concreto: una empresa de servicios financieros recibe solicitudes de certificados por WhatsApp. El cliente pide “mi certificado de retención 2024”. El flujo busca el archivo en la carpeta del cliente, le da acceso de lectura y responde con el enlace directo. El cliente lo descarga en segundos sin que nadie intervenga.Ideal para: utilities, fintech, educación y servicios con documentación recurrente que los clientes solicitan con frecuencia.
Los archivos que el usuario envía por chat se guardan en la carpeta correcta de Drive con nomenclatura consistente, en lugar de quedar sueltos en bandejas de correo personales.Ejemplo concreto: un proceso de onboarding KYC. El cliente envía foto de su documento de identidad por WhatsApp. El flujo identifica al cliente, resuelve la carpeta de su expediente en Drive, sube el archivo con nombre estandarizado (ej. “INE-nombre-fecha.jpg”) y confirma la recepción. El equipo de compliance encuentra todo organizado cuando revisa el caso.Ideal para: onboarding KYC, soporte con evidencias, operaciones documentales y compliance.
Cada nuevo cliente u oportunidad obtiene su estructura de carpetas, plantillas copiadas y permisos asignados antes de que empiece el trabajo.Ejemplo concreto: una consultora B2B cierra un nuevo proyecto. El flujo crea la carpeta del proyecto en Drive, copia las plantillas estándar (propuesta, contrato, minutas), comparte la carpeta con el equipo asignado y registra el enlace en el CRM. El primer día del proyecto, todo está listo sin que nadie haya creado carpetas manualmente.Ideal para: ventas B2B, implementación y proyectos por cuenta que necesitan estructura homogénea.

​
Integraciones que combinan bien con Google Drive

Después de generar o localizar un archivo en Drive, el flujo puede enviarlo como enlace en un correo desde la cuenta conectada de Gmail, con permisos ya ajustados.Flujo combinado: archivo generado en Drive → correo vía Gmail con enlace compartido al destinatario.Documentación de Gmail
Cada archivo subido o generado puede registrarse como fila en una hoja de control: cliente, tipo de documento, fecha, enlace y estado. Útil para auditoría o seguimiento operativo.Flujo combinado: archivo subido a Drive → nueva fila en Sheets con metadatos y enlace.Documentación de Google Sheets
Cuando el proceso comercial genera documentos (propuestas, contratos), el flujo puede crear el archivo en Drive y registrar el enlace en el deal o contacto correspondiente de HubSpot.Flujo combinado: propuesta generada en Drive → enlace registrado en la oferta de HubSpot.Documentación de HubSpot
Al agendar una reunión, el flujo puede crear la carpeta de materiales en Drive y asociar el enlace al evento, para que los asistentes tengan acceso antes de la llamada.Flujo combinado: evento creado en Google Calendar → carpeta de materiales creada en Drive → enlace adjunto al evento.Documentación de Google Calendar

​
Artículos relacionados

Integraciones

Catálogo de integraciones disponibles en el Marketplace.

Cómo usar integraciones en Brain

Flujo general para instalar y usar integraciones en Brain Studio.