Nodo Google Sheets

El nodo Google Sheets lee y escribe en hojas de cálculo de Google. Útil para registrar leads, exportar resultados, mantener una base de datos simple o usar una hoja como fuente de datos.

Credencial

Se conecta por OAuth de Google (eliges la cuenta por su correo). Ver Credenciales. El nodo necesita los permisos de Drive (para listar documentos) y Sheets (para leer/escribir) — si la cuenta no los tiene, el selector de documento la marca como “Sin permiso”.

Desde el nodo, el botón “Gestionar cuenta” abre el mismo panel de permisos que “Apps conectadas”: ver qué está otorgado, otorgar lo que falte o desconectar la cuenta, sin salir del editor. ”+ Agregar credencial” conecta una cuenta nueva de la misma forma.

Documento y hoja

El botón “Documento y hoja” abre un buscador que lista los documentos de Google Sheets de la cuenta conectada (siempre actualizado — vuelve a consultar Drive cada vez que lo abres) y, al elegir uno, sus pestañas.

Importante: solo aparecen documentos que sean Google Sheets nativos, no archivos .xlsx subidos tal cual a Drive. Si subiste un Excel, conviértelo primero: en Drive, clic derecho sobre el archivo → “Abrir con” → “Hojas de cálculo de Google” (crea una copia nativa). Para que la conversión sea automática en subidas futuras, actívalo en Drive → ⚙️ Configuración → “Convertir archivos subidos al formato de Editores de Documentos de Google”.

Columnas únicas (clave de búsqueda)

En la vista previa de columnas del mismo buscador, puedes marcar una o varias columnas como únicas (🔑) — por ejemplo, “Email” o “Cédula”. Esto define automáticamente la columna clave que usan Actualizar/Upsert fila y el Filtro (ver abajo) para encontrar la fila exacta, sin tener que elegirla de nuevo en cada operación.

Si la columna marcada tiene valores repetidos en la hoja, Waiify avisa con un mensaje (no bloquea el uso): la búsqueda por esa columna podría no traer la fila exacta que esperas.

Operaciones

Operación	Qué hace
Obtener filas	Lee todas las filas de la hoja
Buscar filas	Filtra por una o varias columnas combinadas (Y lógico)
Agregar fila	Añade una fila nueva al final
Actualizar / Upsert fila	Actualiza una fila existente (por columna(s) única(s) o número de fila); si no existe, la crea
Eliminar filas	Borra las filas que coincidan con el filtro
Eliminar columnas	Borra por completo una o varias columnas, con su contenido
Limpiar datos	Vacía la hoja dejando la fila de encabezados
Crear hoja	Crea una pestaña nueva dentro del documento
Eliminar hoja	Borra por completo una pestaña, con sus datos
Crear documento	Crea un Google Sheets nuevo desde cero

Eliminar documento no está disponible: requiere un permiso de Drive de lectura+escritura más amplio y sensible (sujeto a verificación de Google), que Waiify no solicita hoy.

Buscar / Actualizar con varias columnas combinadas

Tanto el Filtro (Buscar/Eliminar filas) como “Buscar fila por” (Actualizar/Upsert) soportan varias condiciones a la vez, combinadas con Y lógico — igual que “Matching Columns” en n8n. Por ejemplo, puedes filtrar por Estado = Activo y Ciudad = Bogotá a la vez, en vez de traer de más con una sola columna.

Vista previa en vivo (“Buscar fila”)

En Actualizar/Upsert, si ya marcaste una columna única, aparece un ícono de lupa dentro de ese mismo campo (en “Valores por columna”). Escribe un valor real (ej. una cédula), haz clic en la lupa, y Waiify trae los datos actuales de esa fila desde Google Sheets — sin ejecutar el flujo — y precarga los demás campos con esos valores como punto de partida para editar. Es solo una ayuda al configurar el nodo; no afecta lo que hace el flujo en producción.

Modo de mapeo (Agregar / Actualizar fila)

Para no tener que llenar campo por campo cuando hay muchas columnas, hay dos modos:

• Manual (por defecto): eliges cada columna y su valor/variable individualmente.
• Automático: le das una sola variable que sea un objeto (ej. {{trigger.body}}, datos de un nodo anterior) y el nodo empareja automáticamente sus llaves con los nombres de columna de la hoja. Las columnas sin coincidencia quedan vacías (o sin tocar, al actualizar).

Salidas

Operación	Salidas
Obtener / Buscar filas	rows, count
Agregar fila	updatedRange, updatedRows
Actualizar / Upsert	updated/inserted, rowNumber, updatedCells
Eliminar filas	deletedRows
Eliminar columnas	deletedColumns
Limpiar datos	cleared, range
Crear hoja	sheetId, title
Eliminar hoja	deleted, sheetName
Crear documento	spreadsheetId, spreadsheetUrl, title

Ejemplo — registrar un lead

• Operación: Agregar fila
• Documento y hoja: tu hoja → pestaña Leads
• Modo de mapeo: Manual — Nombre = {{nombre}}, Email = {{email}}, Fecha = {{triggerData.scheduledAt}}

Problemas comunes

• No aparece mi documento en el buscador — probablemente sigue siendo un archivo Excel (.xlsx) en Drive, no un Google Sheets nativo. Conviértelo con “Abrir con → Hojas de cálculo de Google” (ver arriba).
• La búsqueda no trae la fila correcta — revisa el aviso de “valores repetidos”: si la columna que marcaste como única no lo es realmente en tus datos, agrega otra columna a la búsqueda para combinarlas.
• Duplica filas al actualizar — marca una columna única (o varias) para que haga upsert en vez de agregar siempre.