---
title: Email Service 2026
slug: releases/email-service-2026
createdAt: 2026-11-17T17:45:43.424Z
---

::::::ExpandableHeading{isOpen="true"}
# Versão 1.2.2



Esta versão do<font color="#22C55E">  </font>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:

:::::Tabs
:::Tab{title="✨ Melhorias"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/2tska2eFDN3EVklmDD8Pg_banner-destaque-valor-verde.png)

**⚙️ 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.

***
:::

:::Tab{title="🛠️ Correções"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bRsJKfbOCiVcf9bDl_q-u_banner-correcoes-vd.png)

**🔐 #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.

***
:::

::::Tab{title="🚀 Deploy"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kxvDuyzMpWTmIZkuMRSpG_banner-orientacoes-deploy-verde.png)

**🐳 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:

:::BlockQuote
repositorio.cithyper.click/centralit/email-service:1.2.2
:::

Repositório 4Biz:

:::BlockQuote
registry.cloud4biz.com/deployscdi/email-service:1.2.2
:::

***

**🚀 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.

***
::::
:::::
::::::

:::::::ExpandableHeading
# Versão 1.2.1



Esta versão do<font color="#22C55E">  </font>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:

::::::Tabs
:::Tab{title="✨ Melhorias"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/2tska2eFDN3EVklmDD8Pg_banner-destaque-valor-verde.png)

*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.

***
:::

:::::Tab{title="🚀 Deploy"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kxvDuyzMpWTmIZkuMRSpG_banner-orientacoes-deploy-verde.png)

::::hint{type="success"}
**Atenção antes de atualizar:**

- &#x20;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:

:::BlockQuote
TOPIC\_CONFIG\_PRODUCER
CONFIG\_CONSUMER
READ\_EMAIL\_PRODUCER
SEND\_EMAIL\_CONSUMER
:::
::::

***

**🐳 Imagens Docker**

No objeto Deployment, aplique uma das imagens abaixo, conforme o ambiente utilizado:

Email Service:

:::BlockQuote
nexus.centralit.io:9091/email-service:1.2.0
:::

ou

:::BlockQuote
registry.cloud4biz.com/deployscdi/email-service:1.2.0
:::

***
:::::
::::::
:::::::

:::::::ExpandableHeading
# Versão 1.2.0



Esta versão do<font color="#22C55E">  </font>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:

::::::Tabs
:::Tab{title="✨ Melhorias"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/2tska2eFDN3EVklmDD8Pg_banner-destaque-valor-verde.png)

*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.

***
:::

:::::Tab{title="🚀 Deploy"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kxvDuyzMpWTmIZkuMRSpG_banner-orientacoes-deploy-verde.png)

::::hint{type="success"}
**Atenção antes de atualizar:**

- &#x20;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:

:::BlockQuote
TOPIC\_CONFIG\_PRODUCER
CONFIG\_CONSUMER
READ\_EMAIL\_PRODUCER
SEND\_EMAIL\_CONSUMER
:::
::::

***

**🐳 Imagens Docker**

No objeto Deployment, aplique uma das imagens abaixo, conforme o ambiente utilizado:

Email Service:

:::BlockQuote
nexus.centralit.io:9091/email-service:1.2.0
:::

ou

:::BlockQuote
registry.cloud4biz.com/deployscdi/email-service:1.2.0
:::

***
:::::
::::::
:::::::

