flowtemplates

n8n · tutorial · verificado em 6 de setembro de 2026

Como importar um modelo do n8n

Um modelo do n8n é um arquivo JSON de fluxo comum, e há dois caminhos para colocá-lo dentro: copiar o JSON e colar com Ctrl+V (Cmd+V no Mac) em um canvas vazio, ou abrir o menu de três pontos no canto superior direito e escolher «Import from File» ou «Import from URL». Qualquer um dos dois leva menos de um minuto.

Dois avisos antes de começar. O editor do n8n está em inglês: o repositório do n8n traz um único arquivo de idioma, en.json, então os itens do menu se chamam «Download», «Import from File» e «Import from URL» mesmo com o navegador em português. E os avisos de credencial que aparecem depois de importar são normais, não são falha: o modelo carrega apenas marcadores.

Os sete passos

  1. Pegue o JSON do fluxoNa página de um modelo, clique em Copy JSON ou baixe o arquivo .json. Nossos arquivos são higienizados: sem chaves reais, sem tokens, só marcadores como {{YOUR_SLACK_CREDENTIAL}}.
  2. Abra um fluxo vazioEm Workflows, crie um novo. Importe sempre em um canvas vazio: a importação acrescenta nós ao canvas atual, não substitui o que já está lá.
  3. Cole ou importeClique no canvas e pressione Ctrl+V, ou use ⋯ → «Import from File» e escolha o arquivo. O n8n reconstrói todos os nós e as ligações.
  4. Reconecte suas credenciaisCada nó marcado abre com um campo de credencial. Crie uma nova ou selecione uma existente e autentique com a sua própria conta.
  5. Ajuste os parâmetrosPreencha o que é seu: o ID de uma planilha, um canal do Slack, uma pasta, um caminho de webhook. A tabela de cada página de modelo diz exatamente o que preencher.
  6. Execute uma vezCom Execute Workflow, rode um teste com dados de exemplo e confirme que todos os nós ficam verdes.
  7. Publique o fluxoSó a partir daí o n8n registra webhooks de produção e liga os agendamentos. Se depois de publicar a chamada devolver 404, siga «webhook não registrado».

O que vai dentro do arquivo — e o que apagar antes de compartilhar

O JSON descreve nós, parâmetros e conexões, e não inclui os valores das credenciais. A documentação do n8n, porém, é mais exata do que a maioria dos tutoriais: os arquivos exportados contêm nomes e identificadores de credenciais. Os identificadores não representam risco; os nomes podem representar, dependendo de como você batiza as coisas. O n8n acrescenta ainda que nós HTTP Request importados a partir de um comando cURL podem conter cabeçalhos de autenticação.

Na prática: revise qualquer exportação sua antes de colar em fórum, chamado ou repositório público. O nosso validador de JSON de fluxos faz exatamente essa passagem dentro do navegador — procura padrões de chave e token e lista os tipos de credencial referenciados, sem enviar o arquivo para lugar nenhum.

Quando a importação falha, quem decide é a mensagem

O n8n usa frases diferentes para causas diferentes. Leia a sua antes de mexer no arquivo.

  • «Could not import file» / «The file does not contain valid JSON data»O arquivo não é JSON válido. Quase sempre uma vírgula sobrando ou aspas tipográficas que entraram ao copiar de um chat ou de um documento.
  • «The imported data does not contain valid workflow data (‘nodes’ and ‘connections’ are missing)»JSON válido, formato errado. Normalmente um nó solto copiado, ou uma resposta da API com o fluxo ainda embrulhado em um objeto data.
  • «Skipped N node(s) with missing type»A importação funcionou, mas a sua instância não conhece aqueles tipos de nó: em geral nós da comunidade que precisam ser instalados antes.
  • No terminal: <code>SQLITE_CONSTRAINT: NOT NULL constraint failed: workflow_entity.id</code>Reproduzido no n8n 2.25.7: n8n import:workflow exige um campo id de primeiro nível, e o editor não. Acrescente qualquer texto único como "id".

As oito mensagens — quatro do editor e quatro do terminal — com causa e correção estão em «não foi possível importar o arquivo».

Importar pelo terminal

Em instâncias auto-hospedadas, o n8n documenta n8n import:workflow --input=arquivo.json e --separate --input=pasta/ para um diretório inteiro. Por padrão, o import:workflow desativa tudo o que importa; com --activeState=fromJson ele preserva o campo active de cada arquivo — opção que a documentação restringe aos modos multi-main e de fila.

Duas diferenças em relação ao editor. A primeira é o campo id já citado. A segunda é prática: para um fluxo só, colar é mais rápido do que abrir um terminal. Se a instância ainda não existe, o passo a passo está no guia do n8n auto-hospedado.

Fontes e data da verificação

Os nomes de menu e as regras de importação vêm da documentação do n8n, lida em 6 de setembro de 2026; os erros de terminal foram reproduzidos no mesmo dia no n8n 2.25.7 sobre Docker.

Perguntas frequentes

Onde fica «Import from File» no n8n?

No menu de três pontos (⋯) no canto superior direito do editor de fluxos. Segundo a documentação do n8n, é ali que ficam «Import from URL» e «Import from File»; pelo mesmo caminho se exporta com «Download». Também dá para colar o JSON copiado direto no canvas com Ctrl+V ou Cmd+V.

Por que aparecem erros de credencial depois de importar?

Porque é o comportamento esperado. Os modelos trazem apenas marcadores, então o n8n sinaliza cada nó afetado até você conectar a sua própria conta. Abra os nós marcados e crie ou escolha uma credencial. Isso não é importação com falha.

A importação sobrescreve meus fluxos atuais?

Não. A importação coloca os nós no canvas que estiver aberto. Importe em um fluxo novo e vazio se quiser manter tudo separado; caso contrário, os nós novos aparecem ao lado dos que já existiam.

É seguro colar um JSON de fluxo de outra pessoa?

O arquivo descreve nós, parâmetros e conexões, e não carrega valores de credenciais. Ainda assim, a documentação do n8n avisa que as exportações contêm nomes e identificadores de credenciais, e que nós HTTP Request importados de cURL podem incluir cabeçalhos de autenticação. Revise arquivos de terceiros antes de executar, e os seus antes de compartilhar.

Dá para importar uma pasta inteira de fluxos de uma vez?

Dá, mas só pelo terminal: n8n import:workflow --separate --input=<pasta>. Por padrão todos os fluxos importados ficam desativados; com --activeState=fromJson o n8n respeita o campo active de cada arquivo, opção que a documentação limita aos modos multi-main e de fila.

Por que o mesmo arquivo entra pelo editor e não pelo terminal?

Porque o terminal escreve direto no banco de dados. No n8n 2.25.7, um JSON sem campo «id» de primeiro nível falhou com SQLITE_CONSTRAINT: NOT NULL constraint failed: workflow_entity.id, e ao acrescentar um «id» o mesmo arquivo importou normalmente. Arquivos de modelo higienizados costumam omitir esse campo de propósito.