> 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 · 이메일 캠페인
응모자에게 발송되는 메일은 **자동 발송**(응모 직후·선정 직후 등)과 **수동 일괄 발송**(운영자가 시점을 정해 보냄) 두 가지가 함께 작동합니다. 마감 임박 시 자동으로 미제출자에게 보내는 **리마인더** 기능도 있습니다.
### 10-1. 이메일 시스템의 두 진입점
이메일 관련 화면은 **두 곳**에 분산되어 있습니다. 어느 쪽으로 들어가느냐에 따라 가능한 작업이 다르므로 먼저 이 구조부터 익혀두면 좋습니다.
| 진입점 | 위치 | 가능한 작업 | 대상 범위 |
| ------------------- | --------------------------------------------------------- | ------------------------------------------ | ------------- |
| **A. 이메일 발송 내역 패널** | 폼 이벤트 상세 페이지 안 | 이 캠페인의 일괄 발송, 작업 진행 추적, 재시도 | **이 캠페인 1개** |
| **B. 메일 관리 페이지** | 좌측 메뉴 **고객·메시지 > 이메일 관리** (`/dashboard/email-management`) | 멀티 캠페인 동시 발송, **자동 리마인더 설정**, 템플릿 라이브러리 관리 | **여러 캠페인 동시** |
> 💡 **선택 가이드** 한 캠페인의 응모자에게만 보낼 때 → **A. 이벤트 상세** 시즌 캠페인 여러 개에 일제히 보내거나 자동 리마인더를 켜려면 → **B. 메일 관리 페이지**
### 10-2. 6가지 이메일 템플릿
| 한국어 라벨 | 자동 발송 시점 |
| ------------- | ----------------------------- |
| **신청 안내** | 응모 직후 자동 발송 |
| **선정 안내** | 응모자 선정 처리 시 |
| **미선정 안내** | 응모자 미선정 처리 시 (운영자가 입력한 사유 포함) |
| **배송 안내** | 배송 정보 입력 시 |
| **콘텐츠 제출 안내** | 콘텐츠 제출 요청 시 (자동 리마인더 대상) |
| **이슈 공지** | 운영자 수동 발송 (배송 지연 사과 등) |
\
🟡 **자동 리마인더 대상 템플릿** 자동 리마인더 기능은 현재 **콘텐츠 제출 안내** 템플릿에만 적용됩니다 (10-6 참고).
### 10-3. 템플릿 편집 — 템플릿 라이브러리
템플릿의 제목·본문을 편집하려면 **메일 관리 페이지** 우상단의 **\[템플릿 관리]** 버튼을 클릭합니다.
각 템플릿은 다음을 가집니다.
* **제목 (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. 메일 관리 페이지의 멀티 캠페인 발송
좌측 메뉴 **이메일 관리** 페이지에서는 **여러 폼 이벤트를 한꺼번에** 골라 일괄 발송할 수 있습니다.
#### 10-4-1. 페이지 헤더
| 영역 | 내용 |
| --------- | ----------------------------------------------------------------------- |
| 좌상단 제목 | **메일 관리** + "폼이벤트별 이메일 발송 현황을 관리하고 일괄 발송합니다." |
| 우상단 액션 | **가이드** 드롭다운 / **\[템플릿 관리]** / **\[일괄 발송 (N)]** / **상태 필터** (전체·진행중·종료) |
| 확인 필요 스트립 | 미발송·배송불가 건수가 있을 때만 노란 배경으로 노출 |
#### 10-4-2. 이벤트 목록 표 — 10개 컬럼
| 컬럼 | 의미 |
| --------- | --------------------------- |
| 체크박스 | 일괄 발송용 다중 선택 |
| **이벤트명** | 클릭 시 폼 이벤트 상세로 이동 |
| **선정** | 선정자 수 |
| **발송** | 운송장 등록된 응모자 수 (초록 배지) |
| **미발송** | 운송장 미등록 응모자 수 (노랑 배지) |
| **배송불가** | Undeliverable 응모자 수 (빨간 배지) |
| **최근발송일** | 직전 리마인더 자동 발송 시각 |
| **리마인더** | 다음 예정 시각 + 활성/비활성 스위치 |
| **자동 종료** | 리마인더 자동 종료 일정 + 연장 팝오버 |
| **마감일** | 응모 종료일 (종료된 캠페인은 "종료" 표시) |
#### 10-4-3. 멀티 캠페인 일괄 발송 흐름
1. 표에서 발송할 캠페인을 **체크박스로 다중 선택**
2. 우상단 **\[일괄 발송 (N)]** 버튼 클릭 (N=선택 카운트)
3. 다이얼로그에서 템플릿·옵션 설정 후 발송
4. **자동 리마인더 옵션**도 이 다이얼로그에서 함께 설정 가능 (콘텐츠 제출 안내 템플릿 선택 시)
### 10-5. 자동 리마인더 — 메일 관리 페이지에서만
마감 임박 시 응모자에게 자동으로 리마인더 메일을 보내는 기능입니다. **콘텐츠 제출 안내** 발송에 가장 많이 활용됩니다.
#### 10-5-1. 설정 위치
자동 리마인더는 **메일 관리 페이지의 이벤트 목록 표 — 리마인더 컬럼**에서 직접 토글합니다 (폼 이벤트 상세 페이지에는 별도 진입점이 없습니다).
| 표시 | 의미 |
| -------------------- | ----------------------- |
| **다음 예정 시각** (초록 글씨) | 다음 자동 발송 예정 시각 |
| **대기중** (회색) | 활성화돼 있지만 다음 시각이 계산되지 않음 |
| **Off** (회색) | 자동 리마인더 비활성 |
| **스위치** | 활성/비활성 즉시 토글 |
#### 10-5-2. 리마인더 시작·간격 설정 — 일괄 발송 다이얼로그에서
리마인더의 **시작 시점·간격**은 **메일 관리 페이지 > \[일괄 발송] 다이얼로그**에서 콘텐츠 제출 안내 템플릿을 선택할 때 함께 설정합니다.
| 항목 | 의미 |
| ------------------ | -------------------------------- |
| **자동 리마인더 활성화** 토글 | 리마인더 사용 여부 |
| **간격 (N일)** | 며칠 간격으로 미제출자에게 다시 보낼지 (예: 3일 간격) |
| **자동 종료일** | 리마인더가 멈출 시점 (보통 콘텐츠 제출 마감일) |
#### 10-5-3. 자동 종료 연장
이벤트 마감일을 미루면 리마인더 자동 종료일도 함께 미뤄야 합니다. 표의 **자동 종료** 컬럼에 있는 **연장 팝오버**(Calendar 아이콘)에서 새 종료일을 선택하면 됩니다.
### 10-6. 응모자별 이메일 발송 이력
특정 응모자에게 어떤 메일이 언제 보내졌는지 추적하려면 **응모자 상세 다이얼로그**(Part 7-4 참고)를 엽니다.
선정 상태 응모자의 다이얼로그 본문에 **이메일 발송 이력 영역**이 자동으로 표시됩니다.
| 표시 | 내용 |
| -------------------- | -------------------- |
| 발송된 템플릿 | 신청 안내 / 선정 안내 등 |
| 발송 시각 | 일시 |
| 도달 상태 | 전달 / 반송 / 스팸 신고 / 차단 |
| (디버깅용) 메일 서비스 메시지 ID | AWS SES 등의 ID |
### 10-7. 이메일 운영 팁
> 📧 **첫 캠페인은 본인 이메일로 테스트 발송** 일괄 발송 다이얼로그에서 본인 이메일 응모자만 1명 선택해 한 번 발송해 보고 변수·디자인이 정상인지 확인하세요.
> 📧 **반송률이 높으면 메일 신뢰도가 떨어집니다** 잘못된 이메일 형식이 많으면 도메인 평판이 깎입니다. 응모자 추가 시 이메일 검증을 활성화하세요.
> 📧 **CS 이메일은 명확하게** 응모자가 답장할 때 받는 사람이 실제 운영하는 이메일이어야 합니다. 자동응답 또는 noreply는 피하세요.
> 📧 **발송 시점은 평일 오전·오후 권장** 늦은 저녁이나 주말은 도달률·열람률이 떨어지는 경향이 있습니다.
> 📧 **1,000명 이상 발송 시 시간이 걸립니다** 다이얼로그에 빨간 경고가 표시되며, 작업 큐에서 순차 처리됩니다. 발송 직후 화면을 닫아도 백그라운드에서 계속 진행됩니다.
---
# 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/form-events/undefined-9.md?ask=&goal=
```
`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.