# Integração Google (Agenda, Planilhas e Meet)

Conecte o **Google** ao SimplesDesk com um clique e destrave três frentes: **Google Agenda** (agendamentos com a IA e nos fluxos), **Google Planilhas** (ler, escrever e — o mais poderoso — **disparar mensagens a partir das linhas da planilha**) e o **Google Meet** nos agendamentos. Este guia explica a conexão e, em detalhe, a régua de disparos por planilha (ex.: confirmação de consultas).

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **Google**.
2. Clique em **Conectar com Google** e autorize com a conta desejada (a que tem acesso às planilhas/agendas).
3. Pronto — a conexão vale para a conta toda. Na mesma página você configura os calendários e as planilhas.

> 💡 A autorização usa a credencial central da plataforma — você não precisa criar nada no Google Cloud.

## Seção Calendário

Marque quais calendários da conta conectada a plataforma pode usar. A IA e o nó de fluxo **Criar evento (Agenda)** consultam a disponibilidade em **todos os calendários marcados** e criam eventos no calendário escolhido (com link do Meet opcional).

## Seção Planilhas

Clique em **Escolher planilha do Drive**: a lista das suas planilhas aparece automaticamente — selecione uma, escolha a **aba** e adicione. (Se preferir, dá para informar o ID manualmente.) As planilhas cadastradas aqui ficam disponíveis nos fluxos e para o Agente de IA.

**O que a IA passa a fazer com Planilhas:** buscar linhas por valor, calcular (soma, média, contagem…), adicionar linha e atualizar célula — útil para consultas rápidas tipo "qual o total de vendas da aba Março?".

**Nós de fluxo disponíveis:** Buscar linha (com saídas encontrado/não encontrado), Adicionar linha, Atualizar linha e Criar evento (Agenda).

---

## Disparos a partir da planilha (o caso mais poderoso)

No editor de fluxos, use o gatilho **Disparo agendado** com a fonte **Planilha Google**. Todos os dias, no horário configurado, a plataforma lê a planilha e **cada linha vira um disparo individual** — como se cada linha fosse um agendamento (o "ID" é o número da linha). Até 500 linhas por execução.

### Toda coluna vira variável — automaticamente

Ao escolher a planilha e a aba no painel da fonte, as colunas são lidas na hora e aparecem como **seletores** (nada de digitar nome de coluna) — e um quadro mostra as **variáveis prontas para copiar**. Exemplo: a coluna "Horário Agendamento" vira `{{variables.sheets_horario_agendamento}}`, para usar direto na mensagem:

> Olá {{variables.sheets_nome}}, sua consulta de {{variables.sheets_especialidade}} com {{variables.sheets_profissional}} é amanhã às {{variables.sheets_horario_agendamento}}. Confirma?

### Os 3 filtros da fonte (quem recebe — sem precisar de nó de condição)

| Filtro | Exemplo | O que faz |
| --- | --- | --- |
| **Coluna de data** + "Consultas de quando" | `Data_Agendamento` + Amanhã | Só linhas cuja data é o dia-alvo (aceita dd/mm/aaaa) |
| **Coluna = valor** | `Status_Agendamento` = Agendado | Ignora cancelados/remarcados |
| **Coluna vazia** | `Flag_Enviado` vazia | Só linhas ainda não disparadas — o anti-reenvio |

### Quem recebeu hoje não recebe de novo amanhã (dupla proteção)

1. **A flag na própria planilha**: termine o fluxo com o nó **Atualizar linha (Sheets)** gravando a data na coluna de flag (use `{{variables.sheets_linha}}` como referência da linha). No dia seguinte, a linha está marcada e o filtro "coluna vazia" a descarta — e você **vê na planilha** quem recebeu e quando;
2. **Trava automática**: mesmo que a gravação falhe, a plataforma bloqueia o redisparo da mesma linha por 7 dias.

### Receita completa: confirmação de consulta

1. Gatilho **Disparo agendado** — todo dia às 9h;
2. Fonte **Planilha Google** → planilha + aba; telefone = `Telefone`; data = `Data_Agendamento` + **Amanhã**; filtro `Status_Agendamento` = Agendado; coluna vazia = `Flag_Confirmacao_Enviada`;
3. **Enviar Mensagem** (template com botões Confirmar / Remarcar) usando as variáveis das colunas;
4. **Atualizar linha (Sheets)** → grava a data em `Flag_Confirmacao_Enviada`;
5. As respostas caem na conversa normalmente — dá para encaminhar a um time ou entregar ao **Agente de IA** para tratar remarcações.

### Boas práticas

- **Não apague nem insira linhas no meio da planilha** — adicione sempre no fim. A flag na coluna é a garantia definitiva; mudanças de posição das linhas confundem a trava técnica;
- Datas nas células em **dd/mm/aaaa** (ou aaaa-mm-dd);
- A primeira linha da planilha deve ser o **cabeçalho** (nomes das colunas);
- Precisa de mais de 500 linhas/dia? Fale com o suporte.

> 📗 Veja também os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de disparo agendado.

> 📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.