📧 MailSender API

Serviço de envio de emails desenvolvido com FastAPI, pensado para integração com formulários e sistemas externos, permitindo envio automático de mensagens para usuários e administradores.

---

🚀 Tecnologias Utilizadas

Backend

• Python
• FastAPI
• Uvicorn
• Pydantic
• python-dotenv
• smtplib (nativo do Python)

---

⚙️ Funcionalidades

• Envio de emails via SMTP (Gmail, Ethereal, etc.)
• Execução em background (BackgroundTasks)
• Validação de dados com Pydantic
• Suporte a múltiplos destinatários
• Pronto para integração com formulários externos

---

▶️ Como Rodar o Projeto Localmente

1. Clonar o repositório

git clone https://github.com/DevAndradeGuilherme/mail-sender.git
cd mail-sender

---

2. Criar ambiente virtual

python -m venv venv
venv\Scripts\activate  # Windows

---

3. Instalar dependências

pip install -r requirements.txt

---

4. Configurar variáveis de ambiente

Crie um arquivo .env baseado no .env.example:

MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=SEU_EMAIL@gmail.com
MAIL_PASSWORD=SUA_APP_PASSWORD

⚠️ Para Gmail, utilize uma App Password (não use sua senha normal).

---

5. Rodar o projeto

python app.py

Ou:

uvicorn app.main:app --reload

---

🌐 Acesso

A API estará disponível em:

http://127.0.0.1:8000

Documentação interativa:

http://127.0.0.1:8000/docs

---

📬 Endpoint

POST /enviar-email

Envia um email de forma assíncrona.

Exemplo de requisição:

{
  "subject": "Teste",
  "message": "<h1>Olá!</h1>",
  "to": ["email@destino.com"]
}

---

🔄 Integração com Formulários

Este serviço pode ser integrado com qualquer frontend (React, HTML, etc.), permitindo:

• Envio automático de confirmação para o usuário
• Notificação para o administrador
• Processamento de dados de formulários

---

🔐 Variáveis de Ambiente

Arquivo: .env

Variável	Descrição
MAIL_HOST	Servidor SMTP
MAIL_PORT	Porta do servidor SMTP
MAIL_USERNAME	Email remetente
MAIL_PASSWORD	Senha ou App Password

---

👨‍💻 Autor

Desenvolvido por Guilherme Andrade Email: dev.guilhermeandrade@gmail.com LinkedIn: www.linkedin.com/in/guilherme-mendes-b6000b384 GitHub: https://github.com/DevAndradeGuilherme

---

📄 Licença

Sinta-se livre para usar, modificar e distribuir conforme desejar.