Files
..

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:

  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.

    {
      "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:
    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.
    • 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:

  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.