IF no n8n: como criar condições no seu fluxo

Veja como usar o nó If no n8n: os tipos de condição, um exemplo passo a passo com true e false, AND e OR, a diferença para Switch e Filter e os erros comuns.

Por Redação Eleven Host · @robson.direitodigital · 28 de outubro de 2026 · 9 min de leitura

O IF no n8n é o nó que divide o fluxo em dois caminhos, true e false, conforme as condições que você define. O item que atende à condição sai pela saída true. O que não atende sai pela saída false.

Este guia explica para que serve o nó, quais tipos de condição existem, como montar um exemplo do zero e quando trocar o If por outro nó. Ele segue a documentação do n8n sobre os nós If, Switch e Filter e sobre expressões. Os campos valor e email do exemplo são fictícios. Troque pelos campos dos seus dados. Se você precisa de um gatilho para o exemplo abaixo, veja o guia Webhook no n8n: como criar, testar e colocar no ar.

Para que serve o nó If

Segundo a documentação do n8n, o nó If serve para dividir um fluxo de forma condicional, com base em comparações. Em palavras simples: o nó olha os dados que chegam, faz uma pergunta e manda cada item por um lado.

Imagine um fluxo que recebe pedidos. Pedidos de valor alto precisam de um aviso para a equipe comercial, e os demais só precisam ser registrados. O If separa os dois grupos: um sai pela saída true e o outro pela saída false. Cada saída se liga a nós diferentes e o fluxo segue por dois caminhos.

O nó tem duas saídas e só duas. Se o seu fluxo precisa de mais caminhos, existe outro nó para isso, explicado mais abaixo.

Os tipos de condição

Na configuração do nó, em Conditions, você escolhe o tipo de dado no menu, depois o operador e, por fim, o valor de comparação. Para acrescentar mais uma condição, use Add condition. Os tipos de dado da documentação são String, Number, Date & Time, Boolean, Array e Object.

String (texto)

Os operadores de texto, com os nomes da documentação, são: "exists", "does not exist", "is empty", "is not empty", "is equal to", "is not equal to", "contains", "does not contain", "starts with", "does not start with", "ends with", "does not end with", "matches regex" e "does not match regex". O último par compara o texto com uma expressão regular.

Number, Date & Time e Boolean

Em Number você encontra existe e não existe, vazio e não vazio, igual e diferente, maior que, menor que e as variantes "ou igual". Em Date & Time há os mesmos testes de existência e igualdade, mais "depois" (after) e "antes" (before), também com as variantes "ou igual". Em Boolean há "is true" e "is false", além dos testes de existência, vazio e igualdade.

Array e Object

Em Array, o n8n oferece existe, vazio, contém, não contém e comparações de tamanho (igual, diferente, maior, menor e as variantes "ou igual"). Em Object, só existem os testes de "existe" e "não existe" e de "vazio" e "não vazio".

De onde vem o valor comparado

O campo que você compara vem dos dados do nó anterior. Para isso, o n8n usa expressões: segundo a documentação, são pequenos trechos de código parecidos com JavaScript, escritos entre chaves duplas. Os exemplos da documentação são {{$json.city}} e {{$json.body.city}}, que pegam um campo dos dados que chegam. No exemplo deste guia, o campo será {{ $json.valor }}.

Quer um n8n para montar seus fluxos? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Passo a passo: um exemplo prático

Vamos montar um fluxo que recebe um pedido e avisa o comercial quando o valor passa de 500. Siga a ordem:

1. Crie um fluxo novo e adicione o gatilho que recebe o pedido. Um webhook serve bem; o guia Webhook no n8n mostra como criar e testar.
2. Envie ao gatilho um pedido de teste que tenha um campo valor, por exemplo valor igual a 700, para o n8n ter dados de exemplo.
3. Adicione o nó If depois do gatilho, ligando a saída do gatilho à entrada do If.
4. Em Conditions, escolha o tipo Number.
5. No campo do valor a comparar, informe a expressão {{ $json.valor }}.
6. No operador, escolha is greater than (maior que).
7. No valor de comparação, digite 500.
8. Rode o nó. O pedido de teste, com valor 700, sai pela saída true.
9. Ligue a saída true ao nó que avisa o comercial por e-mail e a saída false ao nó que só registra o pedido na planilha.

Teste também com um valor abaixo de 500, como 300. Esse pedido deve sair pela saída false. Testar os dois lados antes de ativar o fluxo mostra se a condição está certa.

Outro exemplo, com texto: escolha o tipo String, a expressão {{ $json.email }}, o operador ends with e o valor @exemplo.com.br. Os e-mails que terminam assim saem pela saída true.

