대기

대기 (Wait)

대기(Wait) 노드로 워크플로 실행을 일시 중지할 수 있어요. 워크플로가 멈추면 실행 데이터를 데이터베이스로 내려보냅니다. 재개(resume) 조건이 충족되면 워크플로가 데이터를 다시 불러와 실행을 이어갑니다.

동작(Operations)

대기 노드는 다음 조건에서 재개(Resume) 할 수 있어요.

자세한 안내는 아래 절을 참고하세요.

시간 간격 후(After Time Interval)

일정 시간 동안 기다립니다. 이 파라미터에는 필드가 두 개 더 있어요.

  • 대기량(Wait Amount): 기다릴 시간을 입력합니다.
  • 대기 단위(Wait Unit): 대기량의 단위를 선택해요. 선택지는 다음과 같습니다.
    • 초(Seconds)
    • 분(Minutes)
    • 시(Hours)
    • 일(Days)

이 간격들이 어떻게 동작하는지와 사용되는 타임존은 시간 기반 동작을 참고하세요.

지정된 시각에(At Specified Time)

계속하려면 특정 날짜·시각까지 기다립니다. 날짜와 시간(Date and Time) 을 설정하려면 날짜·시간 선택기를 사용하세요. 사용되는 타임존은 시간 기반 동작을 참고합니다.

웹훅 호출 시(On Webhook Call)

이 파라미터는 대기 노드가 HTTP 호출을 받으면 워크플로를 재개하도록 해요.

호출 시 실행을 재개하는 웹훅 URL은 런타임에 생성됩니다. 대기 노드는 $execution.resumeUrl 변수를 제공해서, 아직 생성되지 않은 URL을 어디든 참조하고 보낼 수 있게 해줍니다. 예를 들어 서드파티 서비스나 이메일에 넣어 보낼 수 있어요.

워크플로가 실행되면 대기 노드가 $execution.resumeUrl을 사용해 재개 URL과 워크플로의 웹훅을 생성합니다.

이 생성된 URL은 각 실행에 고유합니다. 그래서 워크플로에 대기 노드가 여러 개 있어도, 웹훅 URL이 호출되면 각 대기 노드를 순서대로 재개할 수 있어요.

인증(Authentication)

$execution.resumeUrl로 들어오는 재개 웹훅 요청을 인증할지, 어떻게 인증할지 선택합니다. 옵션은 다음과 같습니다.

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

인증 참고

각 인증 유형에 대한 자세한 내용은 웹훅 노드 | 인증 문서를 참고하세요.

HTTP 메서드

웹훅이 사용할 HTTP 메서드를 선택합니다. 자세한 내용은 웹훅 노드 | HTTP 메서드 문서를 참고하세요.

응답(Respond)

  • 즉시(Immediately): 노드가 실행되는 즉시 응답합니다.
  • 마지막 노드 완료 시(When Last Node Finishes): 응답 코드와 워크플로에서 마지막으로 실행된 노드의 데이터 출력을 반환해요. 이 옵션을 선택하면 응답 데이터(Response Data) 도 설정해야 합니다. 무엇을 어떤 형식으로 반환할지 고르세요.
  • 응답 본문 없음(No Response Body): 본문 없이 반환합니다.
  • 'Respond to Webhook' 노드 사용(Using 'Respond to Webhook' Node): Respond to Webhook 노드에 정의된 대로 응답합니다.

대기 시간 제한(Limit Wait Time)

워크플로가 특정 제한 유형 이후 자동으로 재개할지(켬), 하지 않을지(끔) 설정합니다. 켜면 다음도 설정합니다.

웹훅 호출 시 옵션(On Webhook Call options)

  • 응답 헤더(Response Headers): 웹훅 응답에 추가 헤더를 보내요. 응답 헤더에 대한 자세한 내용은 MDN 웹 문서 | 응답 헤더를 참고하세요.
  • 웹훅 접미사(Webhook Suffix): 재개 URL에 덧붙일 접미사를 입력합니다. 워크플로에 대기 노드가 여러 개 있을 때 각 대기 노드에 고유한 웹훅 URL을 만들 때 유용해요. 생성된 $resumeWebhookUrl에는 이 접미사가 자동으로 포함되지 않는다는 점을 기억하세요. 노출하기 전에 웹훅 URL에 직접 붙여야 합니다.

웹훅 호출 시 제한(On Webhook Call limitations)

  • 워크플로를 부분 실행하면 $resumeWebhookUrl이 바뀝니다. 이 URL을 원하는 서드파티로 보내는 노드가 대기 노드와 같은 실행 안에서 실행되도록 하세요.

폼 제출 시(On Form Submitted)

폼 필드(Form Fields)

  • 필드 라벨(Field Label): 폼에 표시할 필드 라벨을 입력합니다.
  • 필드 타입(Field Type): 폼에 표시할 필드 유형을 선택해요. 선택지는 다음과 같습니다.
    • 날짜(Date)
    • 드롭다운 목록(Dropdown List): 각 드롭다운 옵션을 필드 옵션(Field Options) 에 입력합니다.

응답 시점(Respond When)

  • 폼 제출 시(Form Is Submitted): 이 노드가 폼 제출을 받는 즉시 응답합니다.
  • 워크플로 완료 시(Workflow Finishes): 이 워크플로의 마지막 노드가 끝날 때 응답해요.
  • 'Respond to Webhook' 노드 사용(Using 'Respond to Webhook' Node): Respond to Webhook 노드가 실행될 때 응답합니다.

대기 시간 제한(Limit Wait Time)

워크플로가 특정 제한 유형 이후 자동으로 재개할지(켬), 하지 않을지(끔) 설정합니다. 켜면 다음도 설정합니다.

템플릿과 예시

대기 통합 템플릿 보기 또는 모든 템플릿 검색

시간 기반 동작(Time-based operations)

  • 대기 시간이 65초 미만이면 워크플로가 실행 데이터를 데이터베이스로 내려보내지 않아요. 대신 프로세스가 계속 실행되고 지정된 간격이 지나면 실행이 재개됩니다.
  • 타임존 설정과 무관하게 항상 n8n 서버 시간을 사용합니다. 워크플로 타임존 설정이나 그 변경은 대기 노드의 간격이나 지정된 시각에 영향을 주지 않아요.