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
offsetelimite 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 paraincludeArchived. - 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_VERSIONsobe para 3, e o pacote de comunidade ganha compatibilidade comsupportedNodesApiVersionv3. - 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-cliem 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.configurerecebe 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-workfloweapi-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
promptCacheRetentionnã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_VERSIONsobe para 3. Um pacote de comunidade compilado contra a versão 2 da API de Nodes precisa ser recompilado comsupportedNodesApiVersionv3 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.