Google Sheet Writer

Google Sheet Writer escribe en una hoja de cálculo de Google los datos que le llegan del flujo. Cada elemento se convierte en una fila, y cada campo del elemento, en una columna.

Puede añadir las filas al final de la pestaña o vaciarla y escribirla de nuevo, con una primera fila de títulos que lleva el nombre de cada campo.

Cuándo usarlo

Registrar en una hoja los pedidos o los contactos que recoge un formulario.
Volcar cada semana un listado actualizado de incidencias.
Guardar en una hoja los datos que un agente extrae de correos o documentos.

Configuración

Este componente necesita la credencial del servicio Google Sheets. En el campo Credential (obligatorio), elige una con Seleccionar una credencial o crea una nueva con Crear nueva credencial. Ver Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial de tu cuenta de Google.
Select Google Sheet (optional)	La hoja de cálculo en la que se escribe. Elígela en el selector. Déjala vacía para crear una hoja de cálculo nueva en tu Drive.
Sheet Name	La pestaña de la hoja de cálculo en la que se escribe. La lista se carga con las pestañas de la hoja elegida; pulsa el botón de recarga si no aparecen. Si la pestaña no existe, se crea; si se deja vacía, se usa la primera.
New Sheet Title (if creating)	El título de la hoja de cálculo nueva que se crea cuando Select Google Sheet está vacío. Por defecto: `NappAI Sheet`.
Write Mode	append añade las filas al final de la pestaña. overwrite borra el contenido de la pestaña y escribe una fila de títulos con los nombres de los campos y, debajo, los datos. Con append, la fila de títulos también se escribe cuando la pestaña está vacía. Por defecto: append.
Input Data	Los datos que se escriben. Conecta aquí una lista de datos o un mensaje; cada elemento es una fila.

Uso como herramienta de un agente

Puedes conectar este componente a la entrada Tools de un agente. En la pestaña Tool, Tool Name y Tool Description son el nombre y la explicación con los que el agente reconoce la herramienta y decide cuándo usarla: escribe una descripción clara de lo que hace.

Resultado

Result entrega los mismos datos que se han escrito en la hoja.

Ejemplo

Una inmobiliaria apunta en una hoja los contactos que llegan desde su web:

Un formulario de la web pone en marcha el flujo con el nombre, el teléfono y el inmueble que interesa.
Un componente de datos ordena esos campos.
Google Sheet Writer, con la hoja Contactos web, la pestaña Octubre y Write Mode en append, añade una fila por contacto.

Buenas prácticas

Cada fila sigue el orden de los campos tal como aparecen por primera vez en los datos; si a un elemento le falta un campo, esa celda queda vacía. Si añades a una pestaña que ya tiene filas, envía los campos en el orden de sus columnas.
Usa overwrite solo cuando quieras que la pestaña refleje únicamente el último envío, porque borra lo que había.
Para flujos nuevos, Spread Sheet y Sheet Cells ofrecen más acciones sobre tus hojas.

Componentes relacionados

Spread Sheet: trabaja con hojas de cálculo de Google.
Sheet Cells: lee, añade, cambia y elimina filas de una pestaña.