# 워크플로우 트리거 - 구독

## 개요

GoHighLevel의 구독 트리거는 구독 상태 변경과 관련된 프로세스를 자동화하여 비즈니스의 워크플로우 효율성을 높입니다. 이 기능을 통해 구독 생명주기의 주요 이벤트에 자동으로 대응할 수 있어요.

***

## 트리거 이름

구독(Subscription)

## 트리거 설명

구독 트리거는 다음과 같은 특정 이벤트를 기반으로 워크플로우를 활성화합니다:

* 고객의 새로운 구독 생성
* 구독이 체험판(trial)에서 활성(active) 상태로 전환
* 구독 취소

이 트리거를 통해 구독 상태 변경이나 연관된 상품을 조건으로 설정할 수 있으며, 결제(Payments) 섹션의 커스텀 값을 활용하여 맞춤형 자동화를 구현할 수 있어요.

***

## 설정 방법

### 트리거 접근

GoHighLevel 대시보드의 자동화(Automations) 섹션으로 이동하세요. 워크플로우 빌더에 들어간 후 "트리거 추가(Add Trigger)"를 클릭합니다.

### "구독(Subscription)" 트리거 선택

결제(Payments) 섹션에서 구독 트리거를 선택하세요. 이 트리거를 사용하면 연락처의 구독 상태가 변경되거나 결제 플랫폼을 통해 새 구독이 생성될 때 자동화를 실행할 수 있어요.

![구독 트리거 선택](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155047575727/original/oEAqDx5y42GtEH8tHiNCaKMl-vkFcmP4ww.png?1748856588)

### 필터 추가

"필터 추가(Add filters)" 옵션을 사용하여 어떤 구독이 워크플로우를 트리거할지 조건을 좁힐 수 있어요. 필터를 통해 구매한 상품이나 구독 상태(예: 활성, 실패, 체험판) 등의 기준을 지정할 수 있습니다. 모든 구독이 아닌 특정 상황에서만 워크플로우가 실행되도록 하고 싶을 때 유용해요.

![필터 추가 옵션](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155047575769/original/Y4FVhl7-oiXSMpzlufHJQg6Eq0MxQkUxsA.png?1748856610)

### 필터 옵션: 기본 필드 & 커스텀 필드

이 드롭다운을 통해 구독 트리거가 언제 활성화될지 조건부 필터를 추가할 수 있어요. 두 가지 유형의 필드를 선택할 수 있습니다:

* **기본 필드(Standard Fields)**: 글로벌 상품(구독과 연관된 상품)이나 상태(예: 활성, 만료, 실패) 같은 내장 옵션들이에요. 이러한 필드로 필터링하면 특정 시스템 레벨 조건이 충족될 때만 워크플로우가 실행됩니다.
* **커스텀 필드(Custom Fields)**: 구독과 관련된 특정 세부사항을 추적하기 위해 사용자나 팀이 추가한 개인화된 필드예요(예: 멤버십 등급, 고객 세그먼트). 커스텀 필드를 사용하면 고유한 비즈니스 로직에 기반한 더욱 맞춤화된 자동화가 가능합니다.

![필터 옵션 선택](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155047575812/original/qa2p25hNspPq5WPkzyIHMTUe19uFdlZ39g.png?1748856630)

### 글로벌 상품 필터

**글로벌 상품(Global Products)** 필터는 구독에 연결된 특정 상품을 기반으로 워크플로우를 트리거하는 데 도움이 됩니다. **일치함(Is)**, **일치하지 않음(Is not)**, **비어있음(Is empty)**, **비어있지 않음(Is not empty)** 등의 옵션을 선택해서 상품을 포함하거나 제외할 수 있어요. 이 필터를 선택하면 검색 가능한 드롭다운이 나타나서 하나 이상의 상품을 선택할 수 있습니다. 선택한 상품에 대해서만 워크플로우가 실행되도록 하여 정확하고 상품별 자동화가 가능해요.

![글로벌 상품 필터](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155047579165/original/AiNVjOdvjmtoIY9CGWnTVz7xbVF_y1NBtw.png?1748858448)

