Webhook 노드 문서

n8n에서 Webhook 노드를 사용해 이벤트 발생 시 앱과 서비스로부터 데이터를 수신하는 방법을 설명합니다.

Webhook 노드를 사용하면 웹훅 을 생성하여 이벤트가 발생할 때 앱과 서비스로부터 데이터를 수신할 수 있습니다. Webhook 노드는 트리거 노드로, n8n 워크플로우를 시작할 수 있습니다. 이를 통해 서비스가 n8n에 연결하여 워크플로우를 실행할 수 있습니다. 데이터를 수신하고 그 데이터를 기반으로 워크플로우를 실행하려는 경우 Webhook 노드를 워크플로우의 트리거로 사용할 수 있습니다. Webhook 노드는 워크플로우 끝에서 생성된 데이터를 반환하는 기능도 지원합니다. 이 덕분에 데이터를 처리하고 결과를 반환하는 워크플로우를 API 엔드포인트처럼 구축하는 데 유용합니다. 웹훅을 사용하면 전용 앱 트리거 노드가 없는 서비스에서도 워크플로우를 트리거할 수 있습니다. 워크플로우 개발 과정 # n8n은 테스트와 프로덕션을 위한 서로 다른 Webhook URL 을 제공합니다. 테스트 URL에는 Listen for test event 옵션이 포함되어 있습니다. Webhook 노드를 빌드, 테스트하고 프로덕션으로 전환하는 방법에 대한 자세한 내용은 워크플로우 개발 을 참고하세요. 노드 매개변수 # 이 매개변수를 사용하여 노드를 구성합니다. Webhook URL # Webhook 노드에는 테스트용과 프로덕션용 두 개의 Webhook URL 이 있습니다. n8n은 노드 패널 상단에 이 URL을 표시합니다. Test URL 또는 Production URL 을 선택하여 n8n이 표시하는 URL을 전환합니다. Webhook 노드의 Parameters 탭에 표시된 Webhook URL 예시 Test : 워크플로우가 활성화되어 있지 않은 경우, Listen for Test Event 또는 Execute workflow 를 선택하면 n8n이 테스트 웹훅을 등록합니다. 웹훅 URL을 호출하면 n8n이 워크플로우에 데이터를 표시합니다. Production : 워크플로우를 게시하면 n8n이 프로덕션 웹훅을 등록합니다. 프로덕션 URL을 사용하는 경우 n8n은 워크플로우에 데이터를 표시하지 않습니다. 프로덕션 실행의 워크플로우 데이터는 여전히 확인할 수 있습니다. 워크플로우에서 Executions 탭을 선택한 다음 확인하려는 워크플로우 실행을 선택하세요. HTTP 메서드 # Webhook 노드는 표준 HTTP 요청 메서드 를 지원합니다: DELETE GET HEAD PATCH POST PUT 웹훅 최대 페이로드 웹훅의 최대 페이로드 크기는 16MB입니다. n8n을 셀프 호스팅하는 경우 엔드포인트 환경 변수 N8N_PAYLOAD_SIZE_MAX 를 사용하여 이 값을 변경할 수 있습니다. 경로 # 기본적으로 이 필드에는 다른 webhook 노드와의 충돌을 피하기 위해 무작위로 생성된 웹훅 URL 경로가 들어 있습니다. 경로 매개변수 추가를 포함하여 URL 경로를 직접 지정할 수 있습니다. 예를 들어 n8n으로 API를 프로토타이핑하면서 일관된 엔드포인트 URL을 원하는 경우 이 작업이 필요할 수 있습니다. Path 필드는 다음 형식을 사용할 수 있습니다: /:var