Email Service 2026
Data: de publicação: 08/10/2026
Esta versão do Email service traz atualizações importantes para modernizar sua estrutura, melhorar a organização das configurações e facilitar a manutenção e a evolução do sistema.
Confira abaixo o que mudou:

⚙️ Novas configurações para o tempo máximo de espera
Foram adicionadas duas configurações que permitem definir o tempo máximo padrão para envio e leitura de e-mails.
Esses valores são utilizados quando a caixa de e-mail não possui um tempo de espera válido configurado.
Novas propriedades:
- emailservice.default-outbox-time-out: define o tempo máximo padrão para envio de e-mails.
- emailservice.default-inbox-time-out: define o tempo máximo padrão para leitura de e-mails.
As duas configurações utilizam 30.000 milissegundos (30 segundos) como valor padrão.
Também é possível personalizá-las por meio das variáveis de ambiente:
- EMAILSERVICE_DEFAULT_OUTBOX_TIME_OUT
- EMAILSERVICE_DEFAULT_INBOX_TIME_OUT
Com isso, os administradores podem ajustar os tempos de espera de acordo com as necessidades de cada ambiente.
🐳 Atualização do local de armazenamento das imagens Docker
O processo automático de integração e entrega do sistema (CI) passou a utilizar o Harbor no lugar do Nexus para armazenar as imagens Docker.
Essa alteração faz parte da atualização da estrutura utilizada para disponibilizar as versões do Email Service.
📚 Organização e ampliação da documentação técnica
A pasta de documentação do projeto foi renomeada de doc para docs, facilitando a padronização e a organização dos arquivos.
Também foram adicionados novos materiais técnicos para apoiar o desenvolvimento e a manutenção do sistema, incluindo:
- 🏗️ Arquitetura: informações sobre a estrutura e o funcionamento do Email Service.
- 📨 Contratos Kafka: documentação das regras e dos formatos utilizados na troca de mensagens entre sistemas.
- 📝 ADRs: registros das decisões técnicas e dos motivos que levaram à escolha de determinadas soluções.
- 🤖 Guias de inteligência artificial: orientações para utilização de ferramentas de IA no projeto, incluindo o arquivo CLAUDE.md.

🔐 #14091 — Correção na leitura de caixas de e-mail com certificados de segurança
Corrigido um erro que impedia a leitura de caixas de e-mail quando o TrustStore (recurso utilizado para armazenar certificados de segurança) estava configurado, mas o tipo de certificado não havia sido informado.
Agora, quando a configuração JAVA_TRUST_STORE_TYPE não for preenchida, o sistema utilizará automaticamente o formato PKCS12, evitando falhas na conexão.
⏱️ Prevenção de travamentos no envio e recebimento de e-mails
Corrigido um problema que poderia deixar o envio ou a leitura de e-mails travados por tempo indeterminado.
Isso acontecia quando o Frontmanager não informava os tempos máximos de espera (outboxTimeOut e inboxTimeOut) ou enviava valores iguais ou menores que zero.
Agora:
- O sistema utiliza automaticamente um tempo de espera padrão quando essas informações não são enviadas corretamente.
- Valores iguais ou menores que zero deixam de provocar esperas sem limite.
- O envio e a leitura de e-mails não ficam mais presos indefinidamente por causa dessas configurações.
📥 Respeito ao tempo de espera configurado para leitura de e-mails
Corrigido o comportamento das conexões utilizadas para receber e-mails pelos protocolos IMAP, IMAPS e POP3.
Anteriormente, o sistema utilizava tempos de espera fixos, mesmo quando havia um valor diferente configurado para a caixa de e-mail.
Agora, o tempo definido em inboxTimeOut é respeitado, permitindo que cada conexão utilize a configuração estabelecida.
🔄 Recuperação automática após falhas de conexão
Melhorado o tratamento de problemas de rede durante o envio e o recebimento de e-mails.
Antes, quando uma conexão era interrompida, ela poderia continuar presa à caixa de e-mail, impedindo que novas operações funcionassem corretamente.
Agora, quando ocorre uma falha, o sistema identifica o problema, encerra a conexão com defeito e cria uma nova conexão.
Essa recuperação considera diferentes situações, como:
- ⏳ Tempo de espera esgotado.
- 🌐 Quedas ou interrupções de conexão.
- 🔒 Erros relacionados à segurança SSL.
- 🔍 Falhas identificadas ao verificar a origem e as causas do erro.
A correção vale tanto para conexões de envio (SMTP) quanto para conexões de recebimento (IMAP), reduzindo o risco de caixas de e-mail ficarem travadas após problemas de rede.

