ealmeida
e7adb65d40
Normalizacao OKF dos .md: type/title/description/timestamp/layer + descriptions factuais (rich abstracts). Apenas .md tracked; corpos intactos. Parte da aplicacao OKF a /Dados/Dev (28-06-2026). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
89 lines
4.0 KiB
Markdown
Executable File
89 lines
4.0 KiB
Markdown
Executable File
---
|
|
type: Reference
|
|
title: Readme
|
|
description: >-
|
|
Este guia explica como implementar a automação de backend para que a limpeza de e-mails funcione 24/7, utilizando Google…
|
|
timestamp: 2025-08-29T20:06:08+00:00
|
|
layer: wiki
|
|
---
|
|
# 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.
|