# 워크플로우 트리거 – 서비스 예약 (Services v2)

## 워크플로우 트리거 – 서비스 예약 (Services v2)

**서비스 예약(Services v2)** 워크플로우 트리거가 무엇인지, 언제 실행되는지, 그리고 예약 상태 트리거와 어떻게 다른지 알아보세요. 이 가이드에서는 워크플로우에서 서비스 예약 트리거를 사용하기 위해 알아야 할 모든 정보를 다룹니다.

***

**목차**

* [서비스 예약 트리거란?](#서비스-예약-트리거란)
* [서비스 예약 트리거의 주요 장점](#서비스-예약-트리거의-주요-장점)
* [언제 트리거되나요?](#언제-트리거되나요)
* [예약 상태 트리거와의 주요 차이점](#예약-상태-트리거와의-주요-차이점)
* [사용 가능한 필터](#사용-가능한-필터)
* [트리거 표시](#트리거-표시)
* [서비스 예약 시 주문 제출 트리거 동작](#서비스-예약-시-주문-제출-트리거-동작)
* [지원되는 예약 액션](#지원되는-예약-액션)
* [서비스 예약에서 커스텀 값 사용하기](#서비스-예약에서-커스텀-값-사용하기)
* [커스터마이징 방법](#커스터마이징-방법)
* [서비스 예약 워크플로우 트리거 설정 방법](#서비스-예약-워크플로우-트리거-설정-방법)
* [자주 묻는 질문](#자주-묻는-질문)

***

## **서비스 예약 트리거란?**

서비스 예약 트리거를 사용하면 서비스 예약(여러 서비스/예약을 포함할 수 있음)이 생성되거나 업데이트될 때마다 워크플로우를 자동화할 수 있습니다. 개별 캘린더 예약에 작동하는 예약 수준 트리거와 달리, 이 트리거는 메인 예약 수준에서 작동합니다. 즉, 고객이 한 번에 여러 서비스를 예약하는 경우(예: 헤어컷, 페이셜, 마사지를 한 번의 결제로 예약), 워크플로우는 전체 예약에 대해 한 번만 트리거되며, 세 번 트리거되지 않습니다. 이렇게 하면 모든 서비스 세부 정보를 한 곳에서 확인할 수 있으면서도 중복 작업을 피할 수 있습니다.

![서비스 예약 트리거 설정 화면](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053330224/original/74B0X4pUs3yQIxMSbgOcw2RPzUQGq7LZcg.png?1757367116)

***

### **서비스 예약 트리거의 주요 장점**

이러한 장점을 이해하면 서비스 예약 워크플로우 트리거를 언제 사용할지 결정하는 데 도움이 됩니다.

* **중복 메시지 방지**: 여러 서비스를 구매해도 예약당 한 번만 실행되어 커뮤니케이션이 깔끔합니다.
* **개인화된 커뮤니케이션**: 예약 세부 정보(서비스, 날짜/시간, 소요 시간, 직원, 애드온, 시간대)를 통해 고객이 예약한 내용을 정확히 이해할 수 있습니다.
* **적절한 대상 타겟팅**: 상태, 서비스, 카테고리, 태그, 위치 또는 예약을 생성/수정한 사람으로 필터링하여 관련 메시지를 적절한 사람에게 보냅니다.
* **다중 서비스 요약**: 하나의 확인서에 예약된 모든 서비스와 선택된 애드온을 나열하여 혼동과 후속 질문을 줄입니다.

### **언제 트리거되나요?**

워크플로우는 다음을 통해 **새로운 서비스 예약이 생성**될 때마다 활성화됩니다:

* **예약 페이지**: 고객이 온라인으로 셀프 예약할 때
* **사용자**: 직원이 수동으로 예약을 생성할 때

### 예약 상태 트리거와의 주요 차이점

핵심 동작을 비교하여 예약 수준과 예약 수준 자동화를 혼동하지 마세요.

* **예약 상태 트리거** → 캘린더 예약에만 작동합니다.
* **서비스 예약 트리거** → 서비스(v2) 예약에만 작동합니다.
* 예약자가 하나의 서비스 예약 하에 여러 서비스(예: 5개 서비스)를 예약하면, 워크플로우는 한 번만 트리거됩니다(5번이 아닌).

**예시**: 워크플로우 액션이 "이메일 발송"인 경우, 서비스 예약 커스텀 값을 사용한다면 예약된 모든 서비스를 포함하는 이메일 한 통만 발송됩니다.

***

### **사용 가능한 필터**

필터는 어떤 예약이 워크플로우를 시작할지 좁혀서 자동화가 집중적이고 관련성 있게 유지되도록 합니다. 이 트리거에 사용 가능한 필터는 다음과 같습니다:

* 예약 상태 (미확인, 확인됨, 참석, 노쇼, 취소, 무효)
* 생성자 / 수정자
* 태그 포함
* 서비스 내 (특정 서비스)
* 서비스 카테고리 내 (서비스 그룹)
* 서비스 위치 내

![서비스 예약 트리거 필터 옵션](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053330014/original/y59aJF0FVY2oOgYVJvD4v4aBtQbpW2PxDA.png?1757366323)

***

### **트리거 표시**

이 트리거는 하위 계정에서 서비스(v2)가 활성화된 경우에만 표시됩니다. 하위 계정에서 서비스(v2)가 비활성화된 경우:

* **새 워크플로우** → 서비스 예약 트리거를 선택할 수 없습니다.
* **기존 워크플로우** (이미 이 트리거를 포함하는 경우):
  * 새 예약은 차단됩니다 (트리거가 실행되지 않음).
  * 기존 예약 → 예약 상태가 업데이트되면 워크플로우는 예상대로 트리거됩니다.

***

### **서비스 예약 시 주문 제출 트리거 동작**

기본적으로 서비스 예약이 생성될 때마다 **주문**이 자동으로 생성됩니다. 중복 자동화를 방지하기 위해 서비스 예약을 통해 생성된 주문에 대해서는 주문 제출 트리거가 실행되지 않습니다.

하지만 이러한 주문에 대해서도 워크플로우가 트리거되기를 원한다면, 명시적으로 필터를 추가해야 합니다:

* **주문 소스 = 캘린더**

이렇게 하면 **주문 기반 워크플로우**가 서비스 예약 주문에 대해서만 실행되며, 비즈니스에서 명시적으로 원할 때만 — 주문 제출 트리거에 **주문 소스 = 캘린더** 필터를 적용함으로써 실행됩니다.

![주문 소스 필터 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053330194/original/k1mro9IrxC3iuEYayMYeg3vM26gjCjjsOg.png?1757366998)

### **지원되는 예약 액션**

| 액션         | 상태      | 참고사항                             |
| ---------- | ------- | -------------------------------- |
| 예약 상태 업데이트 | ✅ 지원됨   | 서비스 예약 ID 기반                     |
| 예약 노트 생성   | ✅ 지원됨   | 서비스 예약 ID 기반. 노트는 서비스 예약 전체에 적용됨 |
| 예약하기       | 지원되지 않음 | 해당없음                             |
| 대화 AI 예약 봇 | 지원되지 않음 | 해당없음                             |
| Eliza 예약   | 지원되지 않음 | 해당없음                             |

### 서비스 예약에서 커스텀 값 사용하기

누군가 서비스를 예약할 때, 예약 세부 정보(서비스명, 날짜, 시간, 가격, 직원, 애드온 등)를 이메일, 문자 또는 리마인더에 자동으로 포함할 수 있습니다.

![커스텀 값 사용 예시](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155058667780/original/9vrckUAOyABBgRrLd8n27INqKg1_B9SqTQ.gif?1763478202)

#### 어떤 세부 정보를 사용할 수 있나요?

예약된 각 서비스에 대해 다음을 표시할 수 있습니다:

* **서비스명**: 예: "헤어컷" 또는 "마사지"
* **가격**: 서비스 비용
* **소요 시간**: 서비스가 지속되는 시간 (예: 60분)
* **날짜 및 시간**: 예약이 예정된 시간
* **시간대**: 고객의 현지 시간대
* **배정된 직원**: 예약을 담당하는 팀원
* **애드온**: 고객이 선택한 추가 옵션 (가격 포함)

여러 서비스가 함께 예약된 경우, 각 서비스(및 애드온)가 차례로 나열됩니다.

#### 예시: 템플릿에서 표시되는 방식

```
{{#each serviceBooking.services}}
  {{this.name}} - {{this.duration}} | 가격: {{this.price}}  
  날짜: {{this.startDate}} {{this.startTime}} ({{this.timezone}})  
  담당자: {{this.assignedUser}}  

  {{#if addOns}}
    애드온:  
    {{#each addOns}}
      - {{this.addonName}} ({{this.addonPrice}})  
    {{/each}}
  {{/if}}
{{/each}}
```

**작동 방식**:

* `{{#each serviceBooking.services}} ... {{/each}}` 블록은 예약된 각 서비스에 대해 내부의 모든 내용을 반복합니다.
* 고객이 3개 서비스를 예약하면 이 섹션이 3번 반복됩니다 (각 서비스마다 한 번씩).
* 애드온(선택된 경우)은 해당 서비스 아래에 나열됩니다.

커스텀 값에 대한 더 자세한 정보를 원하시나요? [커스텀 값 사용 방법](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/23-레거시-자동화/Logic-&-Fulfillment/how-to-use-custom-values.md)을 확인하세요.

***

### 커스터마이징 방법

추가 정보(예: 직원의 전체 이름)를 표시하려면 블록 내에 커서를 놓고 추가 플레이스홀더를 추가하기만 하면 됩니다.

**직원 이름이 포함된 예시**:

```
{{#each serviceBooking.services}}
  {{this.name}} - {{this.duration}} | 가격: {{this.price}}  
  담당 직원: {{this.user.name}}  
  날짜: {{this.startDate}} {{this.startTime}} ({{this.timezone}})  
  담당자: {{this.assignedUser}}  
{{/each}}
```

이렇게 하면 고객이 예약한 정확한 서비스 세부 정보로 확인 이메일이나 리마인더를 완전히 개인화할 수 있습니다.

***

### 서비스 예약 워크플로우 트리거 설정 방법

적절한 설정은 워크플로우가 올바른 시간에 실행되고, 올바른 예약을 대상으로 하며, 올바른 세부 정보를 전달하도록 보장합니다.

**1단계: 워크플로우 생성 또는 열기**

* 좌측 네비게이션 바에서 **Automation(자동화)** 탭을 선택합니다
* 기존 워크플로우를 열려면 워크플로우 이름을 클릭합니다
* 새 워크플로우를 생성하려면 "+ Create New Workflow(새 워크플로우 생성)" 버튼을 사용합니다

![워크플로우 생성 화면](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053330552/original/8mnO8MtsgUsvrH1FulZYq5FAXczERNnRRQ.png?1757368242)

**2단계: 트리거 추가**

* "+ Add New Trigger(새 트리거 추가)"를 클릭하여 새 트리거를 생성합니다
* 검색창을 사용하여 **Service Booking(서비스 예약)** 트리거를 선택합니다

![서비스 예약 트리거 선택](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053330579/original/jPqZY7tm_rQ5-XszfSXqlLvZ4_oTosnmcQ.png?1757368385)

**3단계: 필터 추가**

* 필요한 필터를 사용하여 트리거를 요구사항에 맞게 구성합니다. [사용 가능한 필터에 대한 자세한 정보는 여기를 클릭하세요.](#사용-가능한-필터)
* 완전히 구성한 후 파란색 "Save Trigger(트리거 저장)" 버튼을 사용하여 변경 사항을 저장합니다

![트리거 필터 설정 완료](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053330615/original/EXx6UxQFcMR3aBDIhp2i5BldgCcArKyP9w.png?1757368482)

***

### **자주 묻는 질문**

**Q: 하위 계정에서 서비스 예약 트리거를 사용할 수 있게 하려면 어떻게 해야 하나요?** 서비스(v2)가 활성화되어 있는지 확인하세요. 서비스가 비활성화되어 있으면 새 워크플로우에서 트리거를 사용할 수 없습니다. [서비스 활성화에 대한 자세한 정보는 여기를 클릭하세요](/hyperclass-docs/and-calendars/services-overview-how-to-get-started.md)

**Q: 확인 메시지나 리마인더에 직원 세부 정보를 포함할 수 있나요?** 네. 커스텀 값을 사용하여 배정된 직원(또는 가격, 날짜, 위치 등의 기타 정보)을 커뮤니케이션에서 참조할 수 있습니다.

***

*원문 최종 수정: Tue, 18 Nov, 2025 at 9:03 AM* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/and-calendars/workflow-action-book-appointment/workflow-trigger-service-booking-services-v2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.