> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/google-sheets.md).

# 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.

<figure><img src="/files/P3KerDvs2xF7favgxWnn" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Google Sheets na área de trabalho do fluxo no Hyperflow Integrações.</p></figcaption></figure>

***

## 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
5. Arraste o módulo **Google Sheets** para a área de trabalho do fluxo.

<figure><img src="/files/F6J0oVrR53qkl1OprEzo" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Integração expandida e o módulo Google Sheets visível.</p></figcaption></figure>

***

## 🔍 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.

{% hint style="warning" %}
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.
{% endhint %}

<figure><img src="/files/ZHIZG2NAExwXKWqL8F0l" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo Google Sheets aberto.</p></figcaption></figure>

### 🔑 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.

<figure><img src="/files/o5c76hsqbqrsJkKsK4xy" alt=""><figcaption><p>Imagem 4 - Botão de login com o Google no painel de configuração.</p></figcaption></figure>

### 📄 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.

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="/files/ZHIZG2NAExwXKWqL8F0l" alt=""><figcaption><p>Imagem 5 - Seletor de planilhas do Google Drive aberto, com uma planilha selecionada.</p></figcaption></figure>

### 🧩 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.

<figure><img src="/files/FJ3zqNbGJJok9C7CGrvd" alt=""><figcaption><p>Imagem 6 - Campo Método com as opções Inserir linha e Listar linhas.</p></figcaption></figure>

### ➕ 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:

```json
{
  "nome": "{{user.name}}",
  "telefone": "{{input.phone}}"
}
```

{% hint style="warning" %}
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.
{% endhint %}

<figure><img src="/files/znFlJepf7v4MjMJscBna" alt=""><figcaption><p>Imagem 7 - Campo JSON de inserção preenchido com os valores das colunas.</p></figcaption></figure>

### 📋 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.

<figure><img src="/files/xkIoPk0YOyHDPikEObAe" alt=""><figcaption><p>Imagem 8 - Campo JSON de listar linhas preenchido com os valores das colunas.</p></figcaption></figure>

### 🔀 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).

<figure><img src="/files/wef8kHLcAXNRQ0FG9dZi" alt=""><figcaption><p>Imagem 9 - Módulo na área de trabalho do fluxo mostrando as saídas disponíveis.</p></figcaption></figure>

***

## 💡 Caso de uso

**Cenário:** uma empresa quer registrar automaticamente os leads capturados pelo chatbot em uma planilha do Google Sheets.

**Configuração:**

1. Adicione o módulo **Google Sheets** ao fluxo, no ponto onde o cliente já informou nome e telefone.
2. Faça login com a conta Google da empresa e selecione a planilha "Leads".
3. Escolha a aba correspondente e o método **Inserir linha**.
4. Preencha o JSON com `{{user.name}}` e `{{input.phone}}`, correspondendo às colunas já existentes na planilha.
5. 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**.