Webhook 노드#

Webhook 노드를 사용하여 웹훅을 생성할 수 있습니다. 이는 이벤트가 발생할 때 앱과 서비스로부터 데이터를 수신할 수 있습니다. 이는 트리거 노드로, n8n 워크플로를 시작할 수 있습니다. 이를 통해 서비스가 n8n에 연결되고 워크플로를 실행할 수 있습니다.

Webhook 노드는 데이터를 수신하고 해당 데이터를 기반으로 워크플로를 실행하려는 경우 워크플로의 트리거로 사용할 수 있습니다. Webhook 노드는 또한 워크플로의 끝에서 생성된 데이터를 반환하는 것을 지원합니다. 이는 데이터를 처리하고 결과를 반환하는 워크플로를 빌드하는 데 유용합니다. 예를 들어 API 엔드포인트와 같은 경우입니다.

웹훅은 전용 앱 트리거 노드가 없는 서비스로부터 워크플로를 트리거할 수 있게 해줍니다.

워크플로 개발 프로세스#

n8n은 테스트 및 프로덕션을 위한 다양한 Webhook URL을 제공합니다. 테스트 URL에는 테스트 이벤트 수신 옵션이 포함되어 있습니다. Webhook 노드를 프로덕션으로 전환하고 테스트하는 방법에 대한 자세한 내용은 워크플로 개발을 참조하세요.

노드 매개변수#

이 매개변수를 사용하여 노드를 구성합니다.

Webhook URLs#

Webhook 노드는 두 개의 Webhook URL을 가지고 있습니다: 테스트 및 프로덕션. n8n은 노드 패널 상단에 URL을 표시합니다.

테스트 URL 또는 프로덕션 URL을 선택하여 n8n이 표시하는 URL을 전환합니다.

테스트: n8n은 워크플로가 활성화되지 않은 경우 테스트 이벤트 수신 또는 테스트 워크플로를 선택할 때 테스트 웹훅을 등록합니다. 웹훅 URL을 호출하면 n8n이 워크플로에서 데이터를 표시합니다.
프로덕션: n8n은 워크플로를 활성화할 때 프로덕션 웹훅을 등록합니다. 프로덕션 URL을 사용하는 경우 n8n은 워크플로에서 데이터를 표시하지 않습니다. 프로덕션 실행에 대한 워크플로 데이터를 여전히 볼 수 있습니다: 워크플로에서 실행 탭을 선택한 후 보고 싶은 워크플로 실행을 선택합니다.

HTTP 메서드#

Webhook 노드는 표준 HTTP 요청 메서드를 지원합니다:

DELETE
GET
HEAD
PATCH
POST
PUT

웹훅 최대 페이로드

웹훅 최대 페이로드 크기는 16MB입니다. 자체 호스팅 n8n을 사용하는 경우 엔드포인트 환경 변수 N8N_PAYLOAD_SIZE_MAX를 사용하여 이를 변경할 수 있습니다.

경로#

기본적으로 이 필드는 다른 웹훅 노드와의 충돌을 피하기 위해 무작위로 생성된 웹훅 URL 경로를 포함합니다.

URL 경로를 수동으로 지정할 수 있으며, 경로 매개변수를 추가할 수 있습니다. 예를 들어, n8n을 사용하여 API를 프로토타입할 때 일관된 엔드포인트 URL을 원할 경우 이렇게 해야 할 수 있습니다.

경로 필드는 다음 형식을 사용할 수 있습니다:

/:variable
/path/:variable
/:variable/path
/:variable1/path/:variable2
/:variable1/:variable2

지원되는 인증 방법#

웹훅 URL을 호출하는 모든 서비스에 대해 인증을 요구할 수 있습니다. 다음 인증 방법 중에서 선택하세요:

Basic auth
Header auth
JWT auth
None

각 자격 증명 유형 설정에 대한 자세한 내용은 Webhook credentials를 참조하세요.

응답#

