> For the complete documentation index, see [llms.txt](https://guide.hypercape.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.hypercape.com/brand-guide/email-system.md).

# 메일 관리

**진입 경로**: 고객·메시지 > 메일 관리

메일 관리에서는 폼 이벤트 메일 템플릿과 발송 방식을 관리합니다. 메일 종류, 발송 시점, 템플릿 변수, 일괄 발송 방식을 한 곳에서 확인할 수 있습니다.

### 무엇을 할 수 있나요

* 폼 이벤트 메일 템플릿을 수정합니다.
* 발송 변수와 CS 메일 설정을 확인합니다.
* 일괄 발송 방식과 발송 상태를 확인합니다.

***

### 메일 종류 개요

| 카테고리      | 메일        | 발송 시점          |
| --------- | --------- | -------------- |
| **조직**    | 멤버 초대     | 팀 멤버 초대 시      |
| **폼 이벤트** | 응모 접수 확인  | 새 응모 접수 시      |
| **폼 이벤트** | 선정 안내     | 응모자 선정 시       |
| **폼 이벤트** | 미선정 안내    | 응모자 미선정 시      |
| **폼 이벤트** | 배송 안내     | 배송 정보 입력 시     |
| **폼 이벤트** | 콘텐츠 제출 요청 | 선정자에게 콘텐츠 요청 시 |

***

### 폼 이벤트 메일 템플릿

폼 이벤트에서는 5가지 메일 템플릿을 직접 커스터마이징할 수 있습니다.

#### 템플릿 종류

**1. 응모 접수 확인 (Entry Applied)**

* **발송 시점**: 새로운 응모가 접수될 때
* **수신 대상**: 응모자
* **용도**: 응모가 정상적으로 접수되었음을 안내

**2. 선정 안내 (Entry Confirmed)**

* **발송 시점**: 응모자를 선정 처리할 때
* **수신 대상**: 선정된 응모자
* **용도**: 당첨 사실과 다음 단계 안내

**3. 미선정 안내 (Entry Denied)**

* **발송 시점**: 응모자를 미선정 처리할 때
* **수신 대상**: 미선정된 응모자
* **용도**: 미선정 사실 안내

**4. 배송 안내 (Entry Shipped)**

* **발송 시점**: 배송 정보(운송장)를 입력할 때
* **수신 대상**: 선정된 응모자
* **용도**: 배송 시작 및 추적 정보 안내

**5. 콘텐츠 제출 요청 (Content Request)**

* **발송 시점**: 브랜드에서 일괄 콘텐츠 요청 시
* **수신 대상**: 선정된 응모자 중 콘텐츠 미제출자
* **용도**: 콘텐츠 제출 링크와 방법 안내

> ⚠️ **배송불가(Undeliverable)로 표시된 응모자**는 콘텐츠 제출 요청 메일 발송 대상에서 **자동으로 제외**됩니다.

***

### 템플릿 변수 (Placeholders)

메일 템플릿에서 사용할 수 있는 변수입니다. `{{변수명}}` 형식으로 삽입하면 발송 시 실제 값으로 자동 치환됩니다.

#### 기본 정보

| 변수                   | 설명       | 사용 가능 템플릿 |
| -------------------- | -------- | --------- |
| `{{brandName}}`      | 브랜드명     | 전체        |
| `{{csEmail}}`        | CS 이메일   | 전체        |
| `{{formEventTitle}}` | 이벤트 제목   | 전체        |
| `{{entryName}}`      | 응모자 이름   | 전체        |
| `{{entryEmail}}`     | 응모자 이메일  | 전체        |
| `{{entryPhone}}`     | 응모자 전화번호 | 전체        |
| `{{entryStatus}}`    | 응모 상태    | 전체        |

#### 심사 관련

| 변수                 | 설명     | 사용 가능 템플릿 |
| ------------------ | ------ | --------- |
| `{{reviewerNote}}` | 심사 메모  | 선정 안내     |
| `{{cancelReason}}` | 미선정 사유 | 미선정 안내    |

#### 배송 정보

| 변수                        | 설명        | 사용 가능 템플릿 |
| ------------------------- | --------- | --------- |
| `{{carrierName}}`         | 국제 배송사명   | 배송 안내     |
| `{{trackingNumber}}`      | 국제 운송장번호  | 배송 안내     |
| `{{trackingUrl}}`         | 배송 추적 URL | 배송 안내     |
| `{{localCarrierName}}`    | 로컬 배송사명   | 배송 안내     |
| `{{localTrackingNumber}}` | 로컬 운송장번호  | 배송 안내     |
| `{{localTrackingUrl}}`    | 로컬 추적 URL | 배송 안내     |

#### 배송지 정보

| 변수                          | 설명       | 사용 가능 템플릿 |
| --------------------------- | -------- | --------- |
| `{{shippingRecipientName}}` | 수령자명     | 배송 안내     |
| `{{shippingPhone}}`         | 수령자 전화번호 | 배송 안내     |
| `{{shippingLine1}}`         | 주소 1     | 배송 안내     |
| `{{shippingLine2}}`         | 주소 2     | 배송 안내     |
| `{{shippingCity}}`          | 도시       | 배송 안내     |
| `{{shippingState}}`         | 주/도      | 배송 안내     |
| `{{shippingPostalCode}}`    | 우편번호     | 배송 안내     |
| `{{shippingCountry}}`       | 국가       | 배송 안내     |
| `{{shippingFullAddress}}`   | 전체 주소    | 배송 안내     |

#### 콘텐츠 관련

| 변수                         | 설명        | 사용 가능 템플릿 |
| -------------------------- | --------- | --------- |
| `{{contentSubmissionUrl}}` | 콘텐츠 제출 링크 | 콘텐츠 제출 요청 |

#### 동적 폼 필드

폼 빌더에서 설정한 커스텀 필드의 응답값도 변수로 사용할 수 있습니다:

```
{{formResponses.필드키}}
```

예시:

* `{{formResponses.instagram_handle}}` → 응모자가 입력한 인스타그램 핸들
* `{{formResponses.shoe_size}}` → 응모자가 입력한 신발 사이즈

***

### 템플릿 관리

#### 템플릿 편집

1. 폼 이벤트 상세 페이지에서 **메일 템플릿** 탭 선택
2. 편집할 템플릿 종류 선택 (5가지 탭)
3. HTML 에디터로 내용 편집
4. **변수 도움말** 패널에서 사용 가능한 변수 확인
5. 저장

#### 템플릿 제한

| 항목                | 제한         |
| ----------------- | ---------- |
| **제목**            | 최대 200자    |
| **HTML 본문**       | 최대 50,000자 |
| **Plain Text 본문** | 최대 10,000자 |

#### 기본 템플릿

각 템플릿 타입에는 시스템 기본 템플릿이 제공됩니다.

커스텀 템플릿을 삭제하면 시스템 기본 템플릿으로 복원됩니다.

삭제 없이도 **기본값 해제**로 시스템 기본 템플릿을 다시 적용할 수 있습니다.

기본값 해제 방법:

1. 폼 이벤트 상세 페이지에서 **이메일 템플릿** 탭 선택
2. 기본값으로 되돌릴 템플릿 종류 선택
3. **기본값 해제** 클릭

{% hint style="warning" %}
**기본값 해제**는 현재 커스텀 템플릿 내용을 시스템 기본값으로 덮어씁니다.
{% endhint %}

***

### CS 메일 설정

메일에 포함되는 CS 연락처를 설정합니다.

* **브랜드 레벨**: 폼 이벤트 목록 페이지의 **CS 메일 관리** 버튼에서 설정
* **이벤트 레벨**: 각 이벤트 설정에서 이벤트별 CS 메일 지정 가능

> 💡 이벤트별 CS 메일이 설정되지 않으면 브랜드 레벨 CS 메일이 사용됩니다.

***

### 메일 일괄 발송

#### 선정 안내 일괄 발송

선정된 응모자 전체에게 선정 안내 메일을 일괄 발송합니다.

* 이미 메일이 발송된 응모자는 자동으로 제외됩니다.

#### 콘텐츠 제출 요청 일괄 발송

선정된 응모자 중 콘텐츠를 아직 제출하지 않은 응모자에게 콘텐츠 제출 요청 메일을 일괄 발송합니다.

* 배송불가(Undeliverable) 응모자는 자동으로 제외됩니다.
* 이미 콘텐츠를 제출한 응모자는 제외됩니다.

#### 개별 메일 재발송

특정 응모자에게 메일을 다시 발송할 수 있습니다:

* 응모자 상세 페이지에서 **이메일 재발송** 버튼 클릭

***

### 메일 발송 방식

#### 대량 발송 처리 방식

대량 메일 발송은 큐(Queue) 기반으로 처리됩니다:

1. **메일 잡(Job) 생성**: 발송 요청 시 잡이 생성됨
2. **백그라운드 처리**: 시스템에서 자동으로 순차 발송
3. **상태 추적**: 발송 진행 상황 실시간 확인 가능
4. **실패 재시도**: 발송 실패한 메일은 개별 재시도 가능

#### 메일 잡 상태

| 상태             | 설명      |
| -------------- | ------- |
| **Pending**    | 발송 대기 중 |
| **Processing** | 발송 진행 중 |
| **Completed**  | 발송 완료   |
| **Failed**     | 발송 실패   |
| **Cancelled**  | 취소됨     |

#### 발송 전 미리보기

일괄 발송 전에 다음 정보를 미리 확인할 수 있습니다:

* 발송 예정 수
* 이미 발송된 수 (중복 제외)
* 이전 실패 항목 수

> 💡 한 번에 최대 **5,000건**까지 일괄 발송할 수 있습니다.

***

### 조직 멤버 초대 메일

팀 멤버를 초대하면 자동으로 초대 메일이 발송됩니다.

#### 메일 내용

* **발신**: 하이퍼케이프
* **제목**: `[Hypercape] {브랜드명}에서 초대가 도착했습니다`
* **내용**:
  * 초대자명
  * 브랜드명
  * 부여된 역할
  * 초대 수락 버튼 (CTA)