111 lines
2.5 KiB
Markdown
111 lines
2.5 KiB
Markdown
# 🚀 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!** 🎉
|
||
|