Pular para o conteúdo
Breaking change

n8n 3.3.0

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

StayCloudVPS Agêntica

Uma VPS para os seus agentes trabalharem dia e noite

Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

Montar minha VPS Agêntica

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA
Publicada em
Posição no histórico
5 de 119
Nesta página

Resumo

O n8n 3.3.0 é a publicação da linha 3.x que acompanha a 2.49.0. O conteúdo de agentes, API pública e assistente é o mesmo da linha beta, com três acréscimos próprios da linha 3: a API de Nodes sobe para a versão 3, Nodes sem uso saem do produto e o módulo de chat hub fica desligado por padrão.

A versão também restaura recursos removidos em publicações anteriores. O modo “Run once for each item” do Node Execute Sub-workflow e a política de chamada “Any workflow” voltam ao produto, e a linha de base das migrações de sincronização 3.x é revertida.

Novidades

  • n8n 3.3.0 — Canal de webhook para agentes: o agente ganha canal de webhook, com descrições por canal e solicitações de aprovação dentro do canal.
  • n8n 3.3.0 — Arquivamento de agentes: o agente ganha estado de arquivamento, com ação de arquivar e restaurar no editor e ferramenta de arquivamento no MCP.
  • n8n 3.3.0 — Endpoints de agentes na API pública: a API pública aceita criação, leitura e remoção de agentes, e a API interna REST aceita etiquetas.
  • n8n 3.3.0 — Guardrails de ferramenta: o esquema de configuração do agente aceita guardrails, e as chamadas de ferramenta passam por verificação por padrão.
  • n8n 3.3.0 — Lista de agentes com paginação: as listas de agentes aceitam offset e limit e filtros equivalentes aos da lista de workflows.
  • n8n 3.3.0 — OAuth automático: um modo de OAuth registra o cliente automaticamente para os serviços selecionados.
  • n8n 3.3.0 — Ferramenta de dependências no MCP: o servidor MCP ganha ferramenta de dependências, e o servidor de instância recebe ferramentas de relatório de migração.
  • n8n 3.3.0 — Skills no assistente: o campo do assistente ganha submenu de skills, e as skills podem ser editadas e gravadas no painel de artefatos.
  • n8n 3.3.0 — CSP em Apps: as respostas de Apps incluem agora política de segurança de conteúdo.
  • n8n 3.3.0 — Recurso Secret no Node do GitHub: o Node do GitHub opera agora o recurso Secret.
  • n8n 3.3.0 — Exportação com includeArchived: a API pública renomeia a opção de exportação de arquivados para includeArchived.
  • n8n 3.3.0 — Versão na especificação OpenAPI: a especificação traz agora a versão do n8n como metadado e os escopos de chave de API na descrição de cada operação.
  • n8n 3.3.0 — Prévia de mudança unificada: interface, API pública e CLI usam a mesma prévia de alteração.

Melhorias

  • n8n 3.3.0 — API de Nodes na versão 3: N8N_NODES_API_VERSION sobe para 3, e o pacote de comunidade ganha compatibilidade com supportedNodesApiVersion v3.
  • n8n 3.3.0 — Faixas de IP barradas na saída: a lista padrão de faixas de IP recusadas na proteção de requisições de saída é ampliada.
  • n8n 3.3.0 — Modo S3 mal configurado: a inicialização recusa um modo de binário S3 mal configurado e normaliza a detecção de modo removido.
  • n8n 3.3.0 — node-cli em desenvolvimento: cada imagem ganha volume próprio de desenvolvimento, o comando fica protegido contra problemas de shell, prazo e porta, e uma recarga que não chega ao n8n informa o motivo.
  • n8n 3.3.0 — OAuth de MCP de saída: o fluxo de autorização de MCP de saída acompanha a especificação de autorização de 28/07/2026.
  • n8n 3.3.0 — Auditoria de credencial: a leitura de conteúdo de credencial emite agora evento de auditoria, e provedores e ambientes de promoção também emitem eventos próprios.
  • n8n 3.3.0 — OpenTelemetry: o hook otel.configure recebe funções de substituição, e os spans de Nodes de ferramenta recebem atributos de ferramenta GenAI.
  • n8n 3.3.0 — Promoções: revisões de promoção podem ser fechadas pela caixa de entrada, e falhas comuns de Git ganham explicação.
  • n8n 3.3.0 — Promoção sem workflow: projetos e pastas podem ser promovidos e aplicados sem selecionar um workflow.
  • n8n 3.3.0 — Construtor de IA: o assistente usa catálogo de ferramentas, executa chamadas auxiliares num modelo utilitário e recebe dicas por etapa.
  • n8n 3.3.0 — Memória observacional: políticas de memória observacional entram como opção para o Instance AI.
  • n8n 3.3.0 — Desempenho de expressões: o tempo de preparação por item no tempo de execução de expressões cai, e a tabela de caracteres especiais sai do pacote de execução.
  • n8n 3.3.0 — Editor mais leve: componentes modais carregam sob demanda, e o build do editor descarta módulos não usados de n8n-workflow e api-types.
  • n8n 3.3.0 — Animação do canvas: o consumo de CPU das animações de status do canvas diminui.

