AI Email Manager
em n8n

1 Introdução: A Nova Era da Gestão de Emails

A gestão de emails é uma das tarefas mais consumidoras de tempo no dia-a-dia profissional. Com a evolução da IA generativa, é agora possível automatizar grande parte deste processo.

Pré-requisitos

• ✅ Instância n8n (self-hosted ou cloud)
• ✅ Chaves API (OpenAI, Gmail, etc.)
• ✅ Conta de email configurada
• ✅ Conhecimentos básicos de n8n

2 O Que Faz o Teu Sistema de Email com IA?

Funcionalidades Core

Fluxo de Decisão

          Email Recebido
               ↓
           Análise IA
               ↓
      ┌───────┼───────┐
      ↓       ↓       ↓
  Urgente  Normal   Spam
      ↓       ↓       ↓
 Notifica  Rascunho Arquiva

3 Arquitetura: Como Tudo Funciona

Diagrama do Workflow

┌─────────────────────┐
│   📧 Email Trigger   │  (Gmail/IMAP)
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│   🧠 AI/LLM Node     │  (OpenAI GPT-4)
│      Análise        │
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│   🔀 Router Node     │  Classificação
│      (Switch)       │
└──────────┬──────────┘
      ┌────┴────┐
      ↓         ↓
  Urgente    Normal
      ↓         ↓
┌─────────────────────┐
│  ✍️ Response Writer  │  Sub-workflow
│       (AI)          │
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│   📤 Send Email      │  ou Guardar
│       Node          │  Rascunho
└─────────────────────┘

Componentes Principais

1. Email Trigger - Dispara quando chega novo email
2. AI Analyzer - Processa conteúdo com GPT-4/Claude
3. Classification Router - Encaminha baseado na análise
4. Writer Sub-workflow - Gera respostas contextuais
5. Email Sender - Envia ou guarda rascunhos

4 Guia Passo-a-Passo

Vista geral do workflow no n8n

Passo 1: Criar o Workflow Principal

1. Abre o n8n e cria um novo workflow
2. Dá-lhe o nome: AI Email Manager

Passo 2: Adicionar Email Trigger

1. Adiciona um node Gmail Trigger (ou IMAP)
2. Configura:
   • Credential: A tua conta Gmail
   • Poll Time: A cada 1 minuto
   • Labels: INBOX

Passo 3: Adicionar Node de Análise AI

1. Adiciona um node OpenAI (ou AI Agent)
2. Configura o prompt:

Analisa o seguinte email e responde em JSON:
{
  "priority": "high|medium|low",
  "category": "inquiry|complaint|spam|newsletter|personal",
  "requires_response": true|false,
  "sentiment": "positive|neutral|negative",
  "summary": "resumo em 1 linha",
  "suggested_action": "responder|arquivar|encaminhar|eliminar"
}

Email:
Subject: {{ $json.subject }}
From: {{ $json.from }}
Body: {{ $json.body }}

Passo 4: Adicionar Router (Switch)

1. Adiciona node Switch
2. Configura regras:
   • Output 1: {{ $json.priority }} = "high"
   • Output 2: {{ $json.requires_response }} = true
   • Output 3: Fallback (outros)

Passo 5: Criar Sub-workflow Writer

1. Cria novo workflow: Email Writer
2. Adiciona Workflow Input Trigger
3. Adiciona node OpenAI com prompt:

És um assistente de email profissional.
Escreve uma resposta ao seguinte email.

Contexto: {{ $json.context }}
Email original: {{ $json.originalEmail }}
Tom: profissional mas amigável

Responde apenas com o corpo do email, sem saudação inicial.

5 Conectar o Writer (Passo 6)

Configuração do Call n8n Workflow Tool

Configurar Call n8n Workflow Tool

No workflow principal, adiciona um node Call n8n Workflow Tool.

Configuração:

Workflow Inputs

Configura os seguintes inputs:

Opções de Input

• ✅ Define automatically by the model - Deixa o AI decidir
• ✅ Add a description - Melhora a precisão do modelo

6 Testes e Refinamento (Passo 7)

Metodologia de Testes

Fase 1: Testes Simples

1. Enviar emails de teste com diferentes categorias:
   • Email urgente de cliente
   • Newsletter simples
   • Spam óbvio
   • Pergunta técnica
2. Verificar classificação:
   • O email foi categorizado corretamente?
   • A prioridade está certa?

Fase 2: Testes de Resposta

1. Avaliar qualidade das respostas:
   • Tom apropriado?
   • Conteúdo relevante?
   • Gramática correta?
2. Ajustar prompts conforme necessário

Fase 3: Testes de Edge Cases

• Emails em diferentes idiomas
• Emails muito longos
• Anexos (imagens, PDFs)
• Threads de conversação

Checklist de Validação

• Trigger dispara corretamente
• Análise AI retorna JSON válido
• Router encaminha para output correto
• Writer gera respostas coerentes
• Emails são enviados/guardados corretamente

7 Implementação para Negócios

Considerações de Produção

🔐 Segurança

• Guardar API keys em credentials (nunca hardcoded)
• Usar OAuth2 para Gmail
• Limitar permissões do workflow

📈 Escalabilidade

• Configurar rate limits para API
• Usar queue para alto volume
• Monitorizar custos da API

🔧 Manutenção

• Logs para debugging
• Alertas para erros
• Backup regular de workflows

ROI Esperado