> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração do Treble.ai com Google Sheets

> Conecte suas conversas com planilhas para salvar e atualizar dados automaticamente.

Olá!
Neste guia você aprenderá como conectar o **Treble** com o **Google Sheets** para **atualizar** e **obter variáveis** de uma planilha do Google.

Esta integração permite automatizar o gerenciamento de dados das suas conversas no Treble usando uma planilha do Google Sheets como banco de dados.

## Ativar a integração

1. Crie uma planilha no **Google Sheets**.

   *Recomendado:* deixe com **permissão pública para editar**.

<Tip>
  Se preferir mantê-la privada, você encontrará as instruções para fazer isso
  abaixo.
</Tip>

2. No **Editor de Fluxos de Conversa** do Treble, clique no ícone do quebra-cabeças <Icon icon="puzzle-piece" iconType="solid" />.

3. Selecione a opção **Google Sheets**.

4. Cole a **URL** da sua planilha no campo de texto.

<img src="https://mintcdn.com/trebleai/Ztu_Dm5jEzojdr31/images/sheets-1.gif?s=32139df7b58be8a528c4847985544bde" alt="Ativar integração sheets" width="2368" height="1150" data-path="images/sheets-1.gif" />

## Formato exigido na planilha

Esta integração exige que sua planilha tenha as seguintes duas colunas na primeira linha:

`country_code` e `cellphone` que são usadas para identificar cada usuário. As colunas seguintes são usadas para obter ou salvar informações sobre esse usuário.

<img src="https://mintcdn.com/trebleai/Ztu_Dm5jEzojdr31/images/sheets-2.png?fit=max&auto=format&n=Ztu_Dm5jEzojdr31&q=85&s=5bfc027a6a6536c3b1c0f03ece9ff133" alt="Formato planilha sheets" width="500px" data-path="images/sheets-2.png" />

## Consultar variáveis da Sheets

Para **obter uma variável** da planilha, você deve usar o seguinte formato dentro da conversa:

`sheets_nombre_variable`

Por exemplo, se você tem uma coluna `name`, pode usar a variável `sheets_name` para cumprimentar o usuário:

```text theme={null}
Olá {{sheets_name}}, como você está?
```

<img src="https://mintcdn.com/trebleai/Ztu_Dm5jEzojdr31/images/sheets-3.png?fit=max&auto=format&n=Ztu_Dm5jEzojdr31&q=85&s=9ac1ad9f571605819c99f5b13a6a0466" alt="Consultar variável sheets" width="400px" data-path="images/sheets-3.png" />

## Salvar respostas na Sheets

Para salvar o que o usuário responde na conversa, use o mesmo formato de variável `sheets_nombre_variable`, e marque a opção **"Salvar resposta como variável"** no fluxo.

<img src="https://mintcdn.com/trebleai/Ztu_Dm5jEzojdr31/images/sheets-4.png?fit=max&auto=format&n=Ztu_Dm5jEzojdr31&q=85&s=85e13a515ce60158bbc159c00ebfed13" alt="Salvar variável sheets" width="1710" height="1178" data-path="images/sheets-4.png" />

## Salvar o horário da resposta

Se quiser registrar quando uma resposta foi salva, crie outra coluna com o prefixo `time_`

Por exemplo:

* Se você tem a variável `name`, crie outra coluna chamada `time_name`.

O Treble salvará automaticamente a data e hora quando o usuário responder.

<img src="https://mintcdn.com/trebleai/Ztu_Dm5jEzojdr31/images/sheets-5.png?fit=max&auto=format&n=Ztu_Dm5jEzojdr31&q=85&s=03ebf662a6255cace116ccc66cb2e048" alt="Salvar horário resposta sheets" width="1124" height="316" data-path="images/sheets-5.png" />

## Planilhas com permissões restritas

Se não quiser que sua planilha seja pública, você deve compartilhá-la com **os três endereços de email oficiais do Treble**:

```text theme={null}
treble-sheets@treble-ai.iam.gserviceaccount.com
treble-sheets@treble-ai-2.iam.gserviceaccount.com
treble@treble-ai-sheets.iam.gserviceaccount.com
```

<img src="https://mintcdn.com/trebleai/Ztu_Dm5jEzojdr31/images/sheets-6.png?fit=max&auto=format&n=Ztu_Dm5jEzojdr31&q=85&s=0d15404e16560f99b85d4ff9a3dafa65" alt="Salvar horário resposta sheets" width="565" height="331" data-path="images/sheets-6.png" />

## Limitações

* **Máximo de colunas suportadas**: até a coluna ZZ.
* **Limites de velocidade (`rate limit`) do Google Sheets**:
  * G Suite: 5 solicitações por segundo
  * Gmail normal: 1 solicitação por segundo

Se esses limites forem excedidos, alguns dados podem ser perdidos.