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:
- Frontend (Interface do Usuário): O que você vê e interage no navegador. Usado para configurar, visualizar resultados e acionar análises manuais.
- 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. - 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
-
Pré-requisitos:
- Tenha uma conta no Google Cloud Platform com faturação ativa.
- Instale e configure o Google Cloud SDK (gcloud CLI).
-
Crie um arquivo
package.jsonna 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.tspara JavaScript (api/scan.js) antes de implementar, ou usar um builder que suporte TypeScript no Cloud Run. -
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.
-
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:trueoufalse.
Passo 2: Configurar o Google Cloud Scheduler
-
Vá para o Cloud Scheduler:
- No console do Google Cloud, navegue para a secção Cloud Scheduler.
-
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.