n8n 3.0: o que revisar antes de atualizar seus fluxos
O n8n 3.0 traz mudanças que quebram fluxos: nós removidos, Docker obrigatório e novas variáveis. Revise esta lista antes de atualizar sua automação.
Você tem um fluxo que há meses passa os leads do formulário para o CRM sem falhar. Numa sexta-feira alguém atualiza o n8n "para ter a versão mais recente", e na segunda o fluxo não inicia porque usava um nó que não existe mais. Com uma versão maior como a 3.0, esse risco é real.
Este guia resume o que a documentação oficial pede para revisar, para que você atualize com calma e sem surpresas.
O que é o n8n 3.0 e por que ele importa?
É uma versão maior do n8n que remove nós antigos, muda configurações padrão e exige uma implantação diferente para quem hospeda por conta própria. A página de mudanças da versão 3.0 indica que, por enquanto, é um lançamento de acesso antecipado e não informa data de lançamento. Por isso vale se preparar agora e não correr para atualizar.
Se você ainda não usa a ferramenta, comece por o que é o n8n e como ele automatiza sem código.

Como sei quais fluxos vão quebrar?
Abra Settings > Migration Report na sua instância. Segundo a documentação do n8n, esse relatório lista os fluxos e as configurações que precisam de atenção antes de atualizar, e também pode migrar alguns fluxos, como os que usam os nós antigos AI Transform e Edit Image.
Faça isso como primeiro passo e guarde o resultado: é a sua lista de tarefas pendentes.
Erro comum: atualizar diretamente a instância de produção. Teste primeiro em uma cópia, com seus fluxos importados, e confirme que os mais importantes (leads, cobranças, avisos) continuam rodando.
Quais nós e funções desaparecem?
Vários nós antigos desaparecem, e os fluxos que os usam falham ao executar. A documentação esclarece que os fluxos publicados com um nó removido nem sequer são ativados na inicialização. Estas são algumas das mudanças mais relevantes:
| O que muda | O que você deve fazer |
|---|---|
| Nós Function e Function Item, Cron e Interval, HTML Extract, Read PDF e outros | Troque cada um pelo substituto indicado na documentação |
| AI Agent versão 1 e seus modos antigos | Use o Tools Agent na versão mais recente |
| Nós antigos da OpenAI | Substitua-os pelos nós atuais |
| Execute Sub-workflow com origem Local File ou URL | Use a origem Database ou Define Below |
| Edit Image versões 1 e 1.1 | Passe para a versão 2, que pode mudar o resultado |
Se a sua automação usa agentes de IA, veja também como escrever boas instruções para o seu agente, porque ao migrar de versão vale testá-las de novo.
O que muda se eu hospedo o n8n por conta própria?
Você precisa usar uma implantação com Docker: a documentação indica que as instalações com npm e npx n8n deixam de ser compatíveis. Há também mudanças de configuração que vale anotar:
- A pasta
~/.n8n/binaryDatapassa a se chamar~/.n8n/storage, e o n8n não inicia se as duas existirem. N8N_RUNNERS_TASK_TIMEOUTcai de 300 para 60 segundos.- A rotação da chave de criptografia vem ativada por padrão.
- A credencial do Slack API exige um signing secret, e um fluxo com Slack Trigger não é publicado até você adicioná-lo.

Quais comportamentos mudam sem aviso?
Alguns fluxos não falham, mas se comportam de forma diferente. São os mais perigosos porque ninguém vê um erro. A documentação menciona, por exemplo, que o nó Gmail Trigger ignora rascunhos a menos que você ative Include Drafts, e que e-mails enviados ou agendados deixam de disparar o fluxo. Também muda como o Always Output Data responde em nós com várias saídas, como If e Switch.
Por isso vale ter avisos quando um fluxo do n8n falha antes de migrar, e não depois.
Como atualizo com segurança?
Siga esta ordem: relatório, cópia, teste e só então produção.
- Abra Settings > Migration Report e anote o que está pendente.
- Faça uma cópia da sua instância e das suas credenciais.
- Corrija ou substitua os nós removidos na cópia.
- Execute os fluxos críticos com dados de teste.
- Atualize a produção em um horário de pouco tráfego, com alguém de plantão.
Se os seus fluxos dependem de chamadas entre sistemas, revise também o que são webhooks e como usá-los com o n8n.
Em resumo
O n8n 3.0 não é uma atualização para fazer numa sexta à tarde. É como o fluxo da segunda-feira que não iniciou: o que hoje funciona pode depender de uma peça que não existe mais. Revise o relatório de migração, teste em uma cópia e atualize com um plano. Se preferir que alguém faça isso por você, conheça nosso serviço de automação com n8n.
Perguntas frequentes
O que é o n8n 3.0?
É uma versão maior do n8n com mudanças que quebram a compatibilidade. A documentação oficial a descreve como uma versão de acesso antecipado e lista as mudanças que você deve revisar antes de atualizar.
Como sei se meus fluxos serão afetados?
Abra Settings > Migration Report. Segundo a documentação do n8n, esse relatório lista os fluxos e as configurações da sua instância que precisam de atenção, e pode migrar alguns fluxos, como os que usam AI Transform e Edit Image.
O que acontece com as instalações via npm?
A documentação indica que o n8n auto-hospedado deve usar uma implantação com Docker. As instalações com npm e npx n8n deixam de ser compatíveis.
O que acontece com um fluxo que usa um nó removido?
Segundo a documentação, os fluxos com nós removidos falham ao executar e os publicados deixam de ser ativados ao iniciar a instância.
Devo atualizar imediatamente?
Não. Primeiro revise o relatório de migração, teste em uma cópia da instância e só depois atualize a produção.
Não fique só na teoria: aplique no seu negócio
Implementamos automação com n8n de ponta a ponta, com a sua operação real. A primeira conversa não tem custo.




