표현식

노드 파라미터 값에 표현식을 넣어 이전 노드의 데이터나 실행 컨텍스트를 참조할 수 있습니다.

기본 규약 — 값 전체가 ={{ … }} 하나

파라미터 값 전체가 정확히 ={{ 표현식 }} 한 덩어리일 때만 해석됩니다.

={{ $json.message.text }}        ✅ 해석됨
={{ $('트리거').item.json.id }}  ✅ 해석됨 (지원 노드에서)
=안녕 {{ $json.name }} 님        ❌ 부분 보간 미지원 — 원문 그대로 전달됨
={{ $json.a }}{{ $json.b }}      ❌ 다중 세그먼트 미지원 — 원문 그대로 전달됨

주의

리터럴 문자열과 표현식을 섞는 부분 보간은 지원되지 않습니다. 문자열 조합이 필요하면 필드 설정(Set) 노드로 값을 먼저 만들거나, 대상 노드가 지원하는 범위 안에서 단일 표현식으로 구성하세요.

또한 표현식은 데이터 경로 참조이지 JavaScript 실행이 아닙니다 — 임의의 JS 코드(연산·함수 호출)는 평가되지 않습니다.

지원 심볼

심볼	의미	예
$json	현재 노드로 들어온 입력 아이템의 json — 닷 경로로 하위 필드 접근	={{ $json.user.email }}
$('노드명')	다른 노드의 출력 참조 (.item / .first() / .last() 뒤에 .json.경로)	={{ $('텔레그램 트리거').item.json.message.chat.id }}
$parameter	현재 노드의 다른 파라미터 값	={{ $parameter.chatId }}
$now / $today	현재 시각 / 오늘 날짜	={{ $now }}
$workflow	워크플로우 정보(id·name 등)	={{ $workflow.id }}
$execution	실행 정보	={{ $execution.id }}, ={{ $execution.mode }}
$binary	바이너리 데이터 참조	={{ $binary }}
$item	현재 아이템	={{ $item }}

노드에 따라 지원 심볼이 다릅니다

모든 노드가 위 심볼 전부를 해석하는 것은 아닙니다 — 예를 들어 많은 데이터 변환 노드는 $json 닷 경로만 지원합니다. 표현식 에디터(fx)가 현재 노드에서 지원되는 범위를 표시하고, 지원 밖 문법에는 경고를 띄웁니다. 각 노드 페이지의 파라미터 설명에 "표현식 사용 가능" 여부가 적혀 있습니다.

배열 요소는 지원 컨텍스트에서 photo.last().file_id 처럼 .first()/.last() 를 쓰거나 인덱스 접근을 사용합니다.

표현식 에디터 (fx)

파라미터 입력칸 옆의 fx 버튼을 누르면 표현식 에디터 모달이 열립니다.

• 변수 피커 — 왼쪽에 $json 트리(현재 입력 스키마)와 $('노드') 서브트리가 표시됩니다. 항목을 클릭/드래그하면 표현식이 삽입됩니다.
• 하이라이트 편집기 — {{ }} 구간이 구문 강조된 편집 영역.
• 라이브 미리보기 — 실제 데이터 기준의 평가 결과를 즉시 보여줍니다. 현재 노드가 지원하지 않는 문법은 빨간 경고로 표시됩니다(가짜 평가를 하지 않습니다).
• 문법 도움말 — 지원 심볼 요약이 함께 표시됩니다.

NDV Schema 드래그

표현식을 타이핑하는 대신, NDV 의 INPUT Schema 뷰에서 키를 파라미터 칸으로 드래그하면 ={{ $json.경로 }} 가 자동 삽입됩니다. 가장 실수가 적은 방법입니다. → 노드 상세 (NDV)