Wait 노드를 사용하여 워크플로 실행을 일시 중지합니다. 워크플로가 일시 중지되면 실행 데이터를 데이터베이스로 오프로드합니다. 재개 조건이 충족되면 워크플로가 데이터를 다시 로드하고 실행이 계속됩니다.

작업#

Wait 노드는 다음 조건에서 Resume(재개)할 수 있습니다:

• After Time Interval: 노드가 일정 시간 동안 대기합니다.
• At Specified Time: 노드가 특정 시간까지 대기합니다.
• On Webhook Call: 노드가 HTTP 호출을 수신할 때까지 대기합니다.
• On Form Submitted: 노드가 폼 제출을 수신할 때까지 대기합니다.

더 자세한 지침은 아래의 상세 섹션을 참고하세요.

시간 간격 이후#

일정 시간 동안 대기합니다.

이 매개변수에는 다음 두 필드가 더 포함됩니다:

• Wait Amount: 대기할 시간의 양을 입력합니다.
• Wait Unit: Wait Amount의 측정 단위를 선택합니다. 다음 중에서 선택하세요:
  • Seconds
  • Minutes
  • Hours
  • Days

이러한 간격이 어떻게 동작하는지와 사용되는 시간대에 대한 자세한 내용은 Time-based operations를 참고하세요.

지정된 시각에#

계속 진행하기 전에 특정 날짜와 시간까지 대기합니다. 날짜 및 시간 선택기를 사용하여 Date and Time을 설정합니다.

사용되는 시간대에 대한 자세한 내용은 Time-based operations를 참고하세요.

웹훅 호출 시#

이 매개변수는 Wait 노드가 HTTP 호출을 수신할 때 워크플로가 재개될 수 있도록 합니다.

호출 시 실행을 재개하는 웹훅 URL은 런타임에 생성됩니다. Wait 노드는 $execution.resumeUrl 변수를 제공하므로, 아직 생성되지 않은 이 URL을 필요한 곳(예: 서드파티 서비스나 이메일)에 참조하고 전송할 수 있습니다.

워크플로가 실행되면 Wait 노드는 $execution.resumeUrl을 사용하여 재개 URL과 워크플로 내 웹훅을 생성합니다. 이 생성된 URL은 각 실행마다 고유하므로, 워크플로에 여러 개의 Wait 노드가 포함될 수 있으며 웹훅 URL이 호출됨에 따라 각 Wait 노드가 순차적으로 재개됩니다.

이 Resume(재개) 방식을 사용하려면 아래에 나열된 매개변수를 추가로 설정하세요.

인증#

$execution.resumeUrl로 들어오는 재개 웹훅 요청을 인증할지 여부와 방법을 선택합니다. 옵션은 다음과 같습니다:

• Basic Auth: 기본 인증을 사용합니다. 사용할 Credential for Basic Auth를 선택하거나 새로 입력합니다.
• Header Auth: 헤더 인증을 사용합니다. 사용할 Credential for Header Auth를 선택하거나 새로 입력합니다.
• JWT Auth: JWT 인증을 사용합니다. 사용할 Credential for JWT Auth를 선택하거나 새로 입력합니다.
• None: 인증을 사용하지 않습니다.

HTTP 메서드#

웹훅이 사용할 HTTP 메서드를 선택합니다. 자세한 내용은 Webhook node | HTTP Method documentation을 참고하세요.

응답 코드#

웹훅이 반환할 Response Code(응답 코드)를 입력합니다. 일반적인 코드를 사용하거나 사용자 지정 코드를 입력할 수 있습니다.

응답#

다음 옵션 중에서 웹훅에 언제, 어떻게 응답할지 설정합니다:

• Immediately: 노드가 실행되는 즉시 응답합니다.
• When Last Node Finishes: 워크플로에서 마지막으로 실행된 노드의 응답 코드와 출력 데이터를 반환합니다. 이 옵션을 선택하면 다음도 설정하세요:
  • Response Data: 반환할 데이터와 사용할 형식을 선택합니다. 옵션은 다음과 같습니다:
    • All Entries: 마지막 노드의 모든 항목을 배열로 반환합니다.
    • First Entry JSON: 마지막 노드의 첫 번째 항목에 대한 JSON 데이터를 JSON 객체로 반환합니다.
    • First Entry Binary: 마지막 노드의 첫 번째 항목에 대한 바이너리 데이터를 바이너리 파일로 반환합니다.
    • No Response Body: 본문 없이 응답을 반환합니다.
• Using 'Respond to Webhook' Node: Respond to Webhook 노드에서 정의된 대로 응답합니다.

Limit Wait Time#

워크플로가 특정 제한 유형 이후 자동으로 실행을 재개할지(켬) 아닐지(끔)를 설정합니다. 켜는 경우 다음도 설정하세요:

• Limit Type: 다음 옵션 중에서 적용할 제한 유형을 선택합니다:
  • After Time Interval: 일정 시간 동안 대기합니다.
    • 제한할 시간의 Amount(양)를 입력합니다.
    • 제한할 시간의 Unit(단위)을 선택합니다.
  • At Specified Time: 재개할 특정 날짜와 시간까지 대기합니다.
    • Max Date and Time: 날짜 및 시간 선택기를 사용하여 노드가 재개할 특정 시간을 설정합니다.

웹훅 호출 시 옵션#

