첫 워크플로우 만들기 — 매뉴얼 트리거 실습

🎯 학습 목표

이 강을 마치면 다음을 할 수 있습니다.

• Manual Trigger 노드를 추가하고 워크플로우의 시작점을 만들 수 있습니다.
• Set 노드로 원하는 데이터를 직접 생성할 수 있습니다.
• 워크플로우를 저장하고 실행한 뒤 결과를 확인할 수 있습니다.
• 노드 간 데이터가 전달되는 흐름 구조를 정확히 이해합니다.

💡 첫 워크플로우 전에 알아야 할 것

이 섹션에서는 실습 전 꼭 알아야 할 n8n 데이터 모델의 기본 개념을 살펴보겠습니다.

n8n에서 노드와 노드 사이를 오가는 데이터는 항상 items(아이템) 배열 형태입니다. 하나의 아이템은 JSON 객체이며, 각 노드는 이 배열을 받아서 처리하고 새로운 배열을 내보냅니다. 예를 들어 Gmail 노드가 이메일 3개를 가져오면 3개의 아이템이 담긴 배열이 다음 노드로 전달됩니다. 다음 노드는 이 배열을 받아 각 아이템을 순서대로 처리합니다.

이 구조가 중요한 이유는, n8n이 자동으로 각 아이템에 대해 노드를 반복 실행하기 때문입니다. 개발자 언어로 말하면 for-each 루프가 자동으로 적용됩니다. 즉 30개의 이메일이 있을 때 다음 노드에 루프 코드를 작성하지 않아도, n8n이 알아서 30번 실행해줍니다. 이 개념을 이해하고 있으면 이후 복잡한 워크플로우 설계가 훨씬 쉬워집니다.

🖱️ 1단계 — Manual Trigger 노드 추가하기

이 섹션에서는 워크플로우의 시작점인 Manual Trigger 노드를 추가하는 방법을 살펴보겠습니다.

새 워크플로우를 만들면 캔버스에 When clicking 'Test workflow'라는 이름의 노드가 이미 배치되어 있습니다. 이것이 바로 Manual Trigger 노드입니다. 이 노드는 사용자가 직접 버튼을 눌러야만 실행되는 트리거로, 자동 실행 없이 개발·테스트용으로 워크플로우를 직접 시작할 때 사용합니다.

Manual Trigger를 클릭하면 오른쪽에 설정 패널이 열립니다. 이 노드는 설정 옵션이 거의 없습니다 — 클릭하면 실행된다는 단순한 역할이 전부이기 때문입니다. 하단의 [Add first step] 또는 노드 오른쪽 + 버튼을 클릭해서 다음 노드를 추가할 준비를 합니다.

실제 운영 워크플로우에서는 Manual Trigger 대신 Schedule Trigger(정기 실행), Webhook Trigger(외부 이벤트), Gmail Trigger(새 이메일) 같은 트리거를 사용합니다. 하지만 개발 단계에서는 Manual Trigger를 사용해 언제든지 원하는 시점에 테스트할 수 있습니다.

📦 2단계 — Set 노드로 데이터 만들기

이 섹션에서는 데이터를 직접 생성하고 가공하는 Set 노드의 사용법을 살펴보겠습니다.

Set 노드는 n8n에서 가장 자주 쓰이는 핵심 노드 중 하나입니다. 기존 아이템에 새 필드를 추가하거나, 기존 필드 값을 변경하거나, 완전히 새로운 데이터를 만들 때 사용합니다. Manual Trigger 다음에 Set 노드를 추가해보겠습니다.

노드 패널에서 'Set'을 검색하거나, Manual Trigger의 + 버튼을 클릭한 뒤 Set을 선택합니다. Set 노드 설정 패널이 열리면 상단의 Manual Mapping 탭이 선택되어 있습니다. [Add field] 버튼을 클릭하고 다음과 같이 입력합니다.

• Name(필드명): greeting
• Value(값): 안녕하세요, n8n!

[Add field]를 한 번 더 클릭해 두 번째 필드를 추가합니다.

• Name: timestamp
• Value: {{ $now.toISO() }}

두 번째 필드의 Value는 고정 문자열이 아니라 표현식(Expression)입니다. 중괄호 두 개({{ }}) 안에 들어가는 내용은 n8n이 동적으로 계산합니다. $now는 현재 시각을 나타내는 n8n 내장 변수이고, .toISO()는 ISO 8601 형식의 문자열로 변환하는 메서드입니다. 실행 시점의 시각이 자동으로 입력됩니다.

▶️ 3단계 — 저장하고 실행하기

이 섹션에서는 워크플로우를 저장하고 실행해서 결과를 확인하는 방법을 살펴보겠습니다.

