n8n 기초 - Webhook 노드 알아보기

 

1. Webhook 노드란 무엇인가?

Webhook은 쉽게 말하면

"외부에서 신호를 보내면 자동화를 시작하는 노드"

라고 생각하면 된다.

예를 들어 이런 상황을 생각해 보자.

사용자 클릭
-> URL 호출
-> Webhook
-> Workflow 실행

 

즉 Webhook은 “외부 시스템이 n8n을 호출하는 출입구”

같은 역할을 한다.

 

 

---

 

2. Webhook이 필요한 이유

n8n 자동화를 시작하는 방법은 여러 가지가 있다.

대표적으로

1. Manual Trigger : 사람이 직접 실행

2. Schedule Trigger : 정해진 시간에 실행

3. Webhook : 외부 요청으로 실행

 

이 중 Webhook은 서비스와 자동화를 연결하는 가장 일반적인 방법이다.

예를 들어

• Slack 버튼 클릭
• Github 이벤트
• Stripe 결제 이벤트
• Google Form 제출
• 내부 시스템 API

이 모든 것들이 Webhook으로 n8n을 실행할 수 있다.

 

 

---

 

3. Webhook이 동작하는 구조

Webhook은 기본적으로 HTTP 요청을 받는다.

예를 들어 이런 요청이 들어온다.

GET /webhook/register?mall_id=example

 

이 요청이 들어오면 n8n은 Webhook 수신 -> Workflow 실행을 수행한다.

즉 Webhook은 API의 시작점이라고 생각하면 된다.

 

 

---

 

4. REST API 기본 개념 정리

Webhook을 이해하려면 REST API 기본 개념도 함께 알아두면 좋다.

그 이유를 간단히 설명하자면 Webhook 자체가 REST API 위에서 동작하기 때문이다.

 

Webhook은 사실 특별한 기술이라기보다,
“외부 시스템이 특정 URL로 HTTP 요청을 보내는 방식”이다.
이때 사용하는 방식이 바로 REST API의 HTTP 메서드(GET, POST 등)이다.

그래서 REST API 개념을 알고 있으면:

• Webhook이 어떤 방식으로 호출되는지 이해할 수 있고
• 요청에 포함되는 데이터(파라미터, Body)를 해석할 수 있으며
• n8n에서 받은 데이터를 어떻게 처리해야 하는지 판단할 수 있다.

즉, Webhook은 REST API 요청을 받아 자동화를 시작하는 구조이기 때문에,

REST API 기본 개념을 알아두면 Webhook의 동작 원리를 훨씬 쉽게 이해할 수 있다.

REST API 종류는 이렇게 4가지가 가장 많이 쓰이는 대표적인 메서드다.

1. GET : 데이터 조회

2. POST : 데이터 생성

3. PUT : 데이터 수정

4. DELETE : 데이터 삭제

나머진(PATCH, HEAD, OPTIONS..) 크게 쓰일 일이 없을 것이다.

 

 

 

 

---

 

5. n8n Webhook의 생성하기

n8n에서 이제 Webhook 노드를 만들어보자.

프로젝트 빈 화면에서 우측 마우스를 눌러 'Add node'를 선택한다.

그럼 우측에 노드를 검색할 수 있는 창이 활성화된다.

검색창에 'Webhook'을 검색하고 첫 번째로 뜨는 것을 선택한다.

 

 

---

 

6. Test URL vs Production URL

생성된 노드를 열어 세팅하는 화면을 보면

제일 상단에 두 가지 URL을 확인할 수 있는 탭이 있다.

1) Test URL 

• /webhook-test/xxxx 이런 식으로 'test'라는 단어가 붙어있다.
• 개발용이다.
• Editor에서 Execute workflow 실행 중일 때만 동작한다.

즉 테스트용이다.

2) Production URL

• /webhook/xxxx 이런 식으로 webhook이라는 단어만 있다.
• 실제 서비스용이다.
• Workflow가 Active 상태이면 항상 동작한다.

그래서 Slack이나 외부 시스템에서는
반드시 Production URL을 사용해야 한다.

 

 

---

7.  n8n Webhook 노드 설정 항목 설명

나머지 항목도 하나씩 설명해 보겠다.

1️⃣ HTTP Method

Webhook이 어떤 방식의 HTTP 요청을 받을지 설정하는 항목이다.

앞서 말했던 RestAPI에 대한 설명을 참고하여 세팅할 수 있다.

2️⃣ Path

Webhook URL의 엔드포인트 경로를 설정하는 항목이다.

예를 들어 Path를 'register-mall'이라고 설정하면 Webhook URL은 다음과 같이 생성된다.

https://n8n.example.com/webhook/register-mall

즉 Path는 Webhook URL의 마지막 경로를 정하는 설정이라고 보면 된다.

 

3️⃣ Authentication

Webhook 호출 시 인증이 필요한지 여부를 설정하는 항목이다.

외부에서 아무나 Webhook을 호출하지 못하도록 보호할 때 사용한다.

'None'이라는 것은 인증 없이 누구나 호출 가능하다는 뜻이다.

 

4️⃣ Respond

Webhook이 요청을 보낸 쪽에 어떤 응답을 반환할지 설정하는 항목이다.

예를 들어 Slack 버튼을 누르면 Webhook이 실행되고 나서 브라우저나 호출한 시스템에 응답을 보내게 된다.

대표 옵션은 다음과 같다.

- Immediately : 워크플로우 실행 여부와 상관없이 Webhook 요청을 받자마자 응답.

- When Last Node Finishes : 워크플로우가 끝난 후 응답한다. (마지막 노드 완료 후 응답 반환)