# 🚀 Configurar Google Sheets - Passo a Passo Completo

## ⏱️ Tempo estimado: 5-10 minutos

---

## 📋 PASSO 1: Abrir sua Planilha do Google Sheets

1. Acesse sua planilha:
   🔗 **https://docs.google.com/spreadsheets/d/1oDyIz0ApP3v3RPVShZIt-B_q1kAmBIq-BKkM9fTPFl4/edit**

2. **IMPORTANTE:** Verifique se existe a aba chamada **"Leads - Site"**
   - Se não existir, crie uma nova aba com esse nome exato
   - A primeira linha deve ter os cabeçalhos (já deve estar configurado)

---

## 📋 PASSO 2: Abrir o Google Apps Script

1. Na sua planilha, clique em **Extensões** (no menu superior)
2. Clique em **Apps Script**
3. Uma nova aba será aberta com o editor de código

---

## 📋 PASSO 3: Colar o Código

1. **Abra o arquivo:** `google_apps_script_code.js` (está na pasta do projeto)

2. **Copie TODO o código** (Ctrl+A, depois Ctrl+C)

3. **No editor do Apps Script:**
   - Apague qualquer código que já existir
   - Cole o código copiado (Ctrl+V)

4. **Clique em Salvar** 💾 (ícone de disquete ou Ctrl+S)

5. **Dê um nome ao projeto** (ex: "GIMAK Leads Integration")

---

## 📋 PASSO 4: Criar o Web App

1. No editor do Apps Script, clique em **Implantar** (botão azul no canto superior direito)
2. Clique em **Nova implantação**
3. Clique no ícone de engrenagem ⚙️ ao lado de "Tipo"
4. Selecione **Aplicativo da Web**

### Configurações do Web App:

- **Descrição:** (opcional) "Integração GIMAK Leads"
- **Executar como:** Selecione **Eu**
- **Quem tem acesso:** Selecione **Qualquer pessoa** ⚠️ (IMPORTANTE!)
- Clique em **Implantar**

---

## 📋 PASSO 5: Autorizar o Aplicativo

1. Uma janela de autorização aparecerá
2. Clique em **Autorizar acesso**
3. Escolha sua conta do Google
4. Clique em **Avançado** (se aparecer)
5. Clique em **Ir para [nome do projeto] (não seguro)** (é seguro, é do Google)
6. Clique em **Permitir**

---

## 📋 PASSO 6: Copiar a URL do Web App

1. Após autorizar, você verá uma tela com a URL do Web App
2. **COPIE A URL COMPLETA** (ela começa com `https://script.google.com/macros/s/...`)
3. **IMPORTANTE:** Copie a URL inteira, não apenas parte dela

A URL deve ter este formato:
```
https://script.google.com/macros/s/AKfycbyXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/exec
```

---

## 📋 PASSO 7: Configurar no Site

Você tem **2 opções** para configurar:

### Opção A: Usar o Configurador Automático (MAIS FÁCIL) ⭐

1. Acesse: `http://localhost/gimaklp/configurar_automatico.php`
2. Cole a URL que você copiou no campo
3. Clique em **Salvar URL**
4. Pronto! ✅

### Opção B: Editar Manualmente o config.php

1. Abra o arquivo `config.php`
2. Encontre a linha 26:
   ```php
   define('GOOGLE_SHEETS_WEB_APP_URL', ''); // Cole aqui a URL do seu Google Apps Script Web App
   ```
3. Cole a URL entre as aspas:
   ```php
   define('GOOGLE_SHEETS_WEB_APP_URL', 'https://script.google.com/macros/s/SUA_URL_AQUI/exec');
   ```
4. Salve o arquivo

---

## 📋 PASSO 8: Testar a Integração

1. Acesse: `http://localhost/gimaklp/testar_integracao.php`
2. Clique em **🚀 Testar Envio de Dados**
3. Aguarde alguns segundos
4. Se aparecer **✅ Sucesso!**, está funcionando!
5. **Verifique sua planilha** - deve aparecer uma nova linha com os dados de teste

---

## ✅ PRONTO!

Agora, sempre que alguém preencher o formulário no site, os dados serão **automaticamente salvos** na sua planilha do Google Sheets na aba **"Leads - Site"**!

---

## 🐛 Problemas Comuns

### ❌ Erro: "URL não configurada"
- **Solução:** Verifique se você colou a URL completa no `config.php`
- Use o configurador automático: `configurar_automatico.php`

### ❌ Erro: "Acesso negado"
- **Solução:** Verifique se você selecionou **"Qualquer pessoa"** ao criar o Web App
- Crie uma nova implantação e selecione "Qualquer pessoa"

### ❌ Erro: "Aba não encontrada"
- **Solução:** Crie uma aba chamada **"Leads - Site"** na sua planilha
- O nome deve ser exatamente esse (com maiúsculas e minúsculas)

### ❌ Dados não aparecem na planilha
- **Solução:** 
  1. Verifique se a URL está correta
  2. Teste usando `testar_integracao.php`
  3. Verifique os logs do Apps Script (Execuções no menu lateral)

---

## 📞 Precisa de Ajuda?

- **Guia Visual:** Abra `configurar_google_sheets.html` no navegador
- **Configurador Automático:** `configurar_automatico.php`
- **Teste:** `testar_integracao.php`

---

## 🎯 Checklist Final

- [ ] Planilha aberta e aba "Leads - Site" criada
- [ ] Código colado no Apps Script
- [ ] Web App criado e configurado como "Qualquer pessoa"
- [ ] Aplicativo autorizado
- [ ] URL copiada
- [ ] URL configurada no site (config.php ou configurar_automatico.php)
- [ ] Teste realizado com sucesso
- [ ] Dados aparecem na planilha

**Tudo marcado? Pronto para receber leads! 🎉**