Várias condições: AND e OR

Você pode juntar condições no mesmo nó com o seletor AND ou OR. A documentação explica a diferença:

• AND: o item precisa atender a cada uma das condições para sair pela saída true.
• OR: o item sai pela saída true se atender a pelo menos uma das condições.

Um exemplo com AND: o valor do pedido é maior que 500 e o campo email não está vazio. O aviso só vai para o comercial quando as duas coisas forem verdadeiras. Um exemplo com OR: o valor é maior que 500 ou o cliente é marcado como prioritário. Atender a uma das duas já leva o item à saída true.

Se o fluxo roda de tempos em tempos, por exemplo para checar pedidos novos de hora em hora, o gatilho de agenda do guia Agendar fluxo no n8n: como usar o Schedule Trigger pode vir antes do If. A lógica do If é a mesma.

If, Switch ou Filter

O n8n tem três nós parecidos, e a escolha depende do que você quer fazer com os itens:

• If: manda os dois grupos adiante, um por cada saída. Use quando os itens que não atendem à condição também precisam de um destino.
• Switch: a documentação do If indica que, se você precisa de mais de duas saídas, deve usar o Switch. Ele é parecido com o If, mas aceita várias rotas de saída. Tem dois modos: Rules, com uma regra para cada saída, e Expression, em que uma expressão devolve o número da saída. O item que não bate com nenhuma regra segue pela opção de saída reserva, o Fallback Output, que pode ser None (ignora o item; é o padrão), Extra Output (uma saída extra) ou Output 0.
• Filter: só deixa passar quem atende à condição. Segundo a documentação, se o item não atende, o Filter o omite da saída. Ele tem uma saída só, e o resto é descartado.

Uma regra prática: se o grupo que não atende à condição não interessa, o Filter resolve. Se os dois grupos interessam, use o If. Se são três ou mais destinos, use o Switch.

A documentação do Filter lista duas opções, Ignore Case e Less Strict Type Validation, que ignoram maiúsculas e minúsculas e relaxam a validação de tipo. No If, conforme a versão, o nó pode ter opções como ignorar maiúsculas e minúsculas e validação de tipo menos rígida. Procure na tela do seu n8n.

Erros comuns

Quando o item sai pelo lado errado, confira estes pontos:

• Tipo do dado: escolha o tipo de condição de acordo com o campo. Se o campo chega como texto, uma comparação de número pode não funcionar como esperado. Olhe os dados de entrada do nó e veja se o campo aparece como texto ou como número.
• Maiúsculas e minúsculas: "Gmail" e "gmail" são textos diferentes numa comparação que diferencia letras. Se o seu dado varia, confira as opções do nó na sua versão, como descrito acima.
• Campo vazio ou ausente: um pedido sem o campo valor não tem o que comparar. Use os operadores "exists" e "is not empty" para tratar esse caso antes de comparar.
• Caminho do campo errado: se os dados chegam dentro de body, a expressão é {{$json.body.valor}}, como no exemplo {{$json.body.city}} da documentação. Veja a estrutura no painel de dados do nó anterior.
• Merge depois do If: segundo a documentação, na ordem de execução antiga (v0) um Merge depois do If podia fazer as duas saídas rodarem, e a documentação diz que o n8n removeu esse comportamento no n8n 1.0. Se um fluxo antigo se comporta de forma diferente, esse pode ser o motivo.

Para fluxos que chamam uma API antes do If, o guia HTTP Request no n8n: como chamar uma API no fluxo mostra como trazer os dados que o If vai avaliar.

Quer montar fluxos com condições no seu próprio n8n? Veja o n8n Essencial a partir de R$ 19,90/mês e confira na loja o que cada plano inclui. Conhecer o n8n

Perguntas frequentes

Quantas saídas o nó If tem?

Duas: true e false. Quem atende à condição sai pela true, e quem não atende sai pela false. Para mais de duas saídas, use o nó Switch.

Qual a diferença entre If e Filter no n8n?

O If manda os dois grupos adiante, cada um por uma saída. O Filter deixa passar só os itens que atendem à condição e descarta o resto, com uma única saída.

Como usar duas condições no mesmo If?

Clique em Add condition e escolha entre AND e OR. Com AND, o item precisa atender a cada uma das condições. Com OR, ele precisa atender a pelo menos uma.

O que acontece com o item que não atende à condição?

Ele não é descartado: sai pela saída false do If e segue pelos nós que você ligar a ela. Quem descarta o item é o nó Filter.