Resumen
Esta guía explica cómo configurar la acción Google Sheets — Add row en Astra. Esta acción permite que tu agente añada automáticamente una nueva fila a una hoja de cálculo de Google Sheets (pestaña) seleccionada.
Cuando se añade una fila, Astra alinea los valores con los encabezados de columna definidos en la primera fila de la hoja de cálculo. Para asegurar que la acción funcione correctamente, la hoja debe contener una fila de encabezado no vacía en la parte superior que defina los nombres de las columnas.
Antes de configurar esta acción, asegúrate de que tu cuenta de Google esté conectada a Astra.
Instrucciones
Sigue estos pasos para configurar la acción Google Sheets — Add row en Astra:
Paso 1: Abre la plantilla de acción
Inicia sesión en tu cuenta de Astra.
Ve a la Action Library.
Selecciona Google Sheets — Add row.
Abre la pantalla de Configuration.
Configurarás varias secciones en esta página.
Paso 2: Configura el objetivo de la acción
En la sección Action intent:
Introduce un Action name.
Escribe un Intent que describa cuándo debe el agente añadir una fila a la hoja.
Por qué esto es importante
El intent ayuda al agente a entender cuándo activar la acción.
Unas instrucciones claras mejoran la precisión de los flujos de trabajo automatizados.
Por ejemplo, el agente puede añadir una fila cuando se captura un nuevo cliente potencial o cuando se completa una tarea.
Paso 3: Selecciona la cuenta de Google
En la sección Google account:
Elige la cuenta de Google conectada que tiene permiso para editar la hoja de cálculo.
Cómo funciona
Astra utiliza la cuenta seleccionada para acceder a Google Sheets a través de la autenticación OAuth segura.
La cuenta debe tener acceso de edición a la hoja de cálculo.
Paso 4: Selecciona la hoja de cálculo y la hoja de trabajo
En la sección Spreadsheet and worksheet:
Selecciona la Drive location.
Elige la Spreadsheet.
Selecciona la Worksheet (tab) donde se deben añadir las filas.
Importante:
Solo las hojas de cálculo ubicadas en Mi unidad o en Unidades compartidas se pueden usar con esta acción.
Las nuevas filas siempre se añadirán a la hoja de trabajo seleccionada.
Qué sucede cuando se ejecuta la acción
Cuando se activa la acción:
Astra genera los datos de la fila basándose en las instrucciones y el contexto del agente.
Los valores se emparejan con las columnas de encabezado en la hoja.
Se añade una nueva fila a la hoja de cálculo seleccionada.
Esto permite que tus flujos de trabajo registren automáticamente información en Google Sheets, como nuevos clientes potenciales, registros de actividad, solicitudes de soporte o eventos de flujo de trabajo.