웹훅에 응답하기#
웹훅으로 들어오는 요청에 대한 응답을 제어하려면 Respond to Webhook 노드를 사용하세요. 이 노드는 Webhook 노드와 함께 작동합니다.
첫 번째 데이터 항목에 대해 한 번 실행
Respond to Webhook 노드는 첫 번째로 들어오는 데이터 항목을 사용하여 한 번 실행됩니다. 자세한 내용은 하나 이상의 데이터 항목 반환을 참조하세요.
Respond to Webhook 사용 방법#
Respond to Webhook 노드를 사용하려면:
- 워크플로우의 트리거 노드로 Webhook 노드를 추가합니다.
- Webhook 노드에서 Respond를 Respond to Webhook 노드 사용으로 설정합니다.
- 워크플로우의 원하는 위치에 Respond to Webhook 노드를 추가합니다. 다른 노드에서 데이터를 반환하려면 해당 노드 다음에 배치합니다.
노드 매개변수#
다음 매개변수를 사용하여 노드 동작을 구성하세요.
응답 데이터#
웹훅 응답으로 보낼 데이터를 선택합니다.
- 모든 들어오는 항목: 입력의 모든 JSON 항목으로 응답합니다.
- Binary: 응답 데이터 소스에 정의된 이진 파일로 응답합니다.
- 첫 번째 들어오는 항목: 첫 번째 들어오는 항목의 JSON으로 응답합니다.
- JSON: 응답 본문에 정의된 JSON 객체로 응답합니다.
- 데이터 없음: 응답 페이로드가 없습니다.
- 리디렉션: 리디렉션 URL에 설정된 URL로 리디렉션합니다.
- 텍스트: 응답 본문에 설정된 텍스트로 응답합니다.
노드 옵션#
옵션 추가를 선택하여 옵션을 보거나 설정하세요.
- 응답 코드: 사용할 응답 코드를 설정합니다.
- 응답 헤더: 전송할 응답 헤더를 정의합니다.
- 필드에 응답 넣기: 모든 들어오는 항목 또는 첫 번째 들어오는 항목으로 응답할 때 사용 가능합니다. 응답 데이터를 포함하는 필드의 이름을 설정합니다.
템플릿 및 예제#
워크플로우 동작#
Respond to Webhook 노드를 사용할 때 워크플로우는 다음과 같이 동작합니다:
- 워크플로우가 Respond to Webhook 노드를 실행하지 않고 완료되면: 200 상태와 함께 표준 메시지를 반환합니다.
- 첫 번째 Respond to Webhook 노드가 실행되기 전에 워크플로우 오류가 발생하면: 워크플로우는 500 상태와 함께 오류 메시지를 반환합니다.
- 두 번째 Respond to Webhook 노드가 첫 번째 뒤에 실행되면: 워크플로우는 이를 무시합니다.
- Respond to Webhook 노드가 실행되지만 웹훅이 없으면: 워크플로우는 Respond to Webhook 노드를 무시합니다.
하나 이상의 데이터 항목 반환 (더 이상 사용되지 않음)#
1.22.0에서 더 이상 사용되지 않음
n8n 1.22.0에서 모든 들어오는 항목 옵션을 사용하여 모든 데이터 항목을 반환하는 기능이 추가되었습니다. 이 섹션에 설명된 우회 방법을 사용하는 대신 n8n의 최신 버전으로 업그레이드하는 것이 좋습니다.
Respond to Webhook 노드는 첫 번째 들어오는 데이터 항목을 사용하여 한 번 실행됩니다. 이는 표현식을 사용할 때도 마찬가지입니다. Loop 노드를 사용하여 루프를 강제로 실행할 수 없습니다: 워크플로우는 실행되지만 웹훅 응답에는 여전히 첫 번째 실행 결과만 포함됩니다.
하나 이상의 데이터 항목을 반환해야 하는 경우 아래 옵션 중 하나를 선택하세요:
- Respond to Webhook 노드를 사용하는 대신 Webhook 노드의 Respond에서 마지막 노드가 완료되면 옵션을 사용하세요. 워크플로우 출력의 최종 데이터를 반환하고자 할 때 사용합니다.
- Aggregate 노드를 사용하여 여러 항목을 하나의 항목으로 변환한 후 Respond to Webhook 노드에 데이터를 전달하세요. Aggregate를 모든 항목 데이터(하나의 목록으로)로 설정합니다.