노드 설정이 끝났다면 탑바의 [Save] 버튼(또는 Ctrl+S)을 눌러 워크플로우를 저장합니다. n8n은 자동 저장을 지원하지 않으므로 중간중간 수동으로 저장하는 습관이 중요합니다. 저장 후 탑바 오른쪽의 [Test workflow] 버튼을 클릭합니다.

워크플로우가 실행되면 각 노드 아래에 실행 결과가 표시됩니다. 초록색 체크마크와 함께 '1 item'이라는 표시가 나타나면 성공입니다. Set 노드를 클릭하고 오른쪽 패널의 [OUTPUT] 탭을 확인합니다. 다음과 같은 JSON 데이터가 출력되어야 합니다.

[
  {
    "greeting": "안녕하세요, n8n!",
    "timestamp": "2026-06-18T12:34:56.789Z"
  }
]

greeting은 우리가 입력한 문자열 그대로, timestamp는 실행 시점의 현재 시각이 ISO 형식으로 채워진 것을 확인할 수 있습니다. 이것이 n8n 워크플로우의 가장 기본적인 동작 — 데이터를 생성하고 다음 노드로 전달 — 입니다.

🔍 데이터 흐름 완전 이해

이 섹션에서는 노드 간 데이터가 실제로 어떻게 전달되는지 더 깊이 살펴보겠습니다.

앞서 만든 워크플로우에서 Manual Trigger는 빈 아이템 하나를 Set 노드에 전달합니다. Set 노드는 이 아이템에 greeting과 timestamp 필드를 추가해서 내보냅니다. 만약 Set 노드 뒤에 또 다른 노드를 추가한다면, 그 노드는 greeting과 timestamp가 포함된 데이터를 INPUT으로 받게 됩니다.

이때 중요한 개념이 데이터 누적(Data Accumulation)입니다. 기본적으로 각 노드는 이전 노드의 출력을 받아 수정하거나 새로운 데이터를 추가합니다. Set 노드의 Keep Only Set Fields 옵션을 켜면 Set 노드에서 명시적으로 설정한 필드만 남기고 이전 데이터는 모두 제거됩니다. 이 옵션을 끈 상태(기본값)에서는 이전 노드의 모든 데이터에 새 필드가 추가됩니다.

표현식을 통해 이전 노드의 데이터를 참조하는 방법도 이해해야 합니다. Set 노드에서 Value 필드에 {{ $json.greeting }}이라고 입력하면, 현재 아이템의 greeting 필드 값을 참조합니다. $json은 현재 처리 중인 아이템의 JSON 데이터를 가리키는 내장 변수입니다. 이 표현식 시스템은 7강에서 더 자세히 다루므로 지금은 개념만 기억해 두십시오.

⚠️ 자주 하는 실수와 주의점

이 섹션에서는 처음 워크플로우를 만들 때 흔히 마주치는 문제와 해결 방법을 살펴보겠습니다.

첫 번째 실수는 워크플로우를 저장하지 않고 실행하는 것입니다. n8n은 저장하지 않은 변경사항도 테스트 실행이 가능하지만, 서버 재시작 시 저장되지 않은 내용은 사라집니다. 변경 후 반드시 Ctrl+S를 눌러 저장하는 습관을 들이십시오.

두 번째 실수는 Active 토글을 켜놓은 채로 개발하는 것입니다. 스케줄 트리거나 웹훅 트리거가 있는 워크플로우를 Active 상태로 두면 실제로 자동 실행됩니다. 개발·수정 중에는 반드시 Active 토글을 끄고 작업하십시오.

세 번째 실수는 표현식 문법 오류입니다. 표현식은 {{ }} 안에 작성해야 하며, 여는 중괄호와 닫는 중괄호 개수가 맞아야 합니다. 표현식이 오류를 일으키면 해당 노드가 빨간색으로 표시됩니다. 이때 노드를 클릭하면 오른쪽 패널에 구체적인 에러 메시지가 표시됩니다.

📝 핵심 요약

단계	내용	핵심 포인트
Manual Trigger	워크플로우 시작점	개발·테스트용, 클릭 시 실행
Set 노드	데이터 생성·수정	Add field → Name+Value 입력
표현식	동적 값 계산	{{ $json }}, {{ $json.필드명 }}
실행 결과	OUTPUT 탭에서 확인	초록 체크 = 성공, 빨간 X = 실패
데이터 흐름	items 배열로 전달	각 노드는 배열을 받아 처리 후 내보냄

다음 강에서는 n8n의 노드 유형 세 가지 — 트리거, 액션, 로직 — 를 체계적으로 정리합니다. 어떤 상황에서 어떤 종류의 노드를 선택해야 하는지 판단 기준을 익히면, 복잡한 워크플로우도 논리적으로 설계할 수 있게 됩니다.