Pular para o conteúdo
Breaking change

n8n 3.0.0

Confira as mudanças desta versão e os avisos antes de atualizar.

Publicada em
Posição no histórico
12 de 119
Nesta página

Resumo

O n8n 3.0.0 chega como pré-release e inclui mudanças que exigem revisar workflows e a configuração do chat. O Edit Image Node perde suas versões 1 e 1.1, recebe uma versão 2 e integra o relatório de migração. Você pode exportar esse relatório e tratar os apontamentos por projeto para preparar os testes da atualização.

Novidades

  • n8n 3.0.0 — Migração por projeto: o relatório recebe exportação CSV, filtro de workflows por projeto e a classificação Executions might fail. Editores de workflows podem tratar os apontamentos correspondentes.
  • n8n 3.0.0 — Edit Image: a versão 2 do Node utiliza napi-rs/canvas, acompanhada de uma migração para a linha 3.
  • n8n 3.0.0 — Agentes: o Microsoft Foundry oferece deployments Claude no seletor de modelos. O Microsoft Teams recebe um canal de agentes e o Slack permite respostas somente mediante menção.
  • n8n 3.0.0 — Triggers e dependências: Webhook e MCP Trigger recebem autenticação por fontes confiáveis. A API (Application Programming Interface) ganha endpoints para dependências de workflows, credenciais e tabelas.

Melhorias

  • n8n 3.0.0 — Administração do Assistant: as alterações ficam limitadas ao projeto da conversa. Restrições administrativas permanecem após aprovar um plano e o compartilhamento granular de credenciais fica ativo.
  • n8n 3.0.0 — Diagnóstico de agentes: atributos GenAI entram nos registros OpenTelemetry. O histórico mostra interrupções por orçamento e o log identifica o modelo que respondeu.
  • n8n 3.0.0 — Credenciais no editor: campos obrigatórios recebem identificação. A substituição de credenciais não resolvidas é gravada e os menus de memória dos agentes recebem correções.

Correções

  • n8n 3.0.0 — Permissões de execução: leituras do Assistant verificam execution:read e respeitam a ocultação dos registros. Uma nova tentativa não retorna os registros da execução sem essa permissão.
  • n8n 3.0.0 — Recuperação de execuções: a troca do líder reativa execuções em espera. Um subworkflow cuja verificação prévia falha aciona seu workflow de erro, enquanto cancelar uma execução encerra novas tentativas de Nodes.
  • n8n 3.0.0 — Memória e arquivos: o runtime libera o workflow ao terminar uma expressão vm. Transmissões de arquivos e anexos são encerradas quando o cliente desconecta, assim como o envio de arquivos após uma falha na requisição.
  • n8n 3.0.0 — Conexões externas: o Email Trigger (IMAP) Node aumenta o intervalo entre reconexões recusadas. O Microsoft SharePoint Node corrige o mapeamento de colunas e o Microsoft Teams Trigger Node renova assinaturas por notificações de ciclo de vida.
  • n8n 3.0.0 — Execução de código: task runners recebem buffers do Code Node em base64. O QuickJS e seu módulo WebAssembly são substituídos após uma falha de pilha nativa.

Breaking changes

  • n8n 3.0.0 — Edit Image antigo: as versões 1 e 1.1 do Node foram removidas. Workflows que as utilizam precisam passar pela migração para a versão 2 e ter o resultado das imagens conferido.
  • n8n 3.0.0 — Chat Hub: a configuração padrão desativa o módulo. Instalações que usam o chat precisam conferir a configuração de habilitação na atualização.

Ponto de Atenção

O identificador 3.0.0 não representa uma publicação estável: o GitHub a classifica como pré-release. A interface de Nodes utiliza N8N_NODES_API_VERSION 3, com ajuste de compatibilidade para pacotes comunitários. O relatório também identifica o LangChain Code Node removido. Essas verificações pertencem à preparação da migração, junto com a conferência das credenciais compartilhadas.

Teste sugerido: atualize uma cópia de homologação e exporte o relatório de migração. Confira os workflows que utilizam Edit Image e pacotes comunitários. Execute uma transformação de imagem conhecida para comparar o resultado com a instalação anterior. Depois, confira a disponibilidade do chat e tente consultar uma execução pelo Assistant com um perfil sem execution:read.

Notas da versão

O release oficial do n8n 3.0.0 foi publicado em 27/10/2026 às 08h47 UTC como pré-release. O corpo inclui reversões das remoções do modo Run once for each item e da política Any workflow. Esses dois recursos não foram apresentados como removidos neste relato.

Versões anteriores

    • n8n 2.46.0

      O n8n 2.46.0 publica uma pré-release com relatório de migração exportável e mudanças nas permissões dos agentes.

      Breaking change
    • n8n 2.45.4

      O n8n 2.45.4 permite filtrar por projeto os workflows do relatório de migração e recria ambientes removidos do n8n-sandbox.

      Stable
    • n8n 2.44.7

      O n8n 2.44.7 aciona o workflow de erro de um subworkflow quando uma verificação anterior à execução falha.

      Stable
    • n8n 1.123.88

      O n8n 1.123.88 corrige a liberação da trava de escrita do SQLite quando a conexão não consegue abrir.

      Stable
    • n8n 2.45.3

      O n8n 2.45.3 aumenta o contraste dos textos no modo claro do editor.

      Stable
    • n8n 2.45.2

      O n8n 2.45.2 acrescenta a exportação do relatório de migração em CSV e corrige o Postgres Node.

      Stable

Versões posteriores

    • n8n 2.45.6

      O n8n 2.45.6 corrige o registro do tempo economizado calculado dinamicamente nas execuções em modo de fila.

      Stable
    • n8n 1.123.90

      O n8n 1.123.90 exige um token assinado para aceitar convites.

      Stable
    • n8n 3.0.1

      O n8n 3.0.1 mantém a classificação de pré-release e corrige as expressões executadas pelo QuickJS.

      Stable
    • n8n 2.46.1

      O n8n 2.46.1 corrige a preservação de undefined nas expressões do QuickJS e do nome ExpressionError nos builds minificados.

      Stable
    • n8n 2.45.5

      O n8n 2.45.5 preserva os resultados undefined das expressões executadas pelo QuickJS e o nome ExpressionError nos builds minificados.

      Stable
    • n8n 1.123.89

      O n8n 1.123.89 corrige a paginação do Google Drive Node e o acúmulo de sessões ociosas no MCP Server Trigger Node.

      Stable
Ver todas as 119 versões do n8n
Histórico de versões