Google Sheets

Google Sheets (google_sheets) es un nodo de la categoría Acciones que opera una hoja de cálculo de forma determinística. El workflow define la credencial, el documento, la pestaña, los criterios y los datos; ningún modelo de IA decide qué leer o modificar.

Configuración inicial

1. Elegí una credencial de Google Sheets disponible para el agente.
2. Seleccioná el documento.
3. Seleccioná la pestaña por su nombre visible.
4. Elegí la operación: Obtener datos, Guardar datos, Editar datos o Borrar datos.

El workflow conserva el identificador estable de la pestaña. Si la pestaña cambia de nombre, el runtime vuelve a resolver su nombre actual antes de operar. Si fue eliminada o la credencial perdió acceso, el nodo falla sin continuar la mutación.

Origen de criterios y valores

Cada criterio o dato puede obtenerse desde:

• Texto fijo: valor escrito directamente en el nodo.
• Variable del workflow (fact): dato guardado anteriormente, como facts.email.
• Variable de un nodo anterior: salida completa o propiedad anidada seleccionada desde el modal de variables.
• Metadata: información de la ejecución, como destinatario, canal, sesión o archivo recibido.

Si una variable necesaria no existe durante la ejecución, el nodo falla antes de escribir o borrar. No convierte silenciosamente un valor ausente en una celda vacía. Para guardar una celda vacía de forma intencional, usá un texto fijo vacío.

Obtener datos

Los criterios son opcionales. Sin criterios, el nodo devuelve filas desde el comienzo de la pestaña hasta el máximo configurado. Con criterios, devuelve únicamente coincidencias exactas.

La respuesta tiene esta forma general:

{
  "ok": true,
  "operation": "get",
  "count": 1,
  "rows": [
    {
      "rowNumber": 2,
      "Cliente": "Marcos",
      "Estado": "Pendiente"
    }
  ]
}

rowNumber indica la fila real de la pestaña. Los demás nombres provienen de la primera fila, utilizada como encabezado.

Guardar datos

Agregá un mapeo por cada columna que quieras completar. La pestaña debe tener una fila de encabezados. Las columnas no configuradas se guardan vacías y una columna configurada que no exista hace fallar el nodo antes de insertar.

La respuesta incluye affectedRows: 1 y data con la fila guardada.

Editar datos

Editar requiere al menos un criterio y uno o más valores de destino. En Coincidencias elegí:

• Todas las coincidencias: edita cada fila que cumpla todos los criterios.
• Solo la primera: edita únicamente la primera coincidencia.

Todas las columnas y variables se validan antes de modificar la hoja. Las celdas se envían juntas en una operación batch para evitar una edición parcialmente aplicada si falla la solicitud.

La respuesta incluye affectedRows y rowNumbers.

Borrar datos

Borrar requiere al menos un criterio. También permite elegir entre todas las coincidencias o solo la primera.

Las filas se eliminan juntas y de abajo hacia arriba para evitar que el desplazamiento cambie las posiciones pendientes. Sin criterios válidos, el nodo no ejecuta ninguna eliminación.

Peligro

Revisá cuidadosamente los criterios y probá primero con Obtener datos. Borrar elimina filas reales de Google Sheets y no ofrece restauración desde el workflow.

Probar con Try

Presioná Try para ejecutar solamente este nodo y ver la respuesta. La última respuesta exitosa queda guardada como muestra dentro del workflow; así los nodos posteriores pueden abrir Variable del workflow y elegir campos anidados sin escribir rutas manualmente.

Por ejemplo, después de probar una lectura podés seleccionar:

• la respuesta completa;
• count;
• rows;
• rows.0.Cliente;
• rows.0.Estado.

La muestra de Try describe la estructura disponible, pero el siguiente nodo usa el resultado real de cada ejecución.

Precaución

Try no es una simulación. En Guardar, Editar y Borrar modifica la hoja real. El editor solicita confirmación antes de ejecutar esas operaciones.

Continuar el workflow

Google Sheets tiene una única salida lineal. Conectala al siguiente nodo y usá su respuesta directamente o seleccioná una propiedad desde el modal de variables. Si necesitás responder ante fallos, configurá el manejo general del workflow o evitá activar el flujo hasta que la credencial, pestaña, columnas y criterios estén validados.

Recomendaciones

• Usá encabezados únicos y no los dejes vacíos.
• Preferí identificadores estables, como ID, teléfono o email, para editar y borrar.
• Antes de activar, probá casos con cero, una y varias coincidencias.
• Usá una pestaña separada para pruebas de escritura.
• No guardes tokens ni secretos como texto fijo, facts o metadata.
• Si cambiás la estructura de la hoja, volvé a abrir el nodo, revisá las columnas y ejecutá Try nuevamente.

Siguiente: Etiquetar o bloquear