Cliente de e-mail — Guia do usuário

Para que serve o módulo «Email»

O módulo é o cliente de e-mail integrado do YoBench, combinando IMAP/SMTP e EWS (Exchange / Office 365) em uma única interface. Múltiplas contas, pastas, busca, ações em massa e sync em segundo plano — sem manter Mail.app, Outlook ou aba do navegador abertos.

O que você obtém:

IMAP/SMTP para Gmail, Yandex, seus próprios servidores — MIME completo via ImapFlow + nodemailer.
EWS para Exchange e Office 365 — dados estruturados via ews-javascript-api, anexos em lazy-load.
Composer rich-text — formatação, links, listas, imagens inline e assinaturas, com anexos via drag-and-drop.
Drafts — salvos automaticamente enquanto você compõe. Retome de onde parou em qualquer dispositivo que hospede a mesma conta.
Undo send — uma janela de cortesia configurável em que a mensagem enviada pode ser cancelada antes de sair da outbox.
Autocomplete de contatos — sugestões em to / cc / bcc a partir do seu histórico de mensagens enviadas/recebidas.
Resumo IA e smart-reply — resumo de uma thread longa com um clique e sugestões de resposta geradas pela IA, usando seu provedor de IA.
Badge no dock para não lidos — contagem total de não lidos no ícone do app (dock do macOS / barra de tarefas do Windows).
Múltiplas contas simultâneas — cada uma com seu estado de sync por pasta.
Pastas com metadados special_use, contadores de não lidos e uid_validity.
Busca — por assunto, remetente e preview via LIKE no banco.
Ações em massa — marcar lido/não lido, alternar flag, mover para pasta, excluir — sobre conjuntos arbitrários.
Anexos — metadados no banco, conteúdo no disco; para EWS, baixados sob demanda.
Worker em segundo plano — email-sync-worker com conexão WAL própria ao banco, timeout de 30 min e reinício automático em crash.
Criptografia — senhas e tokens OAuth ficam armazenados criptografados.

Parâmetros da conta

Ao criar você define:

Nome e e-mail — visíveis na lista de contas.
Usuário e senha — credenciais.
Protocolo — imap (padrão) ou ews.
Cor — identificador visual na UI.

Parâmetros IMAP

Host / porta IMAP — entrada.
Host / porta SMTP — saída.
Use TLS — flag de criptografia.

Parâmetros EWS

URL EWS — URL do serviço Exchange.
Domain — domínio Active Directory (opcional).
Tipo de auth — password ou oauth2.
Provedor OAuth — outlook ou google.
Tokens OAuth — access/refresh, atualizados automaticamente.

Senhas e tokens são criptografados antes de gravar no banco.

Configurações globais

Em Configurações → Email:

Ativar e-mail (emailEnabled) — interruptor principal.
Intervalo de sync (minutos) (emailPollMinutes) — padrão 15.
Concorrência (emailSyncConcurrency) — quantas contas são consultadas em paralelo (padrão 3).

Recursos da UI

Sidebar de contas — lista com etiquetas coloridas e contadores de não lidos.
Lista de pastas — etiquetas especiais (special_use: Inbox, Sent, Drafts, Trash, Junk, Archive).
Lista de mensagens — assunto, remetente, preview, data, flags is_read, is_flagged, is_answered. Threads por thread_id.
Visualizador — render HTML, lista de anexos, ações Reply / Reply All / Forward / Delete.
Composer — campos to / cc / bcc, assunto, anexos, assinatura.

Envio

Contas IMAP — envio via nodemailer SMTP.
Contas EWS — API SendMail embutida.
Em ambos os casos a mensagem de saída é salva automaticamente na pasta Sent (com provider_id vazio como marca de origem local).

Composer rich-text

O composer suporta cabeçalhos, negrito / itálico, listas, links, imagens inline e assinaturas. Arraste um arquivo para o editor para anexá-lo; cole uma imagem da área de transferência para inseri-la inline. A troca entre rich-text e plain text é feita com um único toggle.

Drafts e undo send

Cada composer salva automaticamente um draft enquanto você digita. A pasta Drafts lista todas as mensagens não finalizadas — clique para retomar a edição. Quando você envia, a mensagem fica retida em uma outbox local pelo tempo configurado em Undo send (padrão 5 segundos); clicar em Undo dentro dessa janela restaura o composer com todos os anexos e destinatários intactos.

Autocomplete de contatos

Comece a digitar em to / cc / bcc e um dropdown sugere endereços a partir das mensagens que você enviou ou recebeu. Endereços usados recentemente sobem para o topo.

Resumo IA e smart-reply

No visualizador de mensagem, uma thread longa exibe o botão Resumo IA: um clique e o provedor de IA devolve um resumo conciso com as principais perguntas e decisões. O Smart-reply gera dois ou três rascunhos de resposta (acknowledge / commit / decline) para você escolher — cada rascunho cai no composer onde dá para editar e enviar.

Ambos os recursos usam o provedor configurado no AI Chat. Sem provedor configurado os botões ficam desabilitados.

Fluxo de uso

1. Conecte uma conta

Abra o módulo Email no menu lateral esquerdo.
Clique em Adicionar conta.
Escolha o protocolo (IMAP ou EWS).
Preencha os parâmetros.
Para EWS com OAuth — passe pelo fluxo OAuth (Outlook / Google).
Salve. A primeira sincronização começa automaticamente.

2. Ative o auto-sync

Em configurações ative Ativar e-mail, defina intervalo e concorrência. O worker passa a consultar contas em segundo plano.

3. Trabalhe com mensagens

Leia — clique em uma linha para abrir o visualizador.
Responda ou encaminhe pela barra da mensagem.
Flag ou marque como lida.
Mova para pastas ou exclua.
Busca — por assunto, remetente ou preview.

4. Ações em massa

Selecione várias mensagens via checkboxes → escolha uma ação no cabeçalho da lista (mark read / unread / flag / move / delete). As ações aplicam-se ao banco local e ao servidor.

5. Gerencie contas

Editar — altere credenciais ou tokens OAuth.
Sincronizar agora — força consulta da conta.
Excluir — remove a conta e sua cópia local de mensagens.

Próximos passos

Conecte o Calendário para mostrar compromissos das contas Exchange.
Use o AI Chat com contexto RAG para escrever respostas-padrão.
As notificações usam os canais compartilhados do YoBench (Telegram, e-mail de saída).

Ajuda e feedback

Quer PGP, S/MIME ou regras de auto-filtragem? Escreva para nós pelo formulário de contato.