• Binary Property: 수신된 파일의 데이터를 기록할 바이너리 속성의 이름을 입력합니다. 이 옵션은 바이너리 데이터가 수신되는 경우에만 관련이 있습니다.
• Ignore Bots: 링크 미리보기 프로그램이나 웹 크롤러와 같은 봇의 요청을 무시할지(켬) 아닐지(끔)를 설정합니다.
• IP(s) Whitelist: 웹훅 URL을 호출할 수 있는 사람(또는 대상)을 제한하려면 여기에 IP 주소를 입력합니다. 허용된 IP 주소를 쉼표로 구분하여 목록으로 입력합니다. 화이트리스트에 없는 IP에서 접근하면 403 오류가 발생합니다. 비워두면 모든 IP 주소가 웹훅 URL을 호출할 수 있습니다.
• No Response Body: n8n이 응답에 본문을 전송할지(끔) 또는 응답에 본문을 전송하지 못하도록 할지(켬)를 설정합니다.
• Raw Body: JSON이나 XML과 같은 원시 형식으로 본문을 반환할지(켬) 아닐지(끔)를 설정합니다.
• Response Data: 응답에 담아 전송하고 싶은 사용자 지정 데이터를 입력합니다.
• Response Headers: 웹훅 응답에 추가 헤더를 전송합니다. 응답 헤더에 대해 자세히 알아보려면 MDN Web Docs | Response header를 참고하세요.
• Webhook Suffix: 재개 URL에 추가할 접미사를 입력합니다. 이는 워크플로에 여러 개의 Wait 노드가 포함된 경우 각 Wait 노드마다 고유한 웹훅 URL을 만드는 데 유용합니다. 생성된 $resumeWebhookUrl에는 이 접미사가 자동으로 포함되지 않으므로, 웹훅 URL을 노출하기 전에 직접 추가해야 합니다.

웹훅 호출 시 제한 사항#

On Webhook Call을 사용할 때 유의해야 할 몇 가지 제한 사항이 있습니다:

• 워크플로를 부분 실행하면 $resumeWebhookUrl이 변경되므로, 이 URL을 원하는 서드파티에 전송하는 노드가 Wait 노드와 동일한 실행 내에서 실행되도록 해야 합니다.

폼 제출 시#

계속 진행하기 전에 폼 제출을 대기합니다. 다음 매개변수를 설정하세요:

Form Title#

폼 상단에 표시할 제목을 입력합니다.

Form Description#

제목 아래에 표시할 폼 설명을 입력합니다. 이 설명은 사용자가 폼을 완료하는 방법을 안내하는 데 도움이 될 수 있습니다.

폼 필드#

다음 매개변수를 사용하여 폼에 표시할 각 필드를 설정하세요:

• Field Label: 폼에 표시할 필드 레이블을 입력합니다.
• Field Type: 폼에 표시할 필드의 유형을 선택합니다. 다음 중에서 선택하세요:
  • Date
  • Dropdown List: Field Options에 각 드롭다운 옵션을 입력합니다.
    • Multiple Choice: 사용자가 드롭다운 옵션을 하나만 선택할 수 있는지(끔) 여러 개 선택할 수 있는지(켬)를 선택합니다
  • Number
  • Password
  • Text
  • Textarea
• Required Field: 사용자가 폼을 제출하려면 이 필드를 반드시 작성해야 하는지(켬) 또는 작성하지 않고도 폼을 제출할 수 있는지(끔)를 설정합니다.

Respond When#

폼 제출에 언제 응답할지 설정합니다. 다음 중에서 선택하세요:

• Form Is Submitted: 이 노드가 폼 제출을 수신하는 즉시 응답합니다.
• Workflow Finishes: 이 워크플로의 마지막 노드가 완료되면 응답합니다.
• Using 'Respond to Webhook' Node: Respond to Webhook 노드가 실행될 때 응답합니다.

Limit Wait Time#

워크플로가 특정 제한 유형 이후 자동으로 실행을 재개할지(켬) 아닐지(끔)를 설정합니다.

켜는 경우 다음도 설정하세요:

• Limit Type: 다음 옵션 중에서 적용할 제한 유형을 선택합니다:
  • After Time Interval: 일정 시간 동안 대기합니다.
    • 제한할 시간의 Amount(양)를 입력합니다.
    • 제한할 시간의 Unit(단위)을 선택합니다.
  • At Specified Time: 재개할 특정 날짜와 시간까지 대기합니다.
    • Max Date and Time: 날짜 및 시간 선택기를 사용하여 노드가 재개할 특정 시간을 설정합니다.

폼 응답 시 옵션#

• Form Response: 다음 옵션 중에서 폼이 Respond With(응답할 방식)를 선택합니다:
  • Form Submitted Text: 사용자가 폼을 작성한 후 Text to Show에 입력된 텍스트를 폼에 표시합니다. 확인 메시지를 표시하려는 경우 이 옵션을 사용하세요.
  • Redirect URL: 사용자가 폼을 작성한 후 URL to Redirect to로 리디렉션합니다. 이는 유효한 URL이어야 합니다.
• Webhook Suffix: 재개 URL에 추가할 접미사를 입력합니다. 이는 워크플로에 여러 개의 Wait 노드가 포함된 경우 각 Wait 노드마다 고유한 웹훅 URL을 만드는 데 유용합니다. 생성된 $resumeWebhookUrl에는 이 접미사가 자동으로 포함되지 않으므로, 웹훅 URL을 노출하기 전에 직접 추가해야 합니다.

템플릿 및 예제#

Wait 통합 템플릿 살펴보기 또는 모든 템플릿 검색하기

시간 기반 작업#

시간 기반 재개 작업의 경우 다음 사항에 유의하세요:

• 대기 시간이 65초 미만인 경우 워크플로는 실행 데이터를 데이터베이스로 오프로드하지 않습니다. 대신 프로세스가 계속 실행되며 지정된 간격이 지나면 실행이 재개됩니다.
• 시간대 설정과 관계없이 항상 n8n 서버 시간이 사용됩니다. 워크플로 시간대 설정 및 그에 대한 변경 사항은 Wait 노드의 간격이나 지정된 시간에 영향을 미치지 않습니다.