# 📊 Instruções para Integração com Google Sheets

Este guia vai te ajudar a configurar a integração do formulário com uma planilha do Google Sheets para receber os leads automaticamente.

## 🎯 Método Recomendado: Google Apps Script (Web App)

Este é o método mais simples e seguro, não requer autenticação complexa.

### Passo 1: Criar a Planilha no Google Sheets

1. Acesse [Google Sheets](https://sheets.google.com)
2. Crie uma nova planilha
3. Na primeira linha, adicione os cabeçalhos:
   ```
   Data/Hora | Nome | CNPJ | Telefone | Cidade | Segmento | Volume | IP
   ```
4. Dê um nome para a planilha (ex: "Leads GIMAK GK2100")
5. Copie o ID da planilha da URL:
   - A URL será algo como: `https://docs.google.com/spreadsheets/d/SEU_ID_AQUI/edit`
   - Copie o `SEU_ID_AQUI`

### Passo 2: Criar o Google Apps Script

1. Na planilha, vá em **Extensões** → **Apps Script**
2. Apague todo o código padrão e cole o código abaixo:

```javascript
function doPost(e) {
  try {
    // Obter a planilha ativa
    const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
    
    // Obter os dados enviados
    const data = JSON.parse(e.postData.contents);
    
    // Preparar os dados para inserir na planilha
    const row = [
      data.data || new Date().toLocaleString('pt-BR'),
      data.nome || '',
      data.cnpj || '',
      data.telefone || '',
      data.cidade || '',
      data.segmento || '',
      data.volume || '',
      data.ip || ''
    ];
    
    // Adicionar a linha na planilha
    sheet.appendRow(row);
    
    // Retornar sucesso
    return ContentService.createTextOutput(JSON.stringify({
      status: 'success',
      message: 'Dados inseridos com sucesso'
    })).setMimeType(ContentService.MimeType.JSON);
    
  } catch (error) {
    // Retornar erro
    return ContentService.createTextOutput(JSON.stringify({
      status: 'error',
      message: error.toString()
    })).setMimeType(ContentService.MimeType.JSON);
  }
}

function doGet(e) {
  return ContentService.createTextOutput('Web App funcionando! Use POST para enviar dados.');
}
```

3. Clique em **Salvar** (💾) e dê um nome ao projeto (ex: "Integração Leads GIMAK")

### Passo 3: Implantar como Web App

1. Clique em **Implantar** → **Nova implantação**
2. Clique no ícone de engrenagem ⚙️ ao lado de "Tipo" e selecione **Aplicativo da Web**
3. Configure:
   - **Descrição**: "Integração Leads GIMAK"
   - **Executar como**: "Eu"
   - **Quem tem acesso**: "Qualquer pessoa" (importante!)
4. Clique em **Implantar**
5. Autorize o acesso quando solicitado:
   - Clique em **Revisar permissões**
   - Selecione sua conta Google
   - Clique em **Avançado** → **Ir para [nome do projeto] (não seguro)**
   - Clique em **Permitir**
6. **COPIE A URL DO WEB APP** que aparecerá (algo como: `https://script.google.com/macros/s/AKfycby.../exec`)

### Passo 4: Configurar no Site

1. Abra o arquivo `config.php` no seu servidor
2. Cole a URL copiada no campo `GOOGLE_SHEETS_WEB_APP_URL`:

```php
define('GOOGLE_SHEETS_WEB_APP_URL', 'https://script.google.com/macros/s/SUA_URL_AQUI/exec');
```

3. Certifique-se de que `GOOGLE_SHEETS_ENABLED` está como `true`:

```php
define('GOOGLE_SHEETS_ENABLED', true);
```

4. Salve o arquivo

### Passo 5: Testar

1. Preencha o formulário no site
2. Envie o formulário
3. Verifique se os dados aparecem na planilha do Google Sheets

## ✅ Pronto!

Agora todos os leads serão automaticamente adicionados à sua planilha do Google Sheets em tempo real!

## 🔧 Solução de Problemas

### Os dados não estão aparecendo na planilha

1. Verifique se a URL do Web App está correta no `config.php`
2. Verifique se `GOOGLE_SHEETS_ENABLED` está como `true`
3. Verifique os logs do servidor (arquivo de erro do PHP)
4. Teste a URL do Web App diretamente no navegador (deve mostrar "Web App funcionando!")

### Erro de permissão

1. Certifique-se de que o Web App está configurado como "Qualquer pessoa"
2. Refaça a autorização de permissões no Google Apps Script

### Erro 401 ou 403

1. Verifique se você autorizou o acesso quando criou o Web App
2. Tente criar uma nova implantação do Web App

## 📝 Notas Importantes

- Os dados continuam sendo salvos no arquivo CSV local (backup)
- Os dados também continuam sendo enviados por email (se configurado)
- A integração com Google Sheets é adicional e não substitui os outros métodos
- A planilha pode ser compartilhada com sua equipe normalmente

## 🔒 Segurança

- A URL do Web App é pública, mas apenas aceita dados no formato correto
- Considere adicionar uma chave de autenticação simples se necessário
- Os dados são enviados via HTTPS (seguro)

---

**Dúvidas?** Entre em contato com o suporte técnico.

