> 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/form-events/undefined-9.md).

# 이메일 캠페인

## Part 10 · 이메일 캠페인

응모자에게 발송되는 메일은 **자동 발송**(응모 직후·선정 직후 등)과 **수동 일괄 발송**(운영자가 시점을 정해 보냄) 두 가지가 함께 작동합니다. 마감 임박 시 자동으로 미제출자에게 보내는 **리마인더** 기능도 있습니다.

<figure><img src="/files/hLhV3MsKqli9B46VA5VS" alt=""><figcaption></figcaption></figure>

### 10-1. 이메일 시스템의 두 진입점

이메일 관련 화면은 **두 곳**에 분산되어 있습니다. 어느 쪽으로 들어가느냐에 따라 가능한 작업이 다르므로 먼저 이 구조부터 익혀두면 좋습니다.

| 진입점                 | 위치                                                        | 가능한 작업                                     | 대상 범위         |
| ------------------- | --------------------------------------------------------- | ------------------------------------------ | ------------- |
| **A. 이메일 발송 내역 패널** | 폼 이벤트 상세 페이지 안                                            | 이 캠페인의 일괄 발송, 작업 진행 추적, 재시도                | **이 캠페인 1개**  |
| **B. 메일 관리 페이지**    | 좌측 메뉴 **고객·메시지 > 이메일 관리** (`/dashboard/email-management`) | 멀티 캠페인 동시 발송, **자동 리마인더 설정**, 템플릿 라이브러리 관리 | **여러 캠페인 동시** |

> 💡 **선택 가이드** 한 캠페인의 응모자에게만 보낼 때 → **A. 이벤트 상세** 시즌 캠페인 여러 개에 일제히 보내거나 자동 리마인더를 켜려면 → **B. 메일 관리 페이지**

### 10-2. 6가지 이메일 템플릿

<figure><img src="/files/sDvu30tqRSXPzsfuFsJB" alt=""><figcaption></figcaption></figure>

| 한국어 라벨        | 자동 발송 시점                      |
| ------------- | ----------------------------- |
| **신청 안내**     | 응모 직후 자동 발송                   |
| **선정 안내**     | 응모자 선정 처리 시                   |
| **미선정 안내**    | 응모자 미선정 처리 시 (운영자가 입력한 사유 포함) |
| **배송 안내**     | 배송 정보 입력 시                    |
| **콘텐츠 제출 안내** | 콘텐츠 제출 요청 시 (자동 리마인더 대상)      |
| **이슈 공지**     | 운영자 수동 발송 (배송 지연 사과 등)        |

<figure><img src="/files/iDo4CvVFOwm0UTtU5xXZ" alt=""><figcaption></figcaption></figure>

\
🟡 **자동 리마인더 대상 템플릿** 자동 리마인더 기능은 현재 **콘텐츠 제출 안내** 템플릿에만 적용됩니다 (10-6 참고).

### 10-3. 템플릿 편집 — 템플릿 라이브러리

<figure><img src="/files/OrGc3HD7jnWiCW6U8WY7" alt=""><figcaption></figcaption></figure>

템플릿의 제목·본문을 편집하려면 **메일 관리 페이지** 우상단의 **\[템플릿 관리]** 버튼을 클릭합니다.

각 템플릿은 다음을 가집니다.

* **제목 (Subject)** — 메일 제목
* **본문 (HTML)** — 리치 텍스트 에디터로 작성
* **변수(Placeholder)** — 자동 치환되는 값들

#### 10-3-1. 사용 가능한 변수

