Summary
Este guia explica como configurar a ação Google Sheets — Update row no Astra. Esta ação permite que seu agente atualize uma linha existente em uma planilha (aba) do Google Sheets selecionada.
Para garantir que a ação funcione corretamente, a planilha deve conter uma linha de cabeçalho não vazia na parte superior. Esses cabeçalhos definem a estrutura da coluna usada ao atualizar os valores.
Na maioria dos fluxos de trabalho, o agente deve primeiro localizar a linha a ser atualizada usando a ação Google Sheets — Search and find row. Depois que a linha correta é identificada, a ação Update row pode modificar os valores nessa linha.
Antes de configurar esta ação, certifique-se de que sua conta Google esteja conectada ao Astra.
Instructions
Siga estas etapas para configurar a ação Google Sheets — Update row:
Step 1: Open the action template
Faça login em sua conta Astra.
Vá para a Action Library.
Selecione Google Sheets — Update row.
Abra a página de Configuration.
Você configurará várias seções nesta página.
Step 2: Configure the action intent
Na seção Action intent:
Insira um Action name.
Escreva um Intent que explique quando o agente deve atualizar uma linha na planilha.
Why this matters
O intent ajuda o agente a entender quando ele deve usar esta ação.
Instruções claras melhoram a precisão com que o agente aciona a atualização.
Exemplos de casos de uso incluem atualizar o status de um cliente, modificar detalhes do pedido ou alterar informações de lead.
Step 3: Select the Google account
Na seção Google account:
Escolha a conta Google conectada que tem permissão para editar a planilha.
How this works
O Astra usa a conta selecionada para acessar o Google Sheets por meio da autenticação OAuth segura.
A conta deve ter acesso de edição à planilha.
Step 4: Select the spreadsheet and worksheet
Na seção Spreadsheet and worksheet:
Selecione a Drive location.
Escolha a Spreadsheet.
Selecione a Worksheet (tab) onde a linha deve ser atualizada.
Important:
Apenas planilhas localizadas em My Drive ou Shared Drives podem ser usadas com esta ação.
As atualizações serão aplicadas apenas à planilha selecionada.
Additional feature: Offline sync
O Astra também oferece suporte à Offline Sync, que permite que esta ação seja executada após o término de uma conversa em vez de durante a interação ao vivo.
How Offline Sync works
Se Offline Sync estiver habilitado na página Action intent:
A ação é executada uma vez após o término da conversa e um lead é capturado no Astra.
A atualização não ocorre durante o chat ao vivo.
Conversation end conditions
Text agents: A conversa é considerada terminada quando 10 minutos se passaram desde a última mensagem.
Voice agents: A conversa termina quando a call ends.
Quando o Offline Sync está habilitado:
A ação Search and find row não é necessária no fluxo de trabalho do agente.
O Astra processa a atualização automaticamente após a conversa.
What happens when the action runs
Quando a ação é acionada:
O Astra identifica a linha correta na planilha selecionada.
O agente gera valores atualizados com base no contexto do fluxo de trabalho.
Os campos especificados nessa linha são atualizados.
Isso permite que seus fluxos de trabalho mantenham automaticamente dados precisos no Google Sheets, como atualizar registros de clientes, informações de lead ou dados de rastreamento operacional.