Correções

  • n8n 3.3.0 — Histórico do agente: cada ciclo de chamada de ferramenta de um turno é gravado na memória da conversa, e o histórico de chamadas fica separado por item de entrada.
  • n8n 3.3.0 — Texto junto da ferramenta: o texto que o modelo escreve ao chamar uma ferramenta não é mais descartado do histórico do agente.
  • n8n 3.3.0 — Streaming de texto: o Node de agente de IA deixa de inserir quebras de linha entre trechos transmitidos.
  • n8n 3.3.0 — PDF no AWS Bedrock: o envio usa bloco de texto com nome de documento válido.
  • n8n 3.3.0 — IDs de chamada de ferramenta: os identificadores vindos de servidores compatíveis com OpenAI são preservados no histórico do agente.
  • n8n 3.3.0 — Endpoints compatíveis com OpenAI: modelos personalizados são aceitos na versão 2, e o esforço de raciocínio pode ser definido nesses endpoints.
  • n8n 3.3.0 — Cache de prompt: agentes podem desligar o cache de prompt em endpoints que recusam os campos de cache, e promptCacheRetention não é mais enviado a modelos GPT-6 e posteriores.
  • n8n 3.3.0 — API pública de credenciais: a API recusa edição de Nodes de credencial somente leitura e exige apenas os escopos que uma importação usa.
  • n8n 3.3.0 — Disparo durável: os trabalhos de gatilho durável sobrevivem a uma publicação seguida de despublicação.
  • n8n 3.3.0 — Histórico de workflow no SQLite: a limpeza do histórico roda em lotes fora da trava de escrita do SQLite.
  • n8n 3.3.0 — Execução com credencial global: a instância deixa de ocultar execuções que usam credenciais globais.
  • n8n 3.3.0 — Espera de trabalho filho: a conclusão de trabalhos filhos em workers é resolvida agora por eventos de conclusão.
  • n8n 3.3.0 — Retomada com falha: o limite de tentativas de retomada vale agora também para retomadas que falharam.
  • n8n 3.3.0 — Node de Postgres: o processamento de itens devolve o controle ao laço de eventos, o que evita travar a instância em lotes grandes.
  • n8n 3.3.0 — Node Remove Duplicates: o Node deixa de ficar preso ao atingir o tamanho máximo do histórico.
  • n8n 3.3.0 — Nodes de vetor: o Weaviate limpa a coleção uma vez por inserção e passa filtros na busca híbrida, e o Pinecone consulta índices com esquema de documento pela API de documentos.
  • n8n 3.3.0 — Node Qdrant: o subcaminho do proxy reverso é preservado como prefixo do cliente.
  • n8n 3.3.0 — Gatilho do Jira Cloud: o token assinado é verificado nos webhooks OAuth2 de entrada.
  • n8n 3.3.0 — Gatilho do Microsoft Teams: todas as notificações de alteração de uma requisição em lote são emitidas.
  • n8n 3.3.0 — Gemini: o motivo da recusa aparece quando o modelo não devolve resposta, e erros de rede informam a causa.
  • n8n 3.3.0 — Decriptação assimétrica: bytes que não são UTF-8 são preservados.
  • n8n 3.3.0 — Editor de avaliação: cartões de métrica deixam de transbordar sobre os vizinhos, e colunas e menus de avaliação recebem tradução.
  • n8n 3.3.0 — Assistente: rascunhos são preservados durante aprovações, mensagens antigas carregam ao rolar para cima e o painel de registros abre só quando a execução de prévia falha.
  • n8n 3.3.0 — Erro antigo no canvas: Nodes deixam de mostrar erro de execução já substituído.

