n8n 웹훅(Webhook)은 폼 제출, 결제 완료, 새 문의처럼 어떤 일이 발생한 순간 데이터를 워크플로우로 보내는 시작점입니다. 이 글에서는 외부 서비스 연결 없이도 웹훅을 직접 호출해, 데이터 수신부터 응답 반환까지 한 번에 확인합니다.
웹훅이 필요한 순간
웹훅은 n8n이 주기적으로 데이터를 확인하는 방식이 아니라, 외부 서비스가 이벤트 발생 시 n8n 주소로 HTTP 요청을 보내는 방식입니다. 예를 들어 문의 폼이 제출되면 이름·이메일·문의 내용을 n8n으로 보내고, 그 뒤에 담당자 알림이나 스프레드시트 기록을 붙일 수 있습니다.
- 문의 폼 제출 직후 담당자에게 알림 보내기
- 외부 서비스에서 새 주문·신청 정보를 받기
- 사내 도구에서 특정 버튼을 눌렀을 때 후속 작업 시작하기
이번 글에서 만들 흐름
Webhook → Edit Fields (Set) → Respond to Webhook
먼저 JSON 데이터를 받고, 필요한 값만 정리한 뒤, 호출한 쪽에 성공 응답을 돌려줍니다. 실제 고객 정보나 API 키는 넣지 말고 아래 예시값으로 테스트하세요.
1. Webhook 노드 추가하기
- 새 워크플로우에서 Webhook 노드를 추가합니다.
- HTTP Method는
POST로 선택합니다. - Path에는
lead-intake-demo처럼 용도를 알 수 있는 짧은 경로를 입력합니다.
처음에는 인증 없이 테스트해도 되지만, 운영용 공개 주소에는 인증 또는 서비스 제공자의 서명 검증을 반드시 추가해야 합니다.
2. Test URL로 데이터 보내기
Webhook 노드에서 테스트 수신을 시작하면 Test URL이 나타납니다. 이 주소는 워크플로우를 만드는 동안 잠시 쓰는 주소입니다. 아래 JSON을 보내거나, 웹훅을 호출할 수 있는 도구에서 본문으로 입력해 보세요.
{
"name": "테스트 고객",
"email": "test@example.com",
"message": "웹훅 수신 확인"
}실행 결과에 위 값이 보이면 n8n이 요청 본문을 받은 것입니다. 아무 데이터도 들어오지 않으면 테스트 수신을 다시 시작한 뒤 Test URL이 맞는지 확인하세요.
3. Edit Fields (Set)으로 필요한 값만 정리하기
Webhook 뒤에 Edit Fields (Set) 노드를 연결합니다. 처음에는 받은 값을 그대로 살펴보고, 다음 단계에서 필요한 이름·이메일·메시지만 남기는 방식이 안전합니다. 외부 서비스에 넘기기 전에 빈 값, 예상하지 못한 값, 민감한 정보가 없는지 여기서 한 번 점검하세요.
4. Respond to Webhook으로 성공 응답 돌려주기
마지막에 Respond to Webhook 노드를 연결하고 JSON 응답을 설정합니다.
{
"ok": true,
"message": "접수되었습니다."
}이 응답이 있어야 요청을 보낸 폼이나 앱이 성공 여부를 바로 알 수 있습니다. 브라우저나 호출 도구에서 이 JSON이 돌아오면 첫 흐름은 완성입니다.
Test URL과 Production URL의 차이
- Test URL: 작성·디버깅 중에 잠시 사용합니다. 테스트 수신 상태가 끝나면 동작하지 않을 수 있습니다.
- Production URL: 워크플로우를 활성화한 뒤 실제 서비스에 연결하는 주소입니다.
외부 폼이나 앱에 Test URL을 그대로 붙여 두는 실수가 가장 흔합니다. 실험이 끝난 뒤에는 워크플로우를 검토하고 활성화한 다음, Production URL로 교체하세요.
운영 전에 확인할 보안 체크리스트
- URL에 비밀번호, API 키, 개인 식별 정보를 넣지 않습니다.
- 공개 웹훅에는 제공되는 인증 방식 또는 요청 서명 검증을 적용합니다.
- 테스트에는 가짜 이름·이메일을 사용합니다.
- 받은 데이터를 곧바로 메일 발송이나 고객 DB에 넣기 전에 검토 단계를 둡니다.
- 오류가 나도 내부 설정이나 민감한 값을 응답으로 노출하지 않습니다.
자주 막히는 지점
데이터가 들어오지 않을 때
Test URL은 테스트 수신을 시작한 상태에서만 확인합니다. HTTP Method가 POST인지, URL 경로를 잘못 복사하지 않았는지 점검하세요.
운영 주소에서 404가 뜰 때
Production URL은 워크플로우가 활성화되어야 합니다. 연결하기 전에 테스트용 실행 데이터를 지우거나 새로고침할 필요는 없지만, 실제 외부 서비스에 연결하기 전 응답을 한 번 더 확인하세요.
호출한 쪽에서 계속 대기할 때
응답 노드가 없거나, 흐름 중간에서 오류가 나면 호출한 서비스가 응답을 받지 못할 수 있습니다. Respond to Webhook까지 연결되어 있는지와 실행 기록을 함께 확인합니다.
다음 단계
이 테스트가 안정적으로 끝난 뒤에만 Gmail, Notion, Google Sheets 같은 실제 서비스 연결을 추가하세요. 첫 운영 흐름은 한 번에 여러 작업을 붙이기보다 수신 → 값 확인 → 응답까지 작게 검증하는 편이 오류를 줄입니다.
참고: n8n Webhook 노드 공식 문서, Respond to Webhook 공식 문서
이어 읽기