Sintaxe de Expressões do n8n

Guia especializado para escrever expressões corretas do n8n em fluxos de trabalho.

Guia Detalhado

Leia o guia detalhado antes de executar esta habilidade. Ele retém o procedimento completo e o material de referência. Trate seus requisitos de segurança, pré-requisitos e validação como obrigatórios. Para trabalho focado, carregue as seções relevantes; para trabalho de ponta a ponta, leia o guia completamente.

Quando Usar

• Você precisa escrever ou depurar expressões do n8n usando a sintaxe {{ ... }}.
• A tarefa envolve $json, $node, cargas úteis de webhook ou erros de fluxo de trabalho relacionados a expressões.
• Você deseja valores dinâmicos com sintaxe correta dentro de nós e parâmetros do n8n.

Quando NÃO Usar Expressões

❌ Nós de Código

Nós de código usam acesso direto a JavaScript, NÃO expressões!

// ❌ WRONG in Code node
const email = '={{$json.email}}';
const name = '{{$json.body.name}}';

// ✅ CORRECT in Code node
const email = $json.email;
const name = $json.body.name;

// Or using Code node API
const email = $input.item.json.email;
const allItems = $input.all();

❌ Caminhos de Webhook

// ❌ WRONG
path: "{{$json.user_id}}/webhook"

// ✅ CORRECT
path: "user-webhook"  // Static paths only

❌ Campos de Credenciais

// ❌ WRONG
apiKey: "={{$env.API_KEY}}"

// ✅ CORRECT
Use n8n credential system, not expressions

Exemplos de Trabalho

Para exemplos de fluxos de trabalho reais, veja EXAMPLES.md

Exemplo 1: Webhook para Slack

Webhook recebe:

{
  "body": {
    "name": "John Doe",
    "email": "john@example.com",
    "message": "Hello!"
  }
}

No campo de texto do nó Slack:

New form submission!

Name: {{$json.body.name}}
Email: {{$json.body.email}}
Message: {{$json.body.message}}

Exemplo 2: Requisição HTTP para E-mail

Requisição HTTP retorna:

{
  "data": {
    "items": [
      {"name": "Product 1", "price": 29.99}
    ]
  }
}

No nó de E-mail (referenciando a Requisição HTTP):

Product: {{$node["HTTP Request"].json.data.items[0].name}}
Price: ${{$node["HTTP Request"].json.data.items[0].price}}

Exemplo 3: Formatar Timestamp

// Current date
{{$now.toFormat('yyyy-MM-dd')}}
// Result: 2025-10-20

// Time
{{$now.toFormat('HH:mm:ss')}}
// Result: 14:30:45

// Full datetime
{{$now.toFormat('yyyy-MM-dd HH:mm')}}
// Result: 2025-10-20 14:30

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.