| 변수                        | 치환되는 값                                    |
| ------------------------- | ----------------------------------------- |
| `{{name}}`                | 응모자 이름                                    |
| `{{email}}`               | 응모자 이메일                                   |
| `{{brandName}}`           | 브랜드 이름                                    |
| `{{csEmail}}`             | CS 문의 이메일                                 |
| `{{formEventTitle}}`      | 이벤트 제목                                    |
| `{{entryStatus}}`         | 응모자 현재 상태                                 |
| `{{reviewerNote}}`        | 검수자 메모                                    |
| `{{cancelReason}}`        | 취소·미선정 사유                                 |
| `{{carrierName}}`         | 국제 배송사 이름                                 |
| `{{trackingNumber}}`      | 국제 운송장번호                                  |
| `{{trackingUrl}}`         | 국제 운송장 추적 URL                             |
| `{{localCarrierName}}`    | 로컬 배송사                                    |
| `{{localTrackingNumber}}` | 로컬 운송장                                    |
| `{{localTrackingUrl}}`    | 로컬 추적 URL                                 |
| `{{formResponses.*}}`     | 폼 응답의 특정 필드 (예: `{{formResponses.한국이름}}`) |

> 💡 **변수는 두 줄 중괄호** `{{...}}` 형식만 인식합니다. 한 줄 중괄호나 오타가 있으면 변수가 치환되지 않고 그대로 본문에 노출됩니다.

#### 10-3-2. 미리보기

템플릿 편집기에서 샘플 데이터로 실제 메일이 어떻게 보일지 미리 확인할 수 있습니다.

### 10-4. 메일 관리 페이지의 멀티 캠페인 발송

좌측 메뉴 **이메일 관리** 페이지에서는 **여러 폼 이벤트를 한꺼번에** 골라 일괄 발송할 수 있습니다.

<figure><img src="/files/OkrfRqsJdDCnAz4YYl6K" alt=""><figcaption></figcaption></figure>

#### 10-4-1. 페이지 헤더

| 영역        | 내용                                                                      |
| --------- | ----------------------------------------------------------------------- |
| 좌상단 제목    | **메일 관리** + "폼이벤트별 이메일 발송 현황을 관리하고 일괄 발송합니다."                           |
| 우상단 액션    | **가이드** 드롭다운 / **\[템플릿 관리]** / **\[일괄 발송 (N)]** / **상태 필터** (전체·진행중·종료) |
| 확인 필요 스트립 | 미발송·배송불가 건수가 있을 때만 노란 배경으로 노출                                           |

#### 10-4-2. 이벤트 목록 표 — 10개 컬럼

| 컬럼        | 의미                          |
| --------- | --------------------------- |
| 체크박스      | 일괄 발송용 다중 선택                |
| **이벤트명**  | 클릭 시 폼 이벤트 상세로 이동           |
| **선정**    | 선정자 수                       |
| **발송**    | 운송장 등록된 응모자 수 (초록 배지)       |
| **미발송**   | 운송장 미등록 응모자 수 (노랑 배지)       |
| **배송불가**  | Undeliverable 응모자 수 (빨간 배지) |
| **최근발송일** | 직전 리마인더 자동 발송 시각            |
| **리마인더**  | 다음 예정 시각 + 활성/비활성 스위치       |
| **자동 종료** | 리마인더 자동 종료 일정 + 연장 팝오버      |
| **마감일**   | 응모 종료일 (종료된 캠페인은 "종료" 표시)   |

#### 10-4-3. 멀티 캠페인 일괄 발송 흐름

<figure><img src="/files/9gE8FdrEqDiHyo7Kkt3I" alt=""><figcaption></figcaption></figure>

1. 표에서 발송할 캠페인을 **체크박스로 다중 선택**
2. 우상단 **\[일괄 발송 (N)]** 버튼 클릭 (N=선택 카운트)
3. 다이얼로그에서 템플릿·옵션 설정 후 발송
4. **자동 리마인더 옵션**도 이 다이얼로그에서 함께 설정 가능 (콘텐츠 제출 안내 템플릿 선택 시)

### 10-5. 자동 리마인더 — 메일 관리 페이지에서만

마감 임박 시 응모자에게 자동으로 리마인더 메일을 보내는 기능입니다. **콘텐츠 제출 안내** 발송에 가장 많이 활용됩니다.

<figure><img src="/files/A98xQXmdvqvpJujmf5ac" alt=""><figcaption></figcaption></figure>

#### 10-5-1. 설정 위치