Breaking changes

  • n8n 3.3.0 — API de Nodes na versão 3: N8N_NODES_API_VERSION sobe para 3. Um pacote de comunidade compilado contra a versão 2 da API de Nodes precisa ser recompilado com supportedNodesApiVersion v3 para carregar na instância.
  • n8n 3.3.0 — Nodes removidos: Nodes sem uso saem do produto, e o Node Edit Image deixa de aceitar as versões 1 e 1.1. Um workflow que ainda usa esses Nodes precisa ser migrado antes de atualizar.
  • n8n 3.3.0 — Módulo de chat hub desligado: o módulo de chat hub fica desligado por padrão. Uma instalação que depende dele precisa ligar o módulo explicitamente.

Ponto de Atenção

A publicação é da linha 3.x e muda a API de Nodes, remove Nodes e desliga um módulo. A conferência começa pela lista de workflows e pacotes de comunidade, segue para a configuração do chat hub e termina nas restaurações de recursos desfeitas nesta versão.

Teste sugerido: liste os workflows que usam o Node Edit Image e os Nodes removidos antes de atualizar. Recompile o pacote de comunidade com supportedNodesApiVersion v3 e instale numa instância de homologação. Confira se o chat hub continua ativo na sua instalação e ligue o módulo se precisar dele. Num workflow com o Node Execute Sub-workflow, confira o modo “Run once for each item” restaurado.

Notas da versão

O release oficial do n8n 3.3.0 foi publicado em 17/11/2026 às 9h46 UTC como pré-lançamento da linha 3.x. As notas vêm da lista de mudanças do repositório e repetem o conteúdo da 2.49.0, com os acréscimos próprios da linha 3 e o bloco de reversões.

Versões anteriores

    • n8n 2.49.0

      O n8n 2.49.0 é a publicação da linha beta com foco em agentes e na API pública.

      Breaking change
    • n8n 2.48.4

      O n8n 2.48.4 corrige a ocultação de execuções com credenciais globais na linha beta.

      Stable
    • n8n 2.48.3

      O n8n 2.48.3 leva para a linha beta o conjunto de correções e melhorias publicado na 2.47.6.

      Stable
    • n8n 2.47.7

      O n8n 2.47.7 corrige a ocultação de execuções que usam credenciais globais.

      Stable
    • n8n 2.47.6

      O n8n 2.47.6 reúne correções de núcleo, editor e integrações na linha estável.

      Stable
    • n8n 1.123.96

      O n8n 1.123.96 mantém a linha 1 com duas correções de manutenção.

      Stable

Versões posteriores

    • n8n 2.49.3

      O n8n 2.49.3 é a manutenção da linha beta e corrige quatro pontos, três no núcleo e um no editor.

      Stable
    • n8n 2.48.7

      O n8n 2.48.7 é a manutenção da linha estável e repete na 2.48 as duas correções de núcleo publicadas na 2.49.3.

      Stable
    • n8n 2.49.1

      O n8n 2.49.1 é a manutenção da linha beta publicada no dia anterior e corrige quatro pontos no núcleo e no editor.

      Stable
    • n8n 2.48.5

      O n8n 2.48.5 é a manutenção da linha estável 2.48 e concentra dez correções em Nodes de IA, núcleo e editor, além de dois recursos.

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