Tutorial Completo

Aprenda como configurar e usar o serviço de email temporário em modo local ou online

Modo Online (Recomendado)

Vantagens do Modo Online

  • • Não requer configuração de servidor local
  • • Funciona imediatamente
  • • Emails de teste integrados
  • • API webhook disponível

Como usar:

1. Gerar Email

Acesse a página "Edu Mail Generator" e crie um email temporário

2. Testar Funcionamento

Use o botão "Test Email" para enviar um email de teste

3. Usar API Webhook

Integre com sistemas externos usando nossa API webhook

4. Receber Emails

Visualize emails recebidos em tempo real na interface

Exemplo de uso da API Webhook:

curl -X POST https://your-app.vercel.app/api/temp-email/webhook \
  -H "Content-Type: application/json" \
  -d '{
    "to": "teste@splice.edu.pl",
    "from": "sender@example.com",
    "subject": "Test Subject",
    "body": "Email content here",
    "apiKey": "splice-webhook-key"
  }'
Modo Local (Avançado)

Requisitos

  • • Servidor com acesso root/administrador
  • • Controle sobre DNS do domínio splice.edu.pl
  • • Conhecimento básico de administração de servidor
  • • IP público estático

Configuração no Windows

Opção 1: WSL2 (Recomendado)

1. Instalar WSL2:

# Execute como Administrador no PowerShell
wsl --install
# Reinicie o computador

2. Configurar Ubuntu no WSL2:

# Dentro do WSL2
sudo apt update
sudo apt install postfix mailutils nodejs npm

3. Seguir configuração Linux abaixo

Opção 2: IIS SMTP Nativo

1. Instalar IIS SMTP:

# Execute como Administrador no PowerShell
Enable-WindowsOptionalFeature -Online -FeatureName IIS-SMTP

2. Configurar IIS SMTP:

  • Abra "Gerenciador do IIS"
  • Configure o servidor SMTP para aceitar emails para splice.edu.pl
  • Configure entrega para pasta local

Configuração no Linux (Ubuntu/Debian)

1. Instalar Postfix

sudo apt update
sudo apt install postfix mailutils nodejs npm
# Durante a instalação, escolha "Internet Site"
# Configure o domínio como "splice.edu.pl"

2. Configurar Postfix

Edite /etc/postfix/main.cf:

# Configurações básicas
myhostname = mail.splice.edu.pl
mydomain = splice.edu.pl
myorigin = $mydomain
inet_interfaces = all
mydestination = $myhostname, localhost.$mydomain, localhost, $mydomain

# Configuração para aceitar todos os usuários
local_recipient_maps =
luser_relay = splice@localhost

# Configuração de entrega local
virtual_alias_domains = splice.edu.pl
virtual_alias_maps = hash:/etc/postfix/virtual

3. Configurar Aliases Virtuais

Edite /etc/postfix/virtual:

@splice.edu.pl splice@localhost

Compile o arquivo:

sudo postmap /etc/postfix/virtual
sudo systemctl restart postfix

4. Configurar Worker de Processamento

# Instalar dependências
npm install mailparser chokidar

# Executar o worker
node scripts/email-worker.js

Configuração DNS

Configure os seguintes registros DNS no provedor do domínio splice.edu.pl:

TipoNomeValorTTL
A@SEU_IP_PUBLICO300
AmailSEU_IP_PUBLICO300
MX@mail.splice.edu.pl300
TXT@"v=spf1 ip4:SEU_IP_PUBLICO ~all"300
Teste e Verificação

Como testar se está funcionando:

Modo Online

  1. Gere um email temporário
  2. Clique em "Test Email"
  3. Aguarde alguns segundos
  4. Verifique se aparece na inbox

Modo Local

  1. Gere um email temporário
  2. Envie email real de outro cliente
  3. Clique em "Refresh"
  4. Verifique se aparece na inbox

Verificador DNS Integrado

Use o verificador DNS na página inicial para confirmar se os registros foram configurados corretamente. Ele mostra em tempo real o status de cada registro DNS necessário.

Solução de Problemas

Emails não estão sendo recebidos (Modo Local)

  • Verifique se o Postfix está rodando: sudo systemctl status postfix
  • Verifique os logs: sudo tail -f /var/log/mail.log
  • Teste conectividade: telnet mail.splice.edu.pl 25
  • Verifique se o worker está rodando

DNS não está propagando

  • Aguarde até 24 horas para propagação completa
  • Verifique registros MX: nslookup -type=MX splice.edu.pl
  • Verifique registros A: nslookup mail.splice.edu.pl
  • Use o verificador DNS integrado na interface

Modo Online não funciona

  • Verifique se as variáveis de ambiente estão configuradas
  • Teste a API webhook manualmente
  • Verifique os logs da aplicação
  • Confirme se o Supabase está conectado