### 상태 필터

상태 필터를 통해 연락처 구독의 현재 생명주기 단계를 기반으로 워크플로우를 트리거할 수 있어요. 결제나 액세스 상태 변경에 따른 타겟 이메일, 알림 또는 내부 경고를 보내는 데 유용합니다. "일치함(Is)" 또는 "일치하지 않음(Is not)" 같은 로직을 적용해서 특정 상태의 구독을 포함하거나 제외할 수 있어요. 이를 통해 정확히 정의한 조건에 도달했을 때만 워크플로우가 실행되도록 할 수 있습니다. 상태 필터의 사용 가능한 옵션들은 다음과 같아요:

* **활성(Active)**: 구독이 활성화되어 성공적으로 결제되고 있는 상태예요. 이 상태를 사용하는 워크플로우는 일반적으로 이행, 온보딩 또는 액세스 로직을 처리합니다.
* **취소됨(Canceled)**: 구독이 수동 또는 자동으로 취소된 상태예요. 재참여 캠페인이나 내부 후속 조치를 트리거하는 데 이상적입니다. 또한 Stripe 구독의 경우, 구독이 약정 기간을 완료했을 때도 취소됨 상태가 사용됩니다.
* **만료됨(Expired)**: 구독이 취소나 실패가 아닌 청구 기간 완료로 종료된 상태예요. 갱신이나 피드백 수집에 유용합니다. (Stripe 구독에는 적용되지 않음)
* **미완료 만료(Incomplete Expired)**: 구독 생성 시 첫 번째 결제 시도가 실패한 상태예요. 구독의 첫 결제 실패 시에 적용됩니다. 즉, 구독이 시작되거나 한 번도 활성화되지 못한 상태입니다. (이전 명칭: '실패')
* **미완료(Incomplete)**: 사용자가 구독 프로세스를 시작했지만 완료하지 않은 상태예요(예: 결제 중 장바구니 포기). 후속 알림이나 복구 플로우에 유용합니다.
* **연체(Overdue)**: 결제가 연체되었지만 구독이 기술적으로는 여전히 활성인 상태예요. 유예 기간 메시지나 알림에 이상적입니다. 이는 최소 한 번은 '활성' 상태가 된 구독의 결제에 적용됩니다. 즉, 구독의 첫 결제는 성공했지만 두 번째 이후 결제가 실패했을 때 사용되는 상태예요.
* **예약됨(Scheduled)**: 아직 결제가 시작되지 않은 미래 날짜 구독이에요. 활성화 전에 온보딩이나 준비 이메일을 보내는 데 사용할 수 있어요.
* **체험판(Trial)**: 구독이 현재 체험 단계에 있는 상태예요. 체험 종료 전에 육성 시퀀스나 알림을 보내는 데 유용합니다.
* **미납(Unpaid)**: 구독은 활성이지만 미결제/놓친 결제가 있는 상태예요. 내부 팀에 플래그를 지정하거나 사용자에게 결제 방법 업데이트를 요청하는 데 사용하세요.

![상태 필터 옵션](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155059464853/original/XRelpeTwyVCCzbPC8hN9mylJqtszoA34sw.png?1764335382)

### 액션 커스터마이징

트리거 활성화 후 실행할 액션을 선택하세요. 이메일 발송, 기록 업데이트, 팀원 알림 등이 가능해요.

### 저장 및 활성화

설정을 완료한 후 트리거를 저장하고 의도한 대로 작동하도록 활성화하세요.

***

## 예시

구독 트리거의 일반적인 사용 사례는 고객 커뮤니케이션 자동화예요. 예를 들어, 고객의 구독이 체험판에서 활성 상태로 전환될 때 자동 환영 이메일을 보내서 고객 참여와 만족도를 높일 수 있어요. 마찬가지로 구독이 취소되면 후속 이메일을 트리거하여 피드백을 수집하거나 재참여 인센티브를 제공할 수 있습니다.

***

*원문 최종 수정: Mon, 23 Mar, 2026 at 4:46 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/workflows/workflow-trigger-subscription.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.