> ## Documentation Index
> Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear y actualizar varias filas en Google Sheets

> Escribe o modifica varias filas de una hoja de cálculo en una sola ejecución del flujo con la acción premium de Google Sheets.

La acción de Google Sheets de los flujos de trabajo puede crear o actualizar **varias filas** de una hoja de cálculo en una sola ejecución. Es útil cuando un flujo recibe datos agrupados (por ejemplo, los productos de un pedido o una lista de registros enviada por otro sistema) y quieres guardarlos todos de una vez, sin repetir la acción fila por fila.

> [!NOTE]
>
> Es una acción premium: cada ejecución se descuenta de la **billetera** de tu cuenta. Consulta las tarifas vigentes en **Configuración → Facturación** o en [chateea.com/precios](https://chateea.com/precios).

## Qué ganas

* **Registro más rápido:** varias filas en un solo paso en lugar de repetir la misma acción.
* **Datos ordenados:** los registros relacionados quedan juntos en la hoja.
* **Menos trabajo manual:** no tienes que agregar ni corregir filas a mano después.
* **Menos errores:** cada columna se asigna directamente a un dato del flujo.
* **Actualizaciones flexibles:** puedes cambiar valores en un rango de filas existentes.

## Antes de empezar

* Conecta tu cuenta de Google en Chateea.
* Confirma en qué unidad de Google Drive está la hoja de cálculo.
* Pon encabezados claros en la **primera fila** de la hoja: el flujo los usa como nombres de columna.
* Revisa el nombre de la pestaña (hoja) que vas a usar.
* Cada vez que agregues, renombres o reordenes columnas, usa **Actualizar encabezados** dentro de la acción.

## Crear varias filas

Usa **Crear varias filas** cuando el flujo debe agregar registros nuevos, no modificar los existentes.

**1. Abre el flujo**

Ve a **Automatización → Flujos de trabajo** y crea o edita un flujo. Agrega el disparador que corresponda, por ejemplo **Webhook entrante**.

**2. Agrega la acción de Google Sheets**

Haz clic en **+**, busca **Google Sheets** y conecta tu cuenta de Google si aún no lo has hecho.

**3. Elige el tipo de acción**

En el desplegable de acciones selecciona **Crear varias filas** (Create Multiple Spreadsheet Rows).

**4. Selecciona cuenta, unidad, hoja y pestaña**

Elige una de las cuentas de Google conectadas, la unidad de Drive, la hoja de cálculo y la pestaña donde se escribirán los datos.

**5. Define las columnas**

Selecciona **Columna inicial** y **Columna final**. La primera fila se toma como encabezado y cada columna se identifica por su encabezado. Si cambiaste la hoja, haz clic en **Actualizar encabezados**.

**6. Asigna los datos y guarda**

Asigna a cada columna el dato correspondiente del flujo y haz clic en **Guardar acción**.

### Cómo se generan las filas

La acción solo crea varias filas cuando la ejecución del flujo recibe los datos como una **lista (array) de objetos**:

* Cada objeto de la lista se convierte en una fila.
* Si la ejecución solo tiene los datos de un registro (por ejemplo, un contacto que entró al flujo), se crea una sola fila, igual que con la acción de fila única.
* La acción **no espera ni agrupa** contactos que entran al flujo en momentos distintos. Escribe la lista que exista en esa ejecución concreta.

Ejemplo de lista que crea tres filas:

```json theme={null}
[
  { "Nombre": "Sam", "Email": "sam@test.com", "Estado": "Nuevo" },
  { "Nombre": "Arjun", "Email": "arjun@example.com", "Estado": "En proceso" },
  { "Nombre": "Meera", "Email": "meera@example.com", "Estado": "Completado" }
]
```

### Cómo hacer llegar una lista al flujo

El flujo debe empezar con una lista de filas o construirla en algún paso anterior. Las formas más comunes:

* Un disparador **Webhook entrante** que recibe un JSON con una lista de filas.
* Una integración basada en webhook cuyo paso anterior devuelve una lista que asignas a esta acción.

> [!WARNING]
>
> Si quieres volcar miles de contactos que ya tienes en el CRM, inscribirlos en el flujo uno por uno genera una ejecución por contacto y no se agrupan automáticamente. Cada ejecución creará su propia fila.

**Casos de uso habituales:** registrar resultados repetidos de un flujo, guardar entradas agrupadas de una misma automatización y almacenar varios datos relacionados para seguimiento o informes.

## Actualizar varias filas

Usa **Actualizar varias filas** cuando las filas ya existen y el flujo debe cambiar sus valores dentro de un rango, sin crear duplicados.

**1. Agrega la acción**

En el flujo, agrega **Google Sheets** y en el desplegable elige **Actualizar varias filas** (Update Multiple Spreadsheet Rows).

**2. Selecciona cuenta, unidad, hoja y pestaña**

Elige la cuenta de Google, la unidad de Drive, la hoja de cálculo y la pestaña.

**3. Indica desde qué fila actualizar**

Escribe el número de fila a partir del cual se actualizará la hoja.

**4. Define las columnas**

Selecciona **Columna inicial** y **Columna final**. Usa **Actualizar encabezados** si la hoja cambió.

**5. Guarda**

Asigna los datos y haz clic en **Guardar acción**.

Úsala cuando la fila ya existe, cuando necesitas refrescar valores de registros actuales o cuando quieres evitar filas duplicadas del mismo conjunto de datos.

## Preguntas frecuentes

> **¿Qué diferencia hay entre crear y actualizar varias filas?**
>
> **Crear varias filas** agrega registros nuevos. **Actualizar varias filas** cambia valores en filas que ya existen.

> **¿En qué se diferencia de la acción de crear una sola fila?**
>
> Puede escribir muchas filas en una sola ejecución, pero solo si recibe una lista de objetos. Si la ejecución solo tiene un registro, crea una fila.

> **¿La acción agrupa a los contactos que entran al flujo?**
>
> No. Los flujos no juntan contactos para enviarlos como un lote. Para escribir varias filas de una vez, la ejecución debe traer ya la lista, normalmente desde un webhook entrante.

> **¿Necesito encabezados en la hoja?**
>
> Sí. Los encabezados de la primera fila son los nombres de columna que verás al asignar los datos.

> **No aparece una columna nueva en la acción**
>
> La acción sigue usando la estructura anterior de la hoja. Haz clic en **Actualizar encabezados**.

> **¿Qué pasa si elijo la pestaña equivocada?**
>
> Los datos pueden escribirse en el lugar incorrecto o las columnas no se asignarán bien. Revisa la pestaña antes de guardar.

> **¿Puedo limitar las columnas que se usan?**
>
> Sí. **Columna inicial** y **Columna final** definen el rango disponible para asignar datos.

## Artículos relacionados

> **[Disparador Webhook entrante](https://help.chateea.com/docs/automatizaciones/activador-premium-webhook-entrante.md)**
>
> Recibe datos de otros sistemas para iniciar un flujo.

> **[Funciones de lista](https://help.chateea.com/docs/automatizaciones/accion-premium-funciones-de-matriz.md)**
>
> Filtra, transforma y calcula valores de listas de datos.

> **[Acciones premium](https://help.chateea.com/docs/automatizaciones/acciones-premium-y-planes-de-ejecuciones.md)**
>
> Cómo se cobran las acciones premium.

> **[Recorrido por el constructor](https://help.chateea.com/docs/automatizaciones/generador-de-flujos-de-trabajo-descripcion-general.md)**
>
> Conoce las partes del constructor de flujos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.