https://github.com/victorlcastro-dsa/msgraph-email-sender
Este projeto é uma aplicação Kivy para enviar emails utilizando a API do Microsoft Graph. Permite selecionar uma planilha Excel com dados dos emails, formatar os corpos dos emails e enviá-los aos destinatários especificados. Inclui autenticação, formatação de emails, processamento de planilhas e envio assíncrono de emails.
https://github.com/victorlcastro-dsa/msgraph-email-sender
automation email-sender graphapi outlook project-based-learning
Last synced: about 1 month ago
JSON representation
Este projeto é uma aplicação Kivy para enviar emails utilizando a API do Microsoft Graph. Permite selecionar uma planilha Excel com dados dos emails, formatar os corpos dos emails e enviá-los aos destinatários especificados. Inclui autenticação, formatação de emails, processamento de planilhas e envio assíncrono de emails.
- Host: GitHub
- URL: https://github.com/victorlcastro-dsa/msgraph-email-sender
- Owner: victorlcastro-dsa
- Created: 2025-03-24T19:30:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-28T15:04:14.000Z (over 1 year ago)
- Last Synced: 2025-06-05T22:07:18.044Z (about 1 year ago)
- Topics: automation, email-sender, graphapi, outlook, project-based-learning
- Language: Python
- Homepage:
- Size: 55.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Disparador Outlook
`EM DESENVOLVIMENTO`
Este projeto é uma aplicação Kivy para enviar emails utilizando a API do Microsoft Graph. A aplicação permite selecionar uma planilha Excel contendo os dados dos emails, formatar os corpos dos emails e enviá-los para os destinatários especificados.
## Estrutura do Projeto
```
.env
.gitignore
main.py
README.md
requirements.txt
app/
├── __init__.py
├── auth/
│ ├── __init__.py
│ └── authenticator.py
├── config/
│ ├── __init__.py
│ ├── log_settings.py
│ └── settings.py
├── controller/
│ ├── __init__.py
│ └── home_controller.py
├── enum/
│ ├── __init__.py
│ ├── email_format_type.py
│ ├── email_recipient_type.py
│ └── excel_columns.py
├── exceptions/
│ ├── __init__.py
│ ├── asyncio_exceptions.py
│ ├── authentication_exceptions.py
│ ├── configuration_exceptions.py
│ ├── email_exceptions.py
│ ├── excel_exceptions.py
│ └── main_exceptions.py
├── services/
│ ├── __init__.py
│ ├── email_formatter.py
│ ├── process_excel.py
│ └── send_email.py
└── views/
├── __init__.py
├── main.kv
└── main_screen.py
```
## Estrutura da Planilha Excel
A planilha Excel deve seguir o exemplo estrutural abaixo, podendo ter quantos "CORPO E-MAIL" forem necessários:
| E-MAIL ASSUNTO | E-MAIL PARA (separar com ;) | E-MAIL CC (separar com ;) | E-MAIL CCO (separar com ;) | CORPO E-MAIL 1 | CORPO E-MAIL 2 | ... |
|----------------|-----------------------------|---------------------------|----------------------------|----------------|----------------|-----|
| Assunto 1 | email1@example.com;email2@example.com | cc1@example.com;cc2@example.com | cco1@example.com;cco2@example.com | Corpo do email parte 1 | Corpo do email parte 2 | ... |
| Assunto 2 | email3@example.com;email4@example.com | cc3@example.com;cc4@example.com | cco3@example.com;cco4@example.com | Corpo do email parte 1 | Corpo do email parte 2 | ... |
## Instalação
1. Clone o repositório:
```sh
git clone
cd msgraph-email-sender
```
2. Crie um ambiente virtual e ative-o:
```sh
python -m venv venv
source venv/bin/activate # No Windows, use `venv\Scripts\activate`
```
3. Instale as dependências:
```sh
pip install -r requirements.txt
```
4. Configure as variáveis de ambiente no arquivo `.env`:
```properties
# Tenant Identification
TENANT_ID= "your_tenant_id_here"
# Client Credentials
CLIENT_ID= "your_client_id_here"
CLIENT_SECRET= "your_client_secret_here"
# User Credentials
USER_EMAIL= "your_email_here"
# Log Configurations
LOG_LEVEL="DEBUG"
LOG_FORMAT="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
# aiohttp Configurations
AIOHTTP_LIMIT=10
# API Configurations
API_SCOPE="https://graph.microsoft.com/.default"
# Excel File Path
EXCEL_FILE_PATH="path_to_your_excel_file_here"
# App Configurations
APP_TITLE="Disparador Outlook"
APP_ICON_PATH="path_to_your_app_icon_here"
# Email Formatting Configurations
DEFAULT_FONT_SIZE=1
FONT_SIZE_INCREMENT=0.50
# Excel Processing Configurations
INVALID_VALUES="x,nan,"
# Email Sending Configurations
GRAPH_API_URL="https://graph.microsoft.com/v1.0"
SAVE_TO_SENT_ITEMS="true"
```
## Uso
1. Execute a aplicação:
```sh
python main.py
```
2. Na interface da aplicação, selecione a planilha Excel contendo os dados dos emails.
3. Formate os corpos dos emails conforme necessário.
4. Clique no botão "Enviar" para enviar os emails.
## FIXME
- Fazer com que a quebra de linha funcione para corpos de email sem formatação
- Fazer com que o hiperlink funcione corretamente
- Corrigir feedbacks visuais ao selecionar e deselecionar os botões de formatação, spinners e etc
## TODOs
- Colocar toda a interface e as mensagens de resposta em português
- Separar as responsabilidades em controller, corrigir nome de métodos, e separar as funções em arquivos diferentes
- Fazer isso com a main screen também, melhorar a organização do código
- Tirar números mágicos, fazer uso de enum
- Corrigir o layout, melhorar a interface
- Adicionar novos tipos de formatação e algo mais personalizado em relação ao tamanho da fonte
## Preview