즉시: 웹훅 노드는 응답 코드와 메시지 Workflow got started를 반환합니다.
마지막 노드가 완료될 때: 웹훅 노드는 워크플로우에서 실행된 마지막 노드의 응답 코드와 데이터 출력을 반환합니다.
'Respond to Webhook' 노드 사용: 웹훅 노드는 Respond to Webhook 노드에 정의된 대로 응답합니다.

응답 코드#

웹훅 노드가 성공적으로 실행될 때 반환하는 HTTP 응답 코드를 사용자 정의하세요. 일반 응답 코드에서 선택하거나 사용자 정의 코드를 생성하세요.

응답 데이터#

응답 본문에 포함할 데이터를 선택하세요:

모든 항목: 웹훅은 마지막 노드의 모든 항목을 배열로 반환합니다.
첫 번째 항목 JSON: 웹훅은 마지막 노드의 첫 번째 항목의 JSON 데이터를 JSON 객체로 반환합니다.
첫 번째 항목 이진 데이터: 웹훅은 마지막 노드의 첫 번째 항목의 이진 데이터를 이진 파일로 반환합니다.
응답 본문 없음: 웹훅은 본문 없이 반환합니다.

Respond > When Last Node Finishes에만 적용됩니다.

노드 옵션#

옵션 추가를 선택하여 더 많은 구성 옵션을 보세요. 사용 가능한 옵션은 노드 매개변수에 따라 다릅니다. 옵션 가용성에 대한 표를 참조하세요.

허용된 출처 (CORS): 허용된 교차 출처 도메인을 설정합니다. 교차 출처 비사전 요청을 위해 허용된 URL의 쉼표로 구분된 목록을 입력합니다. 모든 출처를 허용하려면 *(기본값)를 사용하세요.
이진 속성: 이 설정을 활성화하면 웹훅 노드가 이미지 또는 오디오 파일과 같은 이진 데이터를 수신할 수 있습니다. 수신된 파일의 데이터를 작성할 이진 속성의 이름을 입력하세요.
봇 무시: 링크 미리보기 및 웹 크롤러와 같은 봇의 요청을 무시합니다.
IP 화이트리스트: 웹훅 트리거 URL을 호출할 수 있는 대상을 제한하려면 이 기능을 활성화합니다. 허용된 IP 주소의 쉼표로 구분된 목록을 입력하세요. 화이트리스트에 없는 IP에서의 접근은 403 오류를 발생시킵니다. 비워두면 모든 IP 주소가 웹훅 트리거 URL을 호출할 수 있습니다.
응답 본문 없음: 이를 활성화하면 n8n이 응답과 함께 본문을 보내지 않도록 합니다.
원시 본문: 웹훅 노드가 JSON 또는 XML과 같은 원시 형식으로 데이터를 수신하도록 지정합니다.
응답 콘텐츠 유형: 웹훅 본문의 형식을 선택합니다.
응답 데이터: 응답과 함께 사용자 정의 데이터를 보냅니다.
응답 헤더: 웹훅 응답에 추가 헤더를 보냅니다. 응답 헤더에 대한 자세한 내용은 MDN Web Docs | Response header를 참조하세요.
속성 이름: 기본적으로 n8n은 사용 가능한 모든 데이터를 반환합니다. 특정 JSON 키를 반환하도록 선택하여 n8n이 값을 반환하도록 할 수 있습니다.

옵션	필요한 노드 구성
허용된 출처 (CORS)	모든
이진 속성	다음 중 하나: HTTP Method > POST HTTP Method > PATCH HTTP Method > PUT
봇 무시	모든
IP 화이트리스트	모든
속성 이름	두 가지: Respond > When Last Node Finishes Response Data > First Entry JSON
응답 본문 없음	Respond > Immediately
원시 본문	모든
응답 코드	Respond > Using 'Respond to Webhook' Node를 제외한 모든
응답 콘텐츠 유형	두 가지: Respond > When Last Node Finishes Response Data > First Entry JSON
응답 데이터	Respond > Immediately
응답 헤더	모든

템플릿 및 예제#

Browse Webhook node documentation integration templates, or search all templates

일반적인 문제#

일반적인 질문이나 문제 및 제안된 솔루션에 대해서는 일반적인 문제를 참조하십시오.