자동 리마인더는 **메일 관리 페이지의 이벤트 목록 표 — 리마인더 컬럼**에서 직접 토글합니다 (폼 이벤트 상세 페이지에는 별도 진입점이 없습니다).

| 표시                   | 의미                      |
| -------------------- | ----------------------- |
| **다음 예정 시각** (초록 글씨) | 다음 자동 발송 예정 시각          |
| **대기중** (회색)         | 활성화돼 있지만 다음 시각이 계산되지 않음 |
| **Off** (회색)         | 자동 리마인더 비활성             |
| **스위치**              | 활성/비활성 즉시 토글            |

#### 10-5-2. 리마인더 시작·간격 설정 — 일괄 발송 다이얼로그에서

<figure><img src="/files/fqUCkm5Oi76wmhVwqvSd" alt=""><figcaption></figcaption></figure>

리마인더의 **시작 시점·간격**은 **메일 관리 페이지 > \[일괄 발송] 다이얼로그**에서 콘텐츠 제출 안내 템플릿을 선택할 때 함께 설정합니다.

| 항목                 | 의미                               |
| ------------------ | -------------------------------- |
| **자동 리마인더 활성화** 토글 | 리마인더 사용 여부                       |
| **간격 (N일)**        | 며칠 간격으로 미제출자에게 다시 보낼지 (예: 3일 간격) |
| **자동 종료일**         | 리마인더가 멈출 시점 (보통 콘텐츠 제출 마감일)      |

#### 10-5-3. 자동 종료 연장

<figure><img src="/files/S9GwNs2792Z9md5JFpXo" alt=""><figcaption></figcaption></figure>

이벤트 마감일을 미루면 리마인더 자동 종료일도 함께 미뤄야 합니다. 표의 **자동 종료** 컬럼에 있는 **연장 팝오버**(Calendar 아이콘)에서 새 종료일을 선택하면 됩니다.

### 10-6. 응모자별 이메일 발송 이력

특정 응모자에게 어떤 메일이 언제 보내졌는지 추적하려면 **응모자 상세 다이얼로그**(Part 7-4 참고)를 엽니다.

선정 상태 응모자의 다이얼로그 본문에 **이메일 발송 이력 영역**이 자동으로 표시됩니다.

<figure><img src="/files/MXJqdEs7XTpCMzuGpFg9" alt=""><figcaption></figcaption></figure>

| 표시                   | 내용                   |
| -------------------- | -------------------- |
| 발송된 템플릿              | 신청 안내 / 선정 안내 등      |
| 발송 시각                | 일시                   |
| 도달 상태                | 전달 / 반송 / 스팸 신고 / 차단 |
| (디버깅용) 메일 서비스 메시지 ID | AWS SES 등의 ID        |

<figure><img src="/files/fnwez4eRI0FA2rhRjU78" alt=""><figcaption></figcaption></figure>

### 10-7. 이메일 운영 팁

> 📧 **첫 캠페인은 본인 이메일로 테스트 발송** 일괄 발송 다이얼로그에서 본인 이메일 응모자만 1명 선택해 한 번 발송해 보고 변수·디자인이 정상인지 확인하세요.

> 📧 **반송률이 높으면 메일 신뢰도가 떨어집니다** 잘못된 이메일 형식이 많으면 도메인 평판이 깎입니다. 응모자 추가 시 이메일 검증을 활성화하세요.

> 📧 **CS 이메일은 명확하게** 응모자가 답장할 때 받는 사람이 실제 운영하는 이메일이어야 합니다. 자동응답 또는 noreply는 피하세요.

> 📧 **발송 시점은 평일 오전·오후 권장** 늦은 저녁이나 주말은 도달률·열람률이 떨어지는 경향이 있습니다.

> 📧 **1,000명 이상 발송 시 시간이 걸립니다** 다이얼로그에 빨간 경고가 표시되며, 작업 큐에서 순차 처리됩니다. 발송 직후 화면을 닫아도 백그라운드에서 계속 진행됩니다.