대기#
Wait 노드를 사용하여 워크플로우의 실행을 일시 중지합니다. 워크플로우가 일시 중지되면 실행 데이터를 데이터베이스에 오프로드합니다. 재개 조건이 충족되면 워크플로우는 데이터를 다시 로드하고 실행을 계속합니다.
작업#
Wait 노드는 다음 조건에서 재개할 수 있습니다:
- 시간 간격 후: 노드는 특정 시간만큼 기다립니다.
- 지정된 시간에: 노드는 특정 시간까지 기다립니다.
- 웹후크 호출 시: 노드는 HTTP 호출을 받을 때까지 기다립니다.
- 양식 제출 시: 노드는 양식 제출을 받을 때까지 기다립니다.
아래의 더 자세한 섹션을 참조하여 구체적인 지침을 확인하세요.
시간 간격 후#
특정 시간만큼 기다립니다.
이 매개변수에는 두 개의 추가 필드가 포함됩니다:
- 대기 시간: 대기할 시간을 입력합니다.
- 대기 단위: 대기 시간의 측정 단위를 선택합니다. 선택 가능한 항목:
- 초
- 분
- 시간
- 일
이 간격이 작동하는 방식과 사용되는 표준시대에 대한 자세한 내용은 시간 기반 작업을 참조하세요.
지정된 시간에#
특정 날짜 및 시간까지 기다려서 계속 진행합니다. 날짜 및 시간 선택기를 사용하여 날짜 및 시간을 설정합니다.
사용되는 표준시대에 대한 자세한 내용은 시간 기반 작업을 참조하세요.
웹후크 호출 시#
이 매개변수는 Wait 노드가 HTTP 호출을 받을 때 워크플로우를 재개할 수 있도록 합니다.
호출 시 실행을 재개하는 웹후크 URL은 런타임에서 생성됩니다. Wait 노드는 $execution.resumeUrl
변수를 제공하므로, 생성되지 않은 URL을 참조하고 필요한 곳에 보낼 수 있습니다. 예를 들어, 제3자 서비스나 이메일로 보낼 수 있습니다.
워크플로우가 실행되면 Wait 노드는 $execution.resumeUrl
을 사용하여 재개 URL 및 워크플로우의 웹후크를 생성합니다. 이 생성된 URL은 각 실행에 대해 고유하므로, 워크플로우에는 여러 개의 Wait 노드가 포함될 수 있으며, 웹후크 URL이 호출될 때 각 Wait 노드를 순차적으로 재개합니다.
이 재개 스타일에 대해 아래에 나열된 추가 매개변수를 설정합니다.
인증#
$execution.resumeUrl
에 대한 수신 재개 웹후크 요청을 인증할 방법을 선택합니다. 옵션은 다음과 같습니다:
- 기본 인증: 기본 인증을 사용합니다. 사용할 기본 인증 자격 증명을 선택하거나 새로 입력합니다.
- 헤더 인증: 헤더 인증을 사용합니다. 사용할 헤더 인증 자격 증명을 선택하거나 새로 입력합니다.
- JWT 인증: JWT 인증을 사용합니다. 사용할 JWT 인증 자격 증명을 선택하거나 새로 입력합니다.
- 없음: 인증을 사용하지 않습니다.
인증 참조
각 인증 유형에 대한 자세한 정보는 웹후크 노드 | 인증 문서를 참조하세요.
HTTP 방법#
웹후크가 사용할 HTTP 방법을 선택합니다. 자세한 정보는 웹후크 노드 | HTTP 방법 문서를 참조하세요.
응답 코드#
웹후크가 반환해야 할 응답 코드를 입력합니다. 일반 코드를 사용하거나 사용자 정의 코드를 입력할 수 있습니다.
응답#
웹후크에 응답하는 시기와 방법을 다음 옵션 중에서 설정합니다:
- 즉시: 노드가 실행되는 즉시 응답합니다.
- 마지막 노드가 완료될 때: 워크플로우에서 마지막으로 실행된 노드의 응답 코드와 데이터 출력을 반환합니다. 이 옵션을 선택하면 다음도 설정해야 합니다:
- 응답 데이터: 어떤 데이터를 반환할지 및 어떤 형식을 사용할지 선택합니다. 선택 가능한 항목:
- 모든 항목: 마지막 노드의 모든 항목을 배열로 반환합니다.
- 첫 번째 항목 JSON: 마지막 노드의 첫 번째 항목의 JSON 데이터를 JSON 객체로 반환합니다.
- 첫 번째 항목 바이너리: 마지막 노드의 첫 번째 항목의 바이너리 데이터를 바이너리 파일로 반환합니다.
- 응답 본문 없음: 본문 없이 반환합니다.
- 응답 데이터: 어떤 데이터를 반환할지 및 어떤 형식을 사용할지 선택합니다. 선택 가능한 항목:
- '웹후크에 응답' 노드를 사용하여: 웹후크에 응답 노드에서 정의된 대로 응답합니다.
대기 시간 제한#
워크플로우가 특정 제한 유형(켜짐)에 따라 자동으로 실행을 재개할지 여부(꺼짐)를 설정합니다. 켜짐일 경우에도 설정합니다:
- 제한 유형: 이 옵션에서 시행할 제한 유형을 선택합니다:
- 시간 간격 후: 특정 시간 동안 대기합니다.
- 제한의 양을 입력합니다.
- 제한의 단위를 선택합니다.
- 지정된 시간에: 특정 날짜와 시간까지 대기하여 재개합니다.
- 최대 날짜 및 시간: 노드가 재개해야 하는 지정된 시간을 설정하기 위해 날짜 및 시간 선택기를 사용합니다.
- 시간 간격 후: 특정 시간 동안 대기합니다.
웹후크 호출 옵션#
- 이진 속성: 수신된 파일의 데이터를 기록할 이진 속성의 이름을 입력합니다. 이 옵션은 이진 데이터가 수신될 경우에만 관련이 있습니다.
- 봇 무시: 링크 미리보기 및 웹 크롤러와 같은 봇의 요청을 무시할지 여부(켜짐) 또는 무시하지 않을지 여부(꺼짐)를 설정합니다.
- IP 화이트리스트: 웹후크 URL을 호출할 수 있는 대상을 제한하기 위해 여기에 IP 주소를 입력합니다. 허용된 IP 주소의 쉼표로 구분된 목록을 입력합니다. 화이트리스트에 없는 IP에서의 액세스는 403 오류를 발생시킵니다. 비워두면 모든 IP 주소가 웹후크 URL을 호출할 수 있습니다.
- 응답 본문 없음: n8n이 응답에서 본문을 보내야 할지 여부(꺼짐) 또는 n8n이 응답에서 본문을 보내지 않도록 방지할지 여부(켜짐)를 설정합니다.
- 원시 본문: JSON 또는 XML과 같은 원시 형식으로 본문을 반환할지 여부(켜짐) 또는 반환하지 않을지 여부(꺼짐)를 설정합니다.
- 응답 데이터: 응답에서 전송할 사용자 정의 데이터를 입력합니다.
- 응답 헤더: 웹후크 응답에서 추가 헤더를 보냅니다. 응답 헤더에 대해 더 알고 싶다면 MDN Web Docs | Response header를 참조하세요.
- 웹후크 접미사: 재개 URL에 추가할 접미사를 입력합니다. 이는 워크플로우에 여러 대기 노드가 포함되어 있을 때 각 대기 노드를 위한 고유한 웹후크 URL을 생성하는 데 유용합니다. 생성된
$resumeWebhookUrl
에는 이 접미사가 자동으로 포함되지 않으므로, 웹후크 URL을 공개하기 전에 수동으로 접미사를 추가해야 합니다.
웹후크 호출 제한 사항#
웹후크 호출을 사용할 때 염두에 두어야 할 몇 가지 제한 사항이 있습니다:
- 워크플로우의 부분 실행은
$resumeWebhookUrl
을 변경하므로, 이 URL을 보내는 노드가 대기 노드와 같은 실행 내에서 실행되도록 하십시오.
양식 제출 시#
계속 진행하기 전에 양식 제출을 기다리십시오. 다음 매개변수를 설정합니다:
양식 제목#
양식 상단에 표시할 제목을 입력합니다.
양식 설명#
제목 아래에 표시할 양식 설명을 입력합니다. 이 설명은 사용자가 양식을 완료하는 방법을 안내하는 데 도움이 될 수 있습니다.
양식 필드#
다음 매개변수를 사용하여 양식에 표시할 각 필드를 설정합니다:
- 필드 레이블: 양식에 표시할 필드 레이블을 입력합니다.
- 필드 유형: 양식에 표시할 필드 유형을 선택합니다. 다음 중에서 선택합니다:
- 날짜
- 드롭다운 목록: 필드 옵션에 각 드롭다운 옵션을 입력합니다.
- 다중 선택: 사용자가 단일 드롭다운 옵션(꺼짐)을 선택할 수 있는지 또는 여러 드롭다운 옵션(켜짐)을 선택할 수 있는지 선택합니다.
- 숫자
- 비밀번호
- 텍스트
- 텍스트영역
- 필수 필드: 사용자가 양식을 제출하기 위해 이 필드를 완료해야 하는지 여부(켜짐) 또는 사용자가 이를 완료하지 않고 양식을 제출할 수 있는지 여부(꺼짐)를 설정합니다.
응답할 때#
양식 제출에 응답할 시점을 설정합니다. 다음 중에서 선택하세요:
- 양식이 제출되었을 때: 이 노드가 양식 제출을 받는 즉시 응답합니다.
- 워크플로가 끝났을 때: 이 워크플로의 마지막 노드가 끝날 때 응답합니다.
- '웹훅에 응답하기' 노드를 사용하여: 웹훅에 응답하기 노드가 실행될 때 응답합니다.
대기 시간 제한#
워크플로가 특정 제한 유형(켜짐) 이후 자동으로 실행을 재개할지 여부를 설정합니다(꺼짐).
켜짐으로 설정하면 다음도 설정합니다: * 제한 유형: 다음 옵션 중에서 시행할 제한 유형을 선택합니다: * 시간 간격 후: 특정 시간 동안 대기합니다. * 제한의 양 시간 입력. * 제한의 단위 시간 선택. * 지정된 시간에: 특정 날짜와 시간까지 대기하여 재개합니다. * 최대 날짜 및 시간: 날짜 및 시간 선택기를 사용하여 노드가 재개되어야 할 지정된 시간을 설정합니다.
양식 응답 옵션#
- 양식 응답: 다음 옵션 중에서 양식이 응답할 내용을 선택하세요:
- 양식 제출 텍스트: 사용자가 양식을 작성한 후 보여줄 텍스트에 입력된 텍스트가 양식에 표시됩니다. 확인 메시지를 표시하려면 이 옵션을 사용하세요.
- 리디렉션 URL: 사용자가 양식을 작성한 후 리디렉션할 URL로 사용자 리디렉션됩니다. 이는 유효한 URL이어야 합니다.
- 웹훅 접미사: 재개 URL에 추가할 접미사를 입력합니다. 이는 워크플로에 여러 개의 대기 노드가 포함된 경우 각 대기 노드에 대한 고유한 웹훅 URL을 만드는 데 유용합니다. 생성된
$resumeWebhookUrl
에는 이 접미사가 자동으로 포함되지 않으므로 노출하기 전에 웹훅 URL에 수동으로 추가해야 합니다.
템플릿 및 예제#
시간 기반 작업#
시간 기반 재개 작업에 대해 다음 사항에 유의하세요:
- 대기 시간이 65초 미만일 경우, 워크플로는 실행 데이터를 데이터베이스에 오프로드하지 않습니다. 대신, 프로세스는 계속 실행되고 지정된 간격이 지나면 실행이 재개됩니다.
- n8n 서버 시간은 항상 시간대 설정과 관계없이 사용됩니다. 워크플로 시간대 설정 및 그에 대한 변경 사항은 대기 노드 간격이나 지정된 시간에 영향을 주지 않습니다.