sgse-app/GUIA_RAPIDO_EMAILS.md

🚀 GUIA RÁPIDO: Enviar Emails e Notificações

⚡ 3 Passos para Começar

1️⃣ Configurar SMTP (Fazer 1 vez)

1. Acesse: http://localhost:5173/ti/configuracoes-email
2. Preencha:

   📧 Remetente: SGSE - Sistema de Gerenciamento
   📧 Email: sgse@pe.gov.br (ou seu email)
   🌐 Servidor: smtp.gmail.com
   🔌 Porta: 587
   🔐 Usuário: seu-email@gmail.com
   🔑 Senha: sua-senha-de-app
   🔒 TLS/SSL: Sim
   

3. Clique: "Testar Conexão SMTP"
4. Aguarde: ✅ "Conexão testada com sucesso!"

2️⃣ Enviar Notificação

1. Acesse: http://localhost:5173/ti/notificacoes
2. Selecione:
   • Destinatário: João Silva (ou qualquer usuário)
   • Canal:
     • 💬 Chat = Mensagem imediata
     • 📧 Email = Envio em até 2 minutos
     • 🔄 Ambos = Chat + Email
   • Mensagem: Escolha template ou escreva
3. Clique: "Enviar"

3️⃣ Verificar Envio

Chat:

• ✅ Imediato: Abra o chat e veja a mensagem

Email:

• ⏱️ Aguarde 2 minutos (processamento automático)
• 📋 Verifique logs no terminal do Convex:

  ✅ Email enviado com sucesso!
  Para: destinatario@email.com
  

---

🔑 IMPORTANTE: Senha de App do Gmail

O Gmail NÃO aceita senha normal!

Como gerar:

1. Acesse: https://myaccount.google.com/security
2. Ative: "Verificação em duas etapas"
3. Vá em: "Senhas de app"
4. Gere: Senha para "Email"
5. Use: Senha de 16 caracteres gerada

---

✅ Canais Disponíveis

Canal	Velocidade	Ideal Para
💬 Chat	Imediato	Mensagens urgentes
📧 Email	2 minutos	Notificações formais
🔄 Ambos	Variado	Comunicações importantes

---

🧪 Teste Rápido

1. Configure SMTP (Gmail)
2. Envie notificação para você mesmo
3. Canal: Ambos
4. Verifique:
   ✅ Chat: Mensagem aparece imediatamente
   ✅ Email: Chega em até 2 minutos

---

❓ Troubleshooting

Email não chega?

1. ✅ Configuração SMTP testada?
2. ✅ Senha de App (não senha normal)?
3. ✅ Aguardou 2 minutos?
4. ✅ Verifique spam/lixo eletrônico

Chat não funciona?

1. ✅ Destinatário tem acesso ao chat?
2. ✅ Usuário está cadastrado?

Erro "Configuração não testada"?

1. ✅ Clique em "Testar Conexão SMTP"
2. ✅ Aguarde mensagem de sucesso
3. ✅ Tente enviar novamente

---

📄 Documentação Completa

Veja: CORRECOES_EMAILS_NOTIFICACOES_COMPLETO.md

---

✅ PRONTO PARA USO! 🎉