Resumen
Esta guía explica cómo configurar la acción Google Sheets — Update row en Astra. Esta acción permite que tu agente actualice una fila existente en una hoja de cálculo de Google Sheets (pestaña) seleccionada.
Para asegurar que la acción funcione correctamente, la hoja debe contener una fila de encabezado no vacía en la parte superior. Estos encabezados definen la estructura de la columna utilizada al actualizar los valores.
En la mayoría de los flujos de trabajo, el agente primero debe localizar la fila para actualizar usando la acción Google Sheets — Search and find row. Una vez que se identifica la fila correcta, la acción Update row puede modificar los valores en esa fila.
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 — Update row:
Paso 1: Abre la plantilla de acción
Inicia sesión en tu cuenta de Astra.
Ve a la Action Library.
Selecciona Google Sheets — Update row.
Abre la página de Configuration.
Configurarás varias secciones en esta página.
Paso 2: Configura la intención de la acción
En la sección Action intent:
Introduce un Action name.
Escribe un Intent que explique cuándo el agente debe actualizar una fila en la hoja de cálculo.
Por qué esto importa
La intención ayuda al agente a entender cuándo debe usar esta acción.
Las instrucciones claras mejoran la precisión con la que el agente activa la actualización.
Los casos de uso de ejemplo incluyen la actualización del estado de un cliente, la modificación de los detalles del pedido o el cambio de la información del cliente potencial.
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 esto
Astra usa la cuenta seleccionada para acceder a Google Sheets a través de la autenticación segura de OAuth.
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 debe actualizar la fila.
Importante:
Solo se pueden usar con esta acción las hojas de cálculo ubicadas en My Drive o Shared Drives.
Las actualizaciones se aplicarán solo a la hoja de trabajo seleccionada.
Función adicional: Sincronización sin conexión
Astra también admite la sincronización sin conexión, que permite que esta acción se ejecute después de que finaliza una conversación en lugar de durante la interacción en vivo.
Cómo funciona la sincronización sin conexión
Si la sincronización sin conexión está habilitada en la página Action intent:
La acción se ejecuta una vez después de que finaliza la conversación y se captura un cliente potencial en Astra.
La actualización no ocurre durante el chat en vivo.
Condiciones de finalización de la conversación
Agentes de texto: La conversación se considera finalizada cuando han transcurrido 10 minutos desde el último mensaje.
Agentes de voz: La conversación finaliza cuando termina la llamada.
Cuando la sincronización sin conexión está habilitada:
La acción Search and find row no es necesaria en el flujo de trabajo del agente.
Astra procesa la actualización automáticamente después de la conversación.
Qué sucede cuando se ejecuta la acción
Cuando se activa la acción:
Astra identifica la fila correcta en la hoja de trabajo seleccionada.
El agente genera valores actualizados basados en el contexto del flujo de trabajo.
Los campos especificados en esa fila se actualizan.
Esto permite que tus flujos de trabajo mantengan automáticamente datos precisos en Google Sheets, como la actualización de registros de clientes, la información de clientes potenciales o los datos de seguimiento operativo.