CRM e automação

n8n 3.0: o que revisar antes de atualizar seus fluxos

Por Edgar Jaimes 4 min de leitura

Notebook sobre uma mesa de madeira com código aberto na tela

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.

Notebook com código na tela ao lado de uma planta sobre uma mesa
Antes de mexer na produção, veja quais partes dos seus fluxos dependem de peças antigas. Foto: Unsplash

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 mudaO que você deve fazer
Nós Function e Function Item, Cron e Interval, HTML Extract, Read PDF e outrosTroque cada um pelo substituto indicado na documentação
AI Agent versão 1 e seus modos antigosUse o Tools Agent na versão mais recente
Nós antigos da OpenAISubstitua-os pelos nós atuais
Execute Sub-workflow com origem Local File ou URLUse a origem Database ou Define Below
Edit Image versões 1 e 1.1Passe 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/binaryData passa a se chamar ~/.n8n/storage, e o n8n não inicia se as duas existirem.
  • N8N_RUNNERS_TASK_TIMEOUT cai 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.
Cabos de rede azuis conectados a um painel de conexões numerado
O servidor onde sua automação vive também muda: no 3.0 ele passa para o Docker. Foto: Unsplash

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.

  1. Abra Settings > Migration Report e anote o que está pendente.
  2. Faça uma cópia da sua instância e das suas credenciais.
  3. Corrija ou substitua os nós removidos na cópia.
  4. Execute os fluxos críticos com dados de teste.
  5. 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.

Continue lendo