Google Sheets
O módulo Google Sheets permite inserir novas linhas ou listar dados de uma planilha do Google Sheets sem sair do fluxo. É útil para registrar informações coletadas durante a conversa (como cadastro de leads) ou consultar dados já existentes em uma planilha.
📷 Inserir print: visão geral do módulo Google Sheets na área de trabalho do fluxo
🧭 Como acessar
No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria Integração (identificada pela cor azul).
Arraste o módulo Google Sheets para a área de trabalho do fluxo.
📷 Inserir print: painel de módulos com a categoria Integração expandida e o módulo Google Sheets visível
🔍 Conhecendo o módulo
Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.
Diferente de outros módulos de integração, o Google Sheets não usa uma credencial cadastrada previamente em Integrações — cada módulo Google Sheets tem seu próprio login com uma conta Google.
📷 Inserir print: painel de configuração do módulo Google Sheets aberto
🔑 Fazer login com o Google
Ao adicionar o módulo, você verá um botão para entrar com sua conta Google. Faça login e autorize o acesso às suas planilhas.
📷 Inserir print: botão de login com o Google no painel de configuração
📄 Selecionar a planilha e a aba
Depois de fazer login, clique em Selecionar planilha no Google Drive para escolher, através do seletor de arquivos do Google, qual planilha será usada. Em seguida, escolha a aba dentro dessa planilha.
Somente planilhas que você já tem acesso de edição (ou que você selecionar através da própria janela de seleção) ficam disponíveis para o módulo.
📷 Inserir print: seletor de planilhas do Google Drive aberto, com uma planilha selecionada
🧩 Método
Escolha o que o módulo vai fazer:
Inserir linha — adiciona uma nova linha à aba selecionada.
Listar linhas — retorna os dados já existentes na aba selecionada.
📷 Inserir print: campo Método com as opções Inserir linha e Listar linhas
➕ Inserir linha
Ao escolher esta opção, o painel exibe automaticamente um modelo em JSON com os nomes das colunas já existentes na primeira linha da planilha. Preencha os valores de cada coluna, usando variáveis do fluxo se quiser. Exemplo:
Só são preenchidas as colunas que já existem na primeira linha da planilha (o cabeçalho). Se você incluir uma coluna que não existe na planilha, ela é simplesmente ignorada — o módulo não cria colunas novas automaticamente.
📷 Inserir print: campo JSON de inserção preenchido com os valores das colunas
📋 Listar linhas
Ao escolher esta opção, o painel mostra uma prévia das colunas da planilha, permitindo renomear cada uma delas — esses novos nomes são usados apenas na forma como os dados chegam ao fluxo, sem alterar a planilha original.
📷 Inserir print: tabela de prévia com os cabeçalhos sendo renomeados
🔀 Saídas do módulo
O módulo tem duas saídas:
Sucesso — a operação foi concluída (linha inserida ou dados retornados).
Erro — não foi possível concluir a operação (ex.: sessão do Google expirada, planilha ou aba não encontrada).
📷 Inserir print: módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro
💡 Caso de uso
Cenário: uma empresa quer registrar automaticamente os leads capturados pelo chatbot em uma planilha do Google Sheets.
Configuração:
Adicione o módulo Google Sheets ao fluxo, no ponto onde o cliente já informou nome e telefone.
Faça login com a conta Google da empresa e selecione a planilha "Leads".
Escolha a aba correspondente e o método Inserir linha.
Preencha o JSON com
{{user.name}}e{{input.phone}}, correspondendo às colunas já existentes na planilha.Conecte a saída Sucesso para a continuidade do atendimento.
Resultado: cada novo lead capturado pelo bot é automaticamente registrado como uma nova linha na planilha "Leads".
📌 Dicas úteis
Garanta que a primeira linha da planilha já tenha os nomes das colunas antes de usar o módulo — colunas novas não são criadas automaticamente.
Se a conexão com o Google parar de funcionar (por exemplo, após revogar o acesso ou trocar a senha da conta), será necessário refazer o login no módulo.
No método Listar linhas, todas as linhas da aba são retornadas — evite usar em planilhas muito grandes se não for necessário.
O módulo não devolve os dados da linha recém-inserida — se precisar usar essas informações depois no fluxo, mantenha-as em uma variável antes de enviar.
📝 Resumo
O módulo Google Sheets insere ou lista linhas em uma planilha do Google Sheets.
Cada módulo tem seu próprio login com uma conta Google — não usa a tela central de Integrações.
No método Inserir linha, só são preenchidas colunas que já existem na planilha.
No método Listar linhas, é possível renomear os cabeçalhos apenas para uso no fluxo, sem alterar a planilha.
O módulo tem uma saída de Sucesso e uma de Erro.