Pular para o conteúdo
Breaking change

n8n 2.49.0

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

StayCloudVPS Agêntica

30% off na sua VPS Agêntica nos 2 primeiros meses

A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

Aproveitar a Black Friday

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
6 de 119
Nesta página

Resumo

O n8n 2.49.0 é a publicação da linha beta com foco em agentes e na API pública. Os agentes ganham canal de webhook com solicitações de aprovação, estado de arquivamento, etiquetas na API interna e endpoints de criação, leitura e remoção na API pública. A configuração de agente aceita agora guardrails de ferramenta, com execução por padrão de chamadas.

A publicação também altera o assistente e a instalação. O construtor de IA recebe catálogo de ferramentas, dicas por etapa e políticas de memória observacional opcionais, enquanto a API pública padroniza a prévia de mudança entre interface, API e CLI, mostra os escopos exigidos em cada operação e registra a versão do n8n na especificação OpenAPI.

Novidades

  • n8n 2.49.0 — Canal de webhook para agentes: o agente ganha um canal de webhook, com descrições por canal e solicitações de aprovação dentro do canal.
  • n8n 2.49.0 — Arquivamento de agentes: o agente ganha estado de arquivamento, com ação de arquivar e restaurar no editor e substituição da ferramenta de remoção por uma de arquivamento no MCP.
  • n8n 2.49.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 em agentes.
  • n8n 2.49.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 2.49.0 — Lista de agentes com paginação: as listas de agentes aceitam offset e limit e filtros equivalentes aos da lista de workflows.
  • n8n 2.49.0 — OAuth automático: um modo de OAuth registra o cliente automaticamente para os serviços selecionados.
  • n8n 2.49.0 — Ferramenta de dependências no MCP: o servidor MCP ganha ferramenta para consultar dependências e o servidor de instância recebe ferramentas de relatório de migração.
  • n8n 2.49.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 2.49.0 — CSP em Apps: as respostas de Apps incluem agora política de segurança de conteúdo.
  • n8n 2.49.0 — Recurso Secret no Node do GitHub: o Node do GitHub opera agora o recurso Secret.
  • n8n 2.49.0 — Exportação com includeArchived: a API pública renomeia a opção de exportação de arquivados para includeArchived.
  • n8n 2.49.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 exigidos na descrição de cada operação.
  • n8n 2.49.0 — Prévia de mudança unificada: interface, API pública e CLI usam a mesma prévia de alteração.

Melhorias

  • n8n 2.49.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 2.49.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 2.49.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 2.49.0 — Promoções: revisões de promoção podem ser fechadas pela caixa de entrada e falhas comuns de Git ganham explicação.
  • n8n 2.49.0 — Promoção sem workflow: projetos e pastas podem ser promovidos e aplicados sem selecionar um workflow.
  • n8n 2.49.0 — Construtor de IA: o assistente usa catálogo de ferramentas, executa chamadas auxiliares num modelo utilitário e recebe dicas por etapa com pistas de referência.
  • n8n 2.49.0 — Memória observacional: políticas de memória observacional entram como opção para o Instance AI.
  • n8n 2.49.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 2.49.0 — Cache do QuickJS: o arquivo WASM do QuickJS é servido com cache longo e só a variante de sincronização de release é distribuída.
  • n8n 2.49.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 2.49.0 — Animação do canvas: o consumo de CPU das animações de status do canvas diminui.
  • n8n 2.49.0 — Links do usuário: os links pessoais ficam num menu de perfil no rodapé da barra lateral.

Correções

  • n8n 2.49.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 2.49.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 2.49.0 — Streaming de texto: o Node de agente de IA deixa de inserir quebras de linha entre trechos transmitidos.
  • n8n 2.49.0 — PDF no AWS Bedrock: o envio usa bloco de texto com nome de documento válido.
  • n8n 2.49.0 — IDs de chamada de ferramenta: os identificadores vindos de servidores compatíveis com OpenAI são preservados no histórico do agente.
  • n8n 2.49.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 2.49.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 2.49.0 — Credencial no Node: o nome exibido da credencial acompanha a marca do Node.
  • n8n 2.49.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 2.49.0 — Pastas na API pública: rotas públicas de pasta aceitam alias pessoal.
  • n8n 2.49.0 — Disparo durável: os trabalhos de gatilho durável sobrevivem a uma publicação seguida de despublicação.
  • n8n 2.49.0 — Histórico de workflow no SQLite: a limpeza do histórico roda em lotes fora da trava de escrita do SQLite.
  • n8n 2.49.0 — Execução com credencial global: a instância deixa de ocultar execuções que usam credenciais globais.
  • n8n 2.49.0 — Espera de trabalho filho: a conclusão de trabalhos filhos em workers é resolvida agora por eventos de conclusão.
  • n8n 2.49.0 — Retomada com falha: o limite de tentativas de retomada vale agora também para retomadas que falharam.
  • n8n 2.49.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 2.49.0 — Node Remove Duplicates: o Node deixa de ficar preso ao atingir o tamanho máximo do histórico.
  • n8n 2.49.0 — Nodes de vetor: o Weaviate limpa a coleção uma vez por inserção, passa filtros na busca híbrida e o Pinecone consulta índices com esquema de documento pela API de documentos.
  • n8n 2.49.0 — Node Qdrant: o subcaminho do proxy reverso é preservado como prefixo do cliente.
  • n8n 2.49.0 — Gatilho do Jira Cloud: o token assinado é verificado nos webhooks OAuth2 de entrada.
  • n8n 2.49.0 — Gatilho do Microsoft Teams: todas as notificações de alteração de uma requisição em lote são emitidas.
  • n8n 2.49.0 — Gemini: o motivo da recusa aparece quando o modelo não devolve resposta e erros de rede informam a causa.
  • n8n 2.49.0 — Decriptação assimétrica: bytes que não são UTF-8 são preservados.
  • n8n 2.49.0 — Credencial em Node de IA: Nodes que usam credencial de chave de API exigem agora a chave.
  • n8n 2.49.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 2.49.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 2.49.0 — Agente recém-criado: o agente continua como rascunho depois de voltar das configurações e as abas seguem disponíveis para rascunhos novos.
  • n8n 2.49.0 — Erro antigo no canvas: Nodes deixam de mostrar erro de execução já substituído.

Breaking changes

  • n8n 2.49.0 — Exportação de arquivados na API pública: a opção que exporta itens arquivados recebe o nome includeArchived. Uma integração que envia o nome anterior precisa ser ajustada antes de atualizar.

Ponto de Atenção

A publicação é beta e concentra mudanças em agentes e na API pública. Uma instalação que usa a API pública para exportar workflows precisa conferir o nome da opção de arquivados e uma instalação com agentes e guardrails deve revisar a configuração antes de promover a versão.

Teste sugerido: chame a API pública de exportação com includeArchived e confirme o retorno. Crie um agente pela API pública, leia e remova o mesmo agente. Num agente com guardrail de ferramenta, execute uma chamada barrada e confira a recusa. Rode um workflow com Node de Postgres em lote grande e verifique se a instância responde durante o processamento.

Notas da versão

O release oficial do n8n 2.49.0 foi publicado em 17/11/2026 às 9h40 UTC como pré-lançamento da linha beta. As notas vêm da lista de mudanças do repositório, com blocos de novidades, desempenho e correções.

Versões anteriores

    • 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
    • n8n 2.48.2

      O n8n 2.48.2 mantém as abas dos agentes disponíveis ao criar rascunhos.

      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
    • n8n 3.3.0

      O n8n 3.3.0 é a publicação da linha 3.x que acompanha a 2.49.0.

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