n8n 3.0: o que muda e o que fazer antes de atualizar

A n8n lançou em 27 de outubro de 2026 o beta do n8n 3.0. Ela não traz recurso novo: é uma limpeza com mudanças que podem quebrar fluxos antigos. A versão estável sai no começo de dezembro. Se você usa n8n na empresa, na nuvem ou no seu servidor, o que importa agora é abrir o Migration Report.

O que mudou

O n8n 3.0 nada mais é do que uma faxina. Segundo o anúncio oficial no blog da n8n, a empresa juntou numa versão só as mudanças que não podiam sair aos poucos, porque obrigam você a mexer em fluxo ou configuração. Os recursos novos continuam saindo toda semana na linha 2.x e depois na 3.x.

A própria n8n deixa claro que a 3.0 foca em confiabilidade, estabilidade e segurança. Na prática, as mudanças que mais aparecem para quem tem fluxo rodando são estas:

• Nós antigos removidos. Function, Function Item, Item Lists, Cron, Interval, o nó antigo da OpenAI, modos antigos do AI Agent e versões antigas do Edit Image saem. A maioria tem substituto direto: Function vira o nó Code, Cron e Interval viram o Schedule Trigger.
• Padrões de segurança mais rígidos. Pacotes da comunidade não verificados vêm desligados, a rotação da chave de criptografia fica sempre ligada e a credencial do Slack passa a exigir a chave de assinatura.
• Freio em tarefa que trava. O tempo máximo padrão do nó Code ficou menor, e dá para ajustar.
• Quem hospeda no próprio servidor passa a usar Docker. Instalar com npm ou npx n8n deixa de ser suportado.
• Recursos aposentados. O Chat Hub vem desligado por padrão, o "Import from URL" sai do editor e a aba "Ask AI" sai do nó Code.

Para quem é? Para todo mundo que usa n8n. O blog diz que tudo vale para a versão Community (no seu servidor), para a nuvem e para os planos Business e Enterprise.

O que isso muda no seu trabalho

A questão é simples: se a sua empresa depende de um fluxo no n8n, uma atualização sem preparo pode parar esse fluxo. Três situações comuns em pequena empresa:

1. Lembrete agendado. Imagine um fluxo que todo dia às 8h manda no WhatsApp a lista de clientes com boleto vencendo. Se ele foi montado há tempo com o nó Cron, é um dos que a migração precisa trocar pelo Schedule Trigger.
2. Planilha tratada no meio do fluxo. Fluxo que pega pedidos do formulário, junta e remove duplicados antes de jogar na planilha costuma usar o Item Lists ou um Function. Os dois saem. O blog aponta os substitutos: Split Out, Aggregate, Sort, Limit, Remove Duplicates ou Summarize.
3. Automação com IA antiga. Se você montou um atendimento ou uma triagem com o nó antigo da OpenAI ou com um modo antigo do AI Agent, esse fluxo entra na lista do relatório.

Eu vejo isso como uma boa hora para organizar a casa. Muita empresa tem fluxo que ninguém lembra quem fez nem se ainda roda. O relatório mostra exatamente isso. Se você está começando agora, a trilha Automação e processos já parte do jeito novo de montar fluxo, e a aula aberta n8n do zero mostra o primeiro gatilho na prática.

Como testar

Qual é o primeiro passo? Não é atualizar. É ver o que vai quebrar. Este é o caminho que a n8n recomenda no blog e na documentação da ferramenta de migração:

1. Atualize para a última versão 2.x. O Migration Report existe a partir da 2.39, e a versão mais nova da 2.x traz o relatório mais completo.
2. Abra Settings > Migration Report. Ele lista os fluxos e as configurações afetados. Você não precisa ser administrador para ver os fluxos a que tem acesso.
3. Corrija ou marque como "won't fix". Muitos problemas o relatório corrige sozinho: cada correção vira uma nova versão do fluxo para você revisar e publicar. Enquanto isso, o fluxo publicado continua rodando na versão 2. Fluxo parado há muito tempo pode ser marcado como "won't fix".
4. Faça um backup completo.
5. Teste antes em uma instância de teste. Na nuvem, o beta aparece como "3.0.0 Beta (early access)" na troca de versão. No seu servidor, instala como qualquer beta.

A documentação avisa que relatório vazio não garante nada: leia também a lista completa de mudanças da 3.0, porque tem coisa que a ferramenta não detecta.

Ressalvas

• Não tem volta. A n8n diz que passar para a 3.x é caminho de ida. Para voltar à 2.x, só restaurando o backup que você fez antes.
• É beta. Em produção, o mais prudente é esperar a versão estável de dezembro e usar o tempo até lá para limpar o relatório.
• Quem está na 1.x tem trabalho dobrado. Não existe caminho direto da 1.x para a 3.x: primeiro vai para a 2.x. O blog diz que o suporte da 1.x termina em 31 de dezembro de 2026.
• Servidor próprio com npm. Se alguém instalou o n8n da empresa com npm, a mudança para Docker vem antes de tudo. Se você não sabe como foi instalado, pergunte a quem instalou antes de clicar em atualizar.

Perguntas frequentes

Preciso atualizar o n8n para a 3.0 agora?

Não. O que vale fazer agora é atualizar para a última 2.x e abrir o Migration Report. Segundo a n8n, a linha 2.x continua recebendo correções de segurança e de erros graves por 12 meses depois da versão estável.

Meus fluxos vão parar de funcionar com o n8n 3.0?

Só os que usam algo que foi removido ou mudou, e o relatório mostra quais são. Muitos são corrigidos automaticamente. Credenciais e histórico de execuções passam para a nova versão, segundo o FAQ do blog.

Uso o n8n na nuvem. Muda alguma coisa para mim?

Sim, as mudanças valem para a nuvem também. A diferença é que você não precisa se preocupar com Docker. O resto (relatório, fluxos com nós antigos, backup e teste) é igual.

Se você usa automação no dia a dia, vale ler também como a nota de confiança do Text Classifier ajuda na triagem e o guia sobre onde estudar n8n e o que aprender primeiro. Se você está avaliando outra ferramenta, veja o que é o Make e como criar o primeiro cenário.

No fim, a versão nova só expõe o que já estava ali: fluxo sem dono, montado sem padrão. Antes de atualizar ferramenta, organize o processo. Na Academ.IA, a trilha Automação e processos começa exatamente por aí: mapear o processo, definir o gatilho e só depois montar o fluxo.