> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> O que mudou em cada versão do Notifuse, da mais recente para a mais antiga, com o que fazer antes de atualizar.

Versões do Notifuse, da mais recente para a mais antiga. Antes de atualizar, leia as notas de todas as versões entre a sua e a nova, depois siga [Atualize para uma nova versão](https://www.notifuse.com/pt/docs/self-hosting/upgrading.md).

## 44.0

_19 de novembro de 2026_

Com 194 itens no changelog, esta é a maior versão do Notifuse até agora. O console foi refeito com um novo design, todo email ganha uma versão em texto simples e uma versão web, e o editor de email passa a escrever MJML 5. O Notifuse agora compila os emails com o safe-mjml 1.1 e renderiza o Liquid com o liquidgo 5.14.6, que se comporta como o Liquid do Shopify em muito mais casos.

Esta também é uma versão de segurança. Os valores Liquid no HTML dos emails agora são escapados em HTML, então os dados de um formulário público não podem mais adicionar marcação ou links a um email.

- O console fica mais compacto, com uma barra lateral que se recolhe em ícones e um novo dashboard. Contatos, listas e segmentos ficam na mesma página.
- Todo email inclui uma versão em texto simples, e os emails de broadcasts e automações podem levar à sua versão web com `{{ view_in_browser_url }}`.
- As automações podem começar quando um contato clica em um link, e os emails delas podem usar o evento que iniciou a jornada como `{{ trigger_event }}`.
- Os novos templates partem de uma galeria de 15 emails prontos, e os blocos do editor visual podem aparecer só para alguns destinatários.
- Um broadcast agendado pode voltar a rascunho, e cada variação pode ter o próprio remetente.
- O `compose.yaml` instala o Notifuse a partir da imagem publicada e passa para o PostgreSQL 18. A lista de workspaces avisa quando sai uma nova versão, a menos que `CHECK_FOR_UPDATES=false`.

> [!WARNING]
>
> Antes de atualizar:
>
> - O Notifuse não inicia mais em um PostgreSQL anterior ao 17. Atualize primeiro o servidor do banco de dados, como explica [Atualizar o PostgreSQL](https://www.notifuse.com/pt/docs/self-hosting/upgrading.md#upgrading-postgresql).
> - Com o `compose.yaml`, o próximo `docker compose up -d` atualiza o PostgreSQL 17 para o 18 depois de copiar os dados para o volume `postgres-upgrade-backup`. Reserve espaço livre em disco para os dados mais 10%. Todas as variáveis do `.env` agora chegam ao Notifuse, então remova antes as configurações antigas.
> - A atualização recria os índices do histórico de mensagens, e o envio e o rastreamento esperam até ela terminar: cerca de um segundo a cada 2 milhões de mensagens quando a tabela cabe na memória. Faça a atualização fora de um envio grande.
> - Os dados que devem ser HTML precisam do novo filtro `raw` (`{{ global_feed.html | raw }}`), e `{{ bio | newline_to_br }}` passa a ser `{{ bio | escape | newline_to_br }}`.
> - Um email cujo Liquid falha não é mais enviado, por exemplo ao comparar um texto com um número ou chamar um filtro sem um argumento obrigatório. A pré-visualização e o envio de teste mostram o erro.
> - Se você define `email.text` pela API, ele agora é enviado como a versão em texto do email.
> - No domínio personalizado de um blog, renomeie as categorias cujo slug seja `v`: o caminho `/v/` agora pertence às versões web.
> - `email.testProvider` fica restrito aos proprietários do workspace. As chaves de API e os membros agora recebem 403.
> - As participações nos segmentos mudam na atualização. As automações e os webhooks que reagem à entrada ou saída de um contato de um segmento recebem essas mudanças de uma vez.

[Anúncio da versão](https://news.notifuse.com/product/notifuse-44) · [Nota completa da 44.0](https://github.com/Notifuse/notifuse/blob/main/CHANGELOG.md#440---2026-11-19)

## 43.0

_7 de novembro de 2026_

Os contatos escolhem separadamente o rastreamento de aberturas e de cliques, os workspaces decidem o que acontece quando não há escolha registrada, e as integrações de email desaceleram quando um provedor diz que os emails estão chegando rápido demais.

- Os contatos podem aceitar ou recusar o rastreamento de aberturas e o rastreamento de cliques, cada um separadamente.
- As configurações do workspace ativam separadamente o rastreamento de aberturas e de cliques, com um padrão para os contatos sem escolha registrada.
- Broadcasts e notificações transacionais podem ser enviados sem rastreamento, mantendo seus parâmetros UTM.
- As automações levam os contatos por mais de dez etapas seguidas sem atraso.

> [!WARNING]
>
> Antes de atualizar:
>
> - Confira se **Excluir destinatários que cancelaram a inscrição** está ativado nas suas campanhas regulares, inclusive nas criadas pela API sem `exclude_unsubscribed` antes da 42.0. Um broadcast com essa opção desativada deixa de levar o cabeçalho `List-Unsubscribe`.
> - Os payloads dos webhooks de contato ganham quatro campos de consentimento de rastreamento. Garanta que um receptor que valida os payloads os aceite.

[Nota completa da 43.0](https://github.com/Notifuse/notifuse/blob/main/CHANGELOG.md#430---2026-11-07)

## 42.2

_5 de novembro de 2026_

Links rastreados mais seguros, e os workspaces cuja criação parou no meio podem ser criados de novo. Esta é uma versão de segurança: os links rastreados não levam mais os visitantes, sem perguntar antes, a um site que o email não continha, e as requisições que indicam um workspace inexistente não abrem mais conexões com o banco de dados.

- Os links rastreados pedem que o visitante confirme antes de abrir um site que o Notifuse não consegue confirmar que estava no email.
- Um workspace cuja criação parou no meio pode ser criado de novo com o mesmo ID.
- Um proprietário sem licença para permissões granulares pode devolver o acesso total a um membro.

> [!WARNING]
>
> Antes de atualizar: se puder, atualize enquanto nenhum broadcast estiver pausado ou ainda enviando. Os emails colocados na fila antes da atualização saem com links não assinados, e os links deles para outros sites mostram uma página de confirmação.

[Nota completa da 42.2](https://github.com/Notifuse/notifuse/blob/main/CHANGELOG.md#422---2026-11-05)

## 42.1

_28 de outubro de 2026_

Uma atualização de segurança do login único, com uma correção para as fontes declaradas nos templates de email e verificações mais rígidas das credenciais SMTP. O login único passa a usar o go-jose 4.1.6, que corrige uma negação de serviço por meio de uma chave RSA forjada nas chaves de assinatura do provedor de identidade ([GHSA-mgcc-cww5-fp2q](https://github.com/advisories/GHSA-mgcc-cww5-fp2q)).

- Corrige uma negação de serviço no login único.
- Uma fonte declarada com `mj-font` agora substitui a folha de estilo do Google para a mesma fonte.
- As configurações SMTP exigem uma senha junto com um nome de usuário, e um nome de usuário junto com uma senha.

[Nota completa da 42.1](https://github.com/Notifuse/notifuse/blob/main/CHANGELOG.md#421---2026-10-28)

## 42.0

_23 de outubro de 2026_

Uma versão de segurança que também reforça o tratamento da `SECRET_KEY` e corrige o comportamento das listas, dos cancelamentos de inscrição e dos broadcasts. Ela fecha várias vulnerabilidades: os webhooks podiam alcançar endereços privados e internos, os webhooks dos provedores agiam sobre emails que o Notifuse não tinha enviado, o editor de email executava scripts do conteúdo dos templates, e as dependências e o runtime do Go tinham alertas de segurança conhecidos.

- Os webhooks recusam endereços privados, de loopback e reservados, a menos que `WEBHOOK_DELIVERY_ALLOW_PRIVATE_HOSTS` esteja definida.
- A `SECRET_KEY` pode listar várias chaves, o que permite substituí-la.
- Os broadcasts respeitam o limite de taxa de cada integração de email e chegam mais rápido às listas grandes.
- Um contato removido de uma lista é tratado como fora da lista em todos os lugares.

> [!WARNING]
>
> Antes de atualizar:
>
> - Se os seus webhooks chamam um serviço na sua própria rede (n8n ou outro contêiner na mesma rede Docker, uma API interna), defina `WEBHOOK_DELIVERY_ALLOW_PRIVATE_HOSTS=true` antes de atualizar. Caso contrário, esses webhooks deixam de ser entregues.
> - Se um relay seu publica eventos de uma integração SMTP em `/webhooks/email`, defina o `message_id` de cada evento com o cabeçalho `X-Message-ID` do email e o `recipient` com o endereço para o qual o email foi enviado.
> - Se a sua `SECRET_KEY` é o antigo padrão do `compose.yaml`, o placeholder do `env.example` ou tem menos de 32 bytes, o Notifuse não inicia mais com ela. Na mesma etapa da atualização, gere uma nova chave e defina `SECRET_KEY=<new key>,<current key>`, como explica [Substituir a chave secreta](https://www.notifuse.com/pt/docs/self-hosting/installation.md#replacing-the-secret-key).
> - Se a sua `SECRET_KEY` contém uma vírgula, escreva cada uma das vírgulas duas vezes na mesma etapa da atualização.
> - Compilar a partir do código-fonte agora exige Go 1.26.10 ou mais recente.

[Nota completa da 42.0](https://github.com/Notifuse/notifuse/blob/main/CHANGELOG.md#420---2026-10-23)

## Versões anteriores

O histórico completo, desde a versão 3.1, está no [CHANGELOG.md no GitHub](https://github.com/Notifuse/notifuse/blob/main/CHANGELOG.md).
