O que é Node?

O que é um Node no n8n

Node é um componente configurável que participa de um workflow do n8n. Ele pode iniciar uma execução, buscar informações, enviar uma mensagem ou controlar o caminho seguido pela automação, conforme o tipo e a ação configurada.

Quando você monta um cadastro de inscritos, por exemplo, pode usar um Node para receber o formulário e outro para consultar se o email já existe no sistema de contatos. Cada componente tem parâmetros próprios, e a conexão entre eles determina como os resultados chegam às próximas etapas.

O nome também aparece em Node.js, mas representa outro conceito. O Node.js é um runtime de JavaScript, enquanto o Node do n8n é uma peça da automação que você configura no editor.

Tipo, operação e parâmetros

O tipo do Node informa quais funções ele oferece. Um componente de integração pode disponibilizar ações para criar ou consultar contatos. Você seleciona a ação, informa os campos necessários e associa uma credencial compatível.

Os parâmetros podem conter valores fixos ou expressões que usam informações recebidas durante a execução. Um endereço de email digitado diretamente no campo será reutilizado, enquanto uma expressão pode buscar o destinatário na inscrição que chegou naquele momento.

Essa diferença explica por que um teste aparentemente correto pode enviar todas as confirmações para a mesma pessoa. Ao revisar a configuração, confira se o destinatário vem da entrada atual ou se permaneceu preenchido com o endereço usado no primeiro teste.

O que entra e o que sai do componente

O n8n trabalha com itens que transportam informações entre etapas. Um Node pode receber vários itens e produzir uma quantidade diferente na saída, como ocorre quando uma consulta retorna várias inscrições ou um filtro descarta as que não atendem à condição.

Por isso, você precisa observar tanto os campos quanto a quantidade de resultados. Uma saída vazia pode significar que a consulta não encontrou nenhum contato, e a continuação do fluxo deve considerar esse caso em vez de presumir que sempre haverá um identificador disponível.

Credenciais e comportamento diante de erros

Os Nodes que acessam serviços protegidos precisam de credenciais com as permissões necessárias. O n8n oferece um cadastro próprio para essas credenciais, evitando que você tenha de escrever uma chave de API como texto comum em cada etapa que usa o mesmo serviço.

Uma falha também exige leitura da configuração. Se o componente foi preparado para continuar por um caminho de erro, as etapas seguintes podem receber informações sobre a falha em vez do contato que você pretendia criar.

Como verificar um Node

Abra a entrada e a saída da etapa durante um teste e compare os campos com a tarefa esperada. Para o cadastro de inscritos, confira o email usado, o identificador devolvido pelo serviço e o comportamento quando o contato já existe.

Um erro apresentado no Node de envio pode ter começado no mapeamento anterior. A mensagem da integração localiza o ponto da recusa, mas a comparação entre entrada, parâmetros e saída é que mostra se o problema veio do serviço ou do conteúdo encaminhado pelo workflow.

Aplicação na formação

n8n Experts

Nodes executam funções dentro do workflow e precisam de parâmetros e conexões compatíveis com o resultado esperado.

Conhecer a formação →