# Como salvar dados do chat automaticamente em uma planilha do Google?

A função **Adicionar linha ao Google Sheets** permite que seu Assistente atue como um digitador automático. Sempre que coletar informações importantes (como os dados de um cliente, respostas de uma pesquisa ou um novo pedido), a IA pegará esses dados e criará uma **nova linha** no seu Excel na nuvem.

**Para que serve?**

* **Pesquisas**: Salvar satisfação e comentários.
* **Captação de Leads**: Registrar Nome, E-mail e Telefone no seu banco de dados.
* **Pedidos**: Anotar qual produto o cliente pediu e suas especificações.

***

#### ⚠️ Requisito Prévio

Você deve ter criada uma Planilha no Google Sheets e **as colunas devem ter título** na primeira linha (Ex: Nome, E-mail, Produto). Se a planilha estiver em branco, a IA não saberá onde escrever.

***

#### Configuração Passo a Passo

**Passo 1: A Instrução (O Gatilho)**

Primeiro, diga à IA no bloco de texto quando ela deve salvar as informações.

* *Fórmula:* `Quando o cliente terminar de fornecer [Dados X], você deve executar a função [Nome da função]`.

> Exemplo: "Quando o cliente me responder às três perguntas da pesquisa, salve suas respostas executando a função Salvar Pesquisa".

**Passo 2: Conectar a Conta**

Clique em + Adicionar Função, selecione Google Sheets e depois Adicionar linha ao Google Sheets.

<figure><img src="/files/941f19c7300cff029a6eede2856f6faf8445d394" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bfb9d8c4904c766f50a6f9f265c68bebd72d3fce" alt=""><figcaption></figcaption></figure>

1. **Nome e Descrição:** Dê um nome claro (Ex: "Salvar Lead") e, na descrição, repita quando ele é ativado (Ex: "Quando eu tiver os dados do cliente").
2. **Conexão (Token)**: Selecione sua conta do Google.
   * *Se for sua primeira vez:* Clique em Adicionar nova Conta Google.
   * **💡 Dica Importante**: Se você conectar sua conta e ela não aparecer na lista imediatamente, **atualize a página inteira do navegador.** Ao entrar novamente, sua conta já estará disponível para seleção.

**Passo 3: Seleção da Planilha**

Depois que a conta estiver conectada:

1. Selecione a Planilha (Spreadsheet): procure o arquivo pelo nome.
2. Selecione a Aba (Sheet): escolha em qual aba específica os dados serão salvos (Ex: Planilha 1).
3. Clique em Sincronizar (ou espere carregar).

<figure><img src="/files/5ac93a9cfdb9306ad3d28e3ec2407b847dc61ef3" alt=""><figcaption></figcaption></figure>

**Passo 4: Mapeamento de Colunas (A parte vital)**

Aqui você verá uma lista com todas as colunas que seu arquivo tem (Coluna A, B, C...). Você deve dizer à IA o que colocar em cada uma.

Você tem 3 configurações por coluna:

1. **Valor constante? (Opcional)**:
   * Use-o apenas se você quiser que nessa coluna **sempre seja escrito o mesmo valor**, independentemente do que o cliente diga.
   * *Exemplo:* Em uma coluna "Fonte", você poderia colocar o valor fixo "WhatsApp" para saber que todos vêm de lá.
2. **Descrição (Para a IA):**
   * Aqui você deve escrever qual dado a IA deve extrair da conversa para colocá-lo nessa célula.
   * *Exemplo:* "Colocar aqui o e-mail do cliente" ou "Colocar aqui o produto de interesse".
3. **Obrigatório?**
   * Ative este interruptor se o dado for obrigatório. Se a IA não tiver esse dado, tentará obtê-lo antes de executar a função.

Assim fica uma configuração de colunas pronta: Neste exemplo, vemos como as colunas "Modelo", "Nome do serviço", etc. são configuradas, esperando que você adicione a descrição para que a IA saiba o que preencher.

<figure><img src="/files/5874ae70fcaba062bb5e7766c76296ad4d634aa6" alt=""><figcaption></figcaption></figure>

**Passo 5: Verificação**

Clique em Criar e certifique-se de ver o cartão da função abaixo da sua instrução de texto. Pronto! Agora seu assistente preencherá seu Excel para você.

<figure><img src="/files/bb259b29d1ac4aea27dd6e09501da275eee2426e" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.vambe.ai/asistentes-ia/asistentes-ia-pt-br/funcoes/como-guardar-datos-del-chat-automaticamente-en-un-google-sheet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.