카테고리 없음

n8n에서 Webhook 활용하는 방법 – 로컬 설치 21강

mystory5573 2025. 5. 20. 19:35

n8n이란? – 오픈소스 자동화 툴의 강력한 기능

n8n은 코드 기반과 노코드의 장점을 동시에 제공하는 워크플로 자동화 도구입니다. Zapier나 Integromat 같은 SaaS 자동화 툴과 달리, n8n은 오픈소스로 로컬에 설치하여 자유롭게 사용할 수 있다는 점이 큰 장점입니다. 특히 Webhook 기능은 외부 애플리케이션과의 실시간 통신을 가능하게 하여 자동화의 가능성을 극대화합니다.

Webhook이란? – 외부 이벤트를 실시간으로 트리거하기

Webhook은 특정 이벤트가 발생했을 때, 해당 정보를 실시간으로 URL에 전달하는 방식입니다. 예를 들어 사용자가 폼을 제출하거나 결제가 완료되었을 때, 이 정보를 n8n 워크플로로 전달해 후속 작업을 자동화할 수 있습니다. Webhook은 Polling 방식과 달리 리소스를 절약하면서도 빠른 반응이 가능하다는 점에서 매우 유용합니다.

n8n 로컬 설치 환경에서 Webhook 설정하는 방법

n8n을 로컬 환경에 설치한 경우에도 Webhook 기능을 활용할 수 있습니다. 아래 절차에 따라 간단히 설정이 가능합니다:

  1. n8n이 실행 중인지 확인합니다. 일반적으로 localhost:5678에서 실행됩니다.
  2. 새 워크플로를 생성한 뒤, Webhook 노드를 추가합니다.
  3. Webhook 노드의 HTTP Method는 POST 또는 GET으로 설정할 수 있으며, 경로(Path)는 예: /webhook/test 등으로 지정합니다.
  4. Webhook 노드 뒤에 처리하고자 하는 노드를 연결합니다. 예: Function 노드, Google Sheet 노드 등.
  5. 워크플로를 활성화하지 않아도 TEST 모드에서 미리 테스트가 가능합니다. 이때 제공되는 URL은 예를 들어 http://localhost:5678/webhook-test/test 형태입니다.

로컬 환경에서 Webhook 테스트하는 방법

테스트는 Postman 또는 curl 명령어를 이용해 간단하게 할 수 있습니다.

curl -X POST http://localhost:5678/webhook-test/test \
  -H "Content-Type: application/json" \
  -d '{"name": "Webhook Test", "email": "test@example.com"}'

위와 같이 요청을 보내면, Webhook 노드가 데이터를 받아 후속 노드로 전달합니다. Function 노드에서 로그를 찍거나 변환 작업을 할 수 있어, 전체 자동화 흐름을 디버깅하기도 수월합니다.

n8n에서 Webhook을 활용한 예제 워크플로

실제 사용 예제를 통해 Webhook의 활용 가능성을 살펴보겠습니다:

  • Google Forms와 연동: 설문 응답이 제출될 때 Webhook으로 받아 Google Sheets에 저장
  • Slack 자동 응답: 특정 채널에 메시지가 오면 Webhook을 통해 자동으로 답변 전송
  • 이커머스 플랫폼 연동: 주문이 발생했을 때, Webhook을 통해 메일 발송 및 재고 관리 워크플로 자동 실행

이처럼 다양한 플랫폼에서 발생하는 이벤트를 n8n Webhook으로 받아 자동화할 수 있어, 반복적인 업무를 줄이고 효율성을 극대화할 수 있습니다.

주의사항 – 로컬 환경에서 외부 접근 허용하기

로컬에서 Webhook을 외부에서 접근 가능하게 하려면 ngrok 같은 터널링 툴을 사용할 수 있습니다. ngrok으로 로컬 서버를 외부에 노출하면 테스트와 실제 적용 모두 손쉽게 진행할 수 있습니다. 예:

ngrok http 5678

이 명령어를 실행하면 https://random-id.ngrok.io 같은 주소가 생성되며, 해당 주소를 Webhook URL로 활용할 수 있습니다.

마무리 – Webhook으로 자동화의 지평을 넓히자

n8n의 Webhook 기능은 외부 시스템과의 연결을 통해 자동화의 시작점을 만들어줍니다. 특히 로컬 설치 환경에서도 Webhook을 잘 활용하면, 사내 시스템이나 개인 프로젝트에서 높은 수준의 자동화를 구현할 수 있습니다. 이제 단순한 작업은 n8n에게 맡기고, 더 중요한 일에 집중해보세요.