🐳 Imagens Docker
Para utilizar a versão 1.2.2, atualize a imagem do Email Service no ambiente de implantação.
Email Service — versão 1.2.2
Repositório CITSmart:
Repositório 4Biz:
🚀 1. Atualização da aplicação
É necessário atualizar o aplicativo email-service para a versão 1.2.2.
No objeto Deployment, utilize uma das imagens Docker informadas acima, conforme o repositório adotado pelo ambiente.
⏱️ 2. Configuração opcional dos tempos de espera
Caso seja necessário personalizar os tempos máximos padrão de envio e recebimento de e-mails, adicione as seguintes variáveis de ambiente:
Tempo máximo para envio de e-mails
EMAILSERVICE_DEFAULT_OUTBOX_TIME_OUT
- Define o tempo máximo padrão de espera durante o envio.
- O valor deve ser informado em milissegundos.
- Valor padrão: 30000 (30 segundos).
Tempo máximo para leitura de e-mails
EMAILSERVICE_DEFAULT_INBOX_TIME_OUT
- Define o tempo máximo padrão de espera durante a leitura.
- O valor deve ser informado em milissegundos.
- Valor padrão: 30000 (30 segundos).
Importante: essas configurações são opcionais e utilizadas quando a caixa de e-mail não possui um tempo de espera válido configurado. Se não forem informadas, o sistema utilizará automaticamente 30 segundos para cada operação.
🔐 3. Configuração de certificados de segurança (TrustStore)
Nos ambientes que precisam utilizar certificados de segurança específicos para estabelecer conexões SSL, configure as variáveis abaixo.
Localização do certificado
JAVA_TRUST_STORE
- Informa o caminho onde está armazenado o arquivo de certificados.
- Exemplo: /path/to/truststore.jks
Senha do certificado
JAVA_TRUST_STORE_PASSWORD
- Informa a senha utilizada para acessar o arquivo de certificados.
Tipo do arquivo de certificados
JAVA_TRUST_STORE_TYPE
- Define o formato do TrustStore utilizado nas conexões SSL.
- Exemplo: JKS
- Configuração opcional.
- Valor padrão: PKCS12
Importante: se o TrustStore estiver configurado e o tipo não for informado, o Email Service utilizará automaticamente o formato PKCS12. Caso o arquivo utilize outro formato, como JKS, informe o tipo correspondente na configuração.
Data: de publicação: 28/04/2026
Esta versão do Email service traz atualizações importantes para modernizar sua estrutura, melhorar a organização das configurações e facilitar a manutenção e a evolução do sistema.
Confira abaixo o que mudou:

Confira abaixo as melhorias feitas para esta versão:
⚙️ Atualização das tecnologias
As principais tecnologias do Email Service foram atualizadas para versões mais recentes: Java 25, Spring Boot 4.0.3 e Microsoft Graph 6.62.0. As demais bibliotecas também foram ajustadas para garantir a compatibilidade com essas atualizações.
📧 Separação das conexões de e-mail
As conexões utilizadas para ler e enviar e-mails agora são configuradas separadamente, permitindo maior organização e controle sobre cada operação.
🔧 Organização das configurações do Kafka
As configurações do Kafka passaram a utilizar o sistema de configuração do Spring. Além disso, a criação dos componentes responsáveis pelo envio e recebimento de mensagens foi reorganizada para facilitar a manutenção e a evolução do sistema.
📚 Atualização da documentação e dos arquivos de configuração
Os arquivos ReadMe.md, release.md e docker-compose.yml foram atualizados com as novas configurações e orientações de uso, mantendo as instruções alinhadas à versão atual do Email Service.

Atenção antes de atualizar:
- Atualize o Email Service para a versão 1.2.0.
- Recomenda-se esvaziar os seguintes tópicos do Kafka para evitar o envio duplicado de e-mails:
🐳 Imagens Docker
No objeto Deployment, aplique uma das imagens abaixo, conforme o ambiente utilizado:
Email Service:
ou
Data: de publicação: 28/04/2026
Esta versão do Email service traz atualizações importantes para modernizar sua estrutura, melhorar a organização das configurações e facilitar a manutenção e a evolução do sistema.
Confira abaixo o que mudou:

Confira abaixo as melhorias feitas para esta versão:
⚙️ Atualização das tecnologias
As principais tecnologias do Email Service foram atualizadas para versões mais recentes: Java 25, Spring Boot 4.0.3 e Microsoft Graph 6.62.0. As demais bibliotecas também foram ajustadas para garantir a compatibilidade com essas atualizações.
📧 Separação das conexões de e-mail
As conexões utilizadas para ler e enviar e-mails agora são configuradas separadamente, permitindo maior organização e controle sobre cada operação.
🔧 Organização das configurações do Kafka
As configurações do Kafka passaram a utilizar o sistema de configuração do Spring. Além disso, a criação dos componentes responsáveis pelo envio e recebimento de mensagens foi reorganizada para facilitar a manutenção e a evolução do sistema.
📚 Atualização da documentação e dos arquivos de configuração
Os arquivos ReadMe.md, release.md e docker-compose.yml foram atualizados com as novas configurações e orientações de uso, mantendo as instruções alinhadas à versão atual do Email Service.

Atenção antes de atualizar:
- Atualize o Email Service para a versão 1.2.0.
- Recomenda-se esvaziar os seguintes tópicos do Kafka para evitar o envio duplicado de e-mails:
🐳 Imagens Docker
No objeto Deployment, aplique uma das imagens abaixo, conforme o ambiente utilizado:
Email Service:
ou