n8n: Fundamentos técnicos — entendendo os nós Filter, Switch, Set e If/Else

Sumário - Neste artigo você vai ver:

1. Introdução

2. If/Else

3. Switch

4. Filter

5. Set/Edit fields

6. Em resumo...

1. Introdução

Quem começa a automatizar com n8n geralmente se deslumbra com a quantidade de coisa que tem disponível. Conectar o Google Sheets ao WhatsApp ou o Typeform ao Slack. Mas, à medida que os projetos amadurecem, percebemos uma verdade fundamental: o poder real do n8n não está nas pontas, mas no meio.

A robustez de um workflow depende de como você trata, decide e limpa os dados antes que eles cheguem ao destino, isso é importante para organização e consistência nos dados. Hoje, vamos mergulhar nos quatro pilares da lógica de fluxo no n8n: If, Switch, Filter e Set (agora conhecido como Edit Fields).

2. If: Verdadeiro ou falso

enter image description here

O nó If é o operador booleano clássico. Ele divide o seu fluxo em dois caminhos distintos: True (Verdadeiro) e False (Falso).

Quando usar: Quando você tem uma pergunta de resposta "Sim ou Não".
Exemplo Prático: Blacklist Você recebeu um lead e quer decidir se ele será respondido ou não, neste caso vamos supor que ele está numa blacklist no seu banco de dados.
- Condição: O campo telefone vindo do banco de dados NÃO é igual ao número do lead?
- True: Se NÃO é igual, a automação deve continuar.
- False: Se É igual, a automação deve continuar.
Dica Técnica: Evite encadear vários "Ifs" seguidos. Se você precisa de mais de duas saídas, use o próximo nó da lista.

3. Switch: O Controlador de Tráfego

enter image description here

Enquanto o If lida com binários (Sim ou não), o Switch lida com múltiplas possibilidades baseadas em regras ou em uma expressão específica. É a versão limpa do if/else if/else.

Quando usar: Quando um dado pode ter vários valores diferentes e cada um exige uma ação diferente.
Exemplo Prático: Triagem de Suporte ao Cliente via WhatsApp.
- Se a mensagem contém "Financeiro" → O fluxo segue pela rota 1 que poderia ser a Equipe Financeira, por exemplo.
- Se a mensagem contém "Bug" → O fluxo segue pela rota 2 que seria uma Equipe de Devs.
- Se a mensagem contém "Dúvida" → O fluxo segue pela rota 3 que poderia ser um FAQ ou atendimento de um agente de ia (ensinamos a base para criar um agente de ia neste post: Agentes de IA: O que são e como funcionam?)
- Fallback (Nenhuma das anteriores) → O fluxo segue pela rota 4 (Menu de Opções).

4. Filter: O Porteiro

enter image description here

Muita gente confunde o Filter com o If. A diferença é arquitetural: o If divide o fluxo, o Filter interrompe o fluxo APENAS para os itens que não atendem à regra.

Quando usar: Quando você quer higienizar os dados e descartar o que não serve antes de processar, economizando execuções de nós subsequentes.
Exemplo Prático: Processamento de planilhas.
- Você puxou 100 leads do seu CRM. O Filter remove os leads que estão na pipeline de leads perdidos, por exemplo. O fluxo continuará apenas com os dados válidos, e os inválidos "morrem" ali, sem gerar erros lá na frente.

5. Set (Edit Fields): O Transformador

enter image description here

Este é, muito provavelmente, o nó mais importante para manter a sanidade do desenvolvedor. Ele permite criar, remover ou alterar variáveis dentro do JSON.

Quando usar:
1. Limpeza: O JSON de uma API normalmente vem com dezenas de informações que não precisamos. Você pode selecionar apenas aquilo que deseja para passar para frente como o nome, email e telefone.
2. Padronização: Renomear campos difíceis (ex: field_123_x) para algo legível (ex: data_venda).
3. Variáveis Globais: Definir valores que serão usados em vários pontos do fluxo.