Ir para o conteúdo
Promovaweb

Expressões

Revisado em

Antes de começar

Preencher um parâmetro com um valor que vem do item recebido pelo node.

  • Ter lido o guia Itens e JSON.

Uma expressão é um trecho entre chaves duplas que o n8n calcula na hora de executar o node. Ela permite usar, em qualquer parâmetro, um valor que veio de antes no workflow.

O item atual com $json

$json aponta para os campos do item que o node está processando. Se um webhook recebe este corpo:

{ "body": { "nome": "Ana", "cidade": "São Paulo" } }

a expressão abaixo devolve São Paulo:

{{ $json.body.cidade }}

O mesmo caminho também pode ser escrito com colchetes: {{ $json['body']['cidade'] }}. Use essa forma quando o nome do campo tiver espaço ou hífen.

Campos de um node anterior

Para buscar um valor de outro node, use o nome dele:

{{ $('Webhook').item.json.body.nome }}

O .item traz o item ligado ao item atual. Essa ligação entre itens se chama item linking e tem um guia próprio na área de guias.

Escreva no modo expressão

Em qualquer parâmetro, troque de Fixed para Expression. O campo mostra a prévia do resultado embaixo, calculada com os itens da última execução. Se a prévia aparecer vazia, execute o node anterior primeiro.

Prefira o Edit Fields para transformar

A documentação recomenda concentrar as transformações no node Edit Fields (Set). Prepare os campos ali e deixe os nodes seguintes só com mapeamentos simples. O workflow fica mais fácil de ler e de corrigir.

Confira o resultado

O campo montado com a expressão mostra, na saída, o valor de cada item recebido.

Fontes e conferência

Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.