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

> Liga o Google Sheets à tua conta Macaly

O Google Sheets é a ferramenta de folhas de cálculo na cloud da Google para dados e colaboração em tempo real. Liga a tua conta uma vez e o agente pode ler e escrever diretamente nas tuas folhas de cálculo, ou usá-las para alimentar painéis e formulários dentro do teu projeto.

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

## Porquê ligar o Google Sheets

* **Transforma submissões de formulários em linhas de folha de cálculo.** Quando alguém se regista no teu site, o agente adiciona automaticamente os seus dados como uma nova linha na tua Google Sheet.
* **Cria um painel a partir dos teus dados.** Lê uma folha como o teu registo de vendas e transforma-a em gráficos e totais dentro do teu projeto, sempre atualizados com o que está na folha.
* **Atualiza folhas de cálculo a partir do chat.** Cria uma folha, encontra uma linha ou atualiza o seu estado sem abrir o Google Sheets.

## O que precisas

* Uma **conta Google** com Google Sheets. Inicia sessão em [sheets.google.com](https://sheets.google.com) se ainda não tiveres uma.

## Ligar o Google Sheets ao Macaly

<Steps>
  <Step title="Abre Definições">
    Vai a **Definições → Integrações** no teu espaço de trabalho Macaly.
  </Step>

  <Step title="Liga o Google Sheets">
    Encontra o cartão do Google Sheets na lista de aplicações e clica no botão **Ligar**.
  </Step>

  <Step title="Autoriza a tua conta">
    Abre-se uma nova janela, onde te será pedido para iniciar sessão na Google. Depois de aprovares o acesso, serás redirecionado de volta para o Macaly.
  </Step>
</Steps>

## Usar o Google Sheets a partir do chat

Depois de ligado, descreve o que queres e o agente trata do resto.

Transforma submissões em linhas automaticamente:

```
Estou a construir um formulário de registo. Quando alguém o submeter, adiciona
o nome e o email como uma nova linha na minha Google Sheet.
```

Cria um painel a partir dos teus dados:

```
Cria um painel que leia a minha Google Sheet "Vendas" e mostre
os totais mensais num gráfico.
```

Atualiza folhas de cálculo diretamente:

```
Cria uma Google Sheet chamada "Orçamento 2026", adiciona uma folha "T1" e
coloca as minhas categorias de despesas na coluna A.
```

```
Na minha folha de cálculo "Leads", encontra a linha da Acme Corp e atualiza
o seu estado para "Ganho".
```

## O que o agente pode fazer no Google Sheets

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

## Bom saber

* **Ligas uma vez.** Todos os projetos no teu espaço de trabalho reutilizam a mesma ligação ao Google Sheets.
* **As edições alteram a tua folha de cálculo real.** O agente escreve e limpa células na folha real, por isso sê específico sobre os intervalos.
* **A tua conta, o teu controlo.** O agente só atua quando lho pedes. Podes desligar o Google Sheets a qualquer momento em **Definições → Integrações**.


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