> 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)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://guide.hypercape.com/brand-guide/email-system.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.