> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Sheets

> Conecte o Google Sheets à sua conta do Macaly

O Google Sheets é a ferramenta de planilhas na nuvem do Google, voltada para dados e colaboração em tempo real. Conecte sua conta uma única vez e o agente passa a ler e escrever nas suas planilhas diretamente, ou as usa para alimentar painéis e formulários dentro do seu projeto.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

## Por que conectar o Google Sheets

* **Transforme envios de formulário em linhas da planilha.** Quando alguém se cadastra no seu site, o agente adiciona os dados da pessoa como uma nova linha na sua planilha do Google Sheets automaticamente.
* **Crie um painel a partir dos seus dados.** Leia uma planilha, como o seu controle de vendas, e transforme-a em gráficos e totais dentro do projeto, sempre atualizados com o que está na planilha.
* **Atualize planilhas pelo chat.** Crie uma planilha, encontre uma linha ou altere o status dela sem abrir o Google Sheets.

## O que você precisa

* Uma **conta Google** com o Google Sheets. Se ainda não tiver, entre em [sheets.google.com](https://sheets.google.com).

## Conecte o Google Sheets ao Macaly

<Steps>
  <Step title="Abra as configurações">
    Acesse **Configurações → Integrações** no seu workspace do Macaly.
  </Step>

  <Step title="Conecte o Google Sheets">
    Encontre o card do Google Sheets na lista de apps e clique no botão **Conectar**.
  </Step>

  <Step title="Autorize sua conta">
    Uma nova janela é aberta e pede que você faça login no Google. Depois que você aprovar o acesso, você volta para o Macaly.
  </Step>
</Steps>

## Use o Google Sheets pelo chat

Depois de conectar, descreva o que você quer e o agente cuida do resto.

Transforme envios em linhas automaticamente:

```
Estou criando um formulário de cadastro. Quando alguém enviar,
adicione o nome e o e-mail da pessoa como uma nova linha na minha
planilha do Google Sheets.
```

Crie um painel com os seus dados:

```
Crie um painel que leia a minha planilha "Vendas" do Google Sheets
e mostre os totais mensais em um gráfico.
```

Atualize planilhas diretamente:

```
Crie uma planilha do Google Sheets chamada "Orçamento 2026",
adicione uma aba "T1" e coloque as minhas categorias de despesa
na coluna A.
```

```
Na minha planilha "Leads", encontre a linha da Acme Corp e altere
o status dela para "Ganho".
```

## O que o agente pode fazer no Google Sheets

Criar planilhas e ler valores de qualquer intervalo, adicionar, atualizar e fazer upsert de linhas, pesquisar, localizar e substituir, ordenar e filtrar, inserir, excluir, ocultar ou redimensionar linhas e colunas, aplicar formatação e validação de dados, e criar e atualizar gráficos.

## Bom saber

* **Você conecta uma vez só.** Todos os projetos do seu workspace usam a mesma conexão com o Google Sheets.
* **As edições alteram a sua planilha de verdade.** O agente escreve e limpa células na planilha real, então seja específico ao indicar os intervalos.
* **Sua conta, seu controle.** O agente só age quando você pede. Você pode desconectar o Google Sheets quando quiser em **Configurações → Integrações**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.