# Limpador de E-mail com IA - Guia de Implementação Backend

Este guia explica como implementar a automação de backend para que a limpeza de e-mails funcione 24/7, utilizando Google Cloud Run e Cloud Scheduler.

## Arquitetura

A aplicação agora consiste em duas partes principais:

1.  **Frontend (Interface do Usuário):** O que você vê e interage no navegador. Usado para configurar, visualizar resultados e acionar análises manuais.
2.  **Backend (Lógica de Automação):** Um serviço sem servidor (`api/scan.ts`) que contém a lógica para analisar e-mails e limpar tickets. Este serviço é projetado para ser executado no Google Cloud Run.
3.  **Cloud Scheduler (Gatilho):** Um serviço da Google Cloud que aciona (chama) o nosso backend em intervalos regulares (a cada 2 horas).

---

## Passo 1: Implementar o Backend no Google Cloud Run

1.  **Pré-requisitos:**
    *   Tenha uma conta no [Google Cloud Platform](https://cloud.google.com/) com faturação ativa.
    *   Instale e configure o [Google Cloud SDK (gcloud CLI)](https://cloud.google.com/sdk/docs/install).

2.  **Crie um arquivo `package.json`** na raiz do seu projeto com o seguinte conteúdo. Isto é necessário para que o Cloud Run saiba como iniciar o seu serviço.

    ```json
    {
      "name": "email-cleaner-backend",
      "version": "1.0.0",
      "main": "api/scan.js",
      "scripts": {
        "start": "node api/scan.js"
      },
      "dependencies": {
        "@google/genai": "^1.16.0"
      }
    }
    ```
    *Nota: Você precisará compilar o `api/scan.ts` para JavaScript (`api/scan.js`) antes de implementar, ou usar um builder que suporte TypeScript no Cloud Run.*

3.  **Implemente o Serviço:**
    *   Abra o terminal na raiz do seu projeto.
    *   Execute o seguinte comando para implementar a função que está em `api/scan.ts`:

    ```bash
    gcloud run deploy email-cleaner-service --source . --region=us-central1 --allow-unauthenticated
    ```
    *   Siga as instruções no terminal. O comando `--allow-unauthenticated` é usado para permitir que o Cloud Scheduler chame o seu serviço. Em produção, você pode configurar um método de autenticação mais seguro.

4.  **Configure as Variáveis de Ambiente:**
    *   Após a implementação, vá para o [console do Cloud Run](https://console.cloud.google.com/run).
    *   Encontre o seu serviço (`email-cleaner-service`) e clique nele.
    *   Clique em "Editar e Implementar Nova Revisão".
    *   Vá para a aba **"Variáveis e Segredos"**.
    *   Adicione as seguintes variáveis de ambiente com os seus valores correspondentes:
        *   `GEMINI_API_KEY`: A sua chave da API do Google Gemini.
        *   `PERFEX_CRM_URL`: A URL da sua API do Perfex CRM.
        *   `PERFEX_CRM_TOKEN`: O seu token da API do Perfex CRM.
        *   `PERFEX_AUTO_DELETE_TICKETS`: `true` ou `false`.

---

## Passo 2: Configurar o Google Cloud Scheduler

1.  **Vá para o Cloud Scheduler:**
    *   No console do Google Cloud, navegue para a secção [Cloud Scheduler](https://console.cloud.google.com/cloudscheduler).

2.  **Crie uma Tarefa (Job):**
    *   Clique em "Criar Tarefa".
    *   **Nome:** Dê um nome, por exemplo, `run-email-scan`.
    *   **Frequência:** Defina a frequência usando a sintaxe cron. Para "a cada 2 horas", use: `0 */2 * * *`.
    *   **Fuso Horário:** Selecione o seu fuso horário.
    *   **Destino:** Selecione `HTTP`.
    *   **URL:** Cole a URL do seu serviço Cloud Run que foi gerada no passo anterior.
    *   **Método HTTP:** Selecione `POST`.
    *   **Corpo:** Deixe em branco.
    *   Clique em "Criar".

---

## Conclusão

É isso! Agora, o Cloud Scheduler irá chamar o seu serviço no Cloud Run a cada 2 horas. O serviço Cloud Run irá então executar a lógica de análise de e-mails e limpeza de tickets do CRM, de forma totalmente automática e independente do seu navegador.
