이메일
이메일 채널 소개
블럭스에서는 발신 이메일 프로필(등록·인증된 도메인과 발신 주소)을 선택하고, 제목·본문을 작성해 캠페인·시나리오 메일을 발송할 수 있습니다.
사전 준비
발신에 사용할 도메인 DNS 인증과 콘솔의 이메일 발신 프로필 등록이 필요합니다.
자세한 절차는 [시작하기 > 계정 세팅하기 > 이메일]를 참고해 주세요.
발신 프로필
메시지마다 어떤 발신 프로필로 보낼지 라디오 버튼으로 선택합니다. 선택지는 애플리케이션에 등록된 email_profiles 목록과 동일합니다.
프로필에 포함된 발신 주소·발신자 표시 이름이 실제 수신 메일의 From 정보로 사용됩니다. 프로필이 없거나 선택하지 않으면 검증 오류가 발생할 수 있습니다.
제목 · 광고 여부
- 제목은 Liquid 문법을 지원하며, 최대 998자까지 입력할 수 있습니다.
- 광고 여부를 켜면 제목 앞에
(광고)가 자동으로 붙거나 제거됩니다. - 광고 여부가 켜진 메일은 저장 시 제목이 반드시
(광고)로 시작해야 합니다. (콘솔 검증 메시지: 광고성 메일은 제목이(광고)로 시작해야 해요)
본문 작성 (기본 · 코드 에디터)
본문은 두 가지 방식으로 작성할 수 있습니다.
| 탭 | 설명 |
|---|---|
| 기본 | 여러 줄 텍스트 입력(LiquidTextArea). 단순 안내·플레인 텍스트에 적합합니다. |
| 코드 에디터 | HTML을 포함한 본문을 Monaco 에디터로 작성(LiquidHtmlEditor). |
기존 본문에 HTML 태그 패턴이 있으면 초기 탭이 코드 에디터 쪽으로 맞춰집니다.
본문 길이 상한은 스키마상 별도 최대 길이 제한이 없습니다. 다만 과도하게 큰 HTML은 수신 클라이언트·발송 제약에 따라 문제가 될 수 있으니, 실제 발송 테스트로 확인하는 것을 권장합니다.
미리보기 영역은 본문에 HTML 태그가 감지되면 iframe 으로 렌더링하고, 그렇지 않으면 단순 블록으로 표시합니다.
광고성 이메일 · 마케팅 동의
광고성 이메일 발송 시 마케팅 수신 동의 필드 두 개가 모두 필요합니다.
광고 여부가 켜진 메시지는 다음 두 필드가 모두 true 인 유저에게만 발송됩니다.
| 필드 | 설명 |
|---|---|
marketing_notification_consent | 전체 마케팅 수신 동의 |
marketing_notification_email_consent | 이메일 채널 마케팅 수신 동의 (email_consent 값으로 대체 가능) |
또한 정보통신망법 등에 따라 수신 거부 방법(예: 수신거부 링크 또는 고객센터 안내)을 본문에 포함하는 것은 발송 정책·법무 검토 후 반영해 주세요.
개인화 변수
제목·본문 모두 {{ 변수명 }} 형태의 Liquid를 사용합니다. 알림톡의 #{...} 와는 다릅니다.
콘솔의 개인화 안내 버튼으로 변수를 삽입하거나, [개인화 변수]를 참고해 주세요.
발송 전 체크리스트
이메일 발송 전 확인해 주세요.
- 발신 프로필(도메인·발신 주소) 선택
- 제목 998자 이내, Liquid 문법 오류 없음
- 광고성인 경우 제목
(광고)시작 및 본문 내 수신거부 등 법적 안내 반영 - 광고성인 경우
marketing_notification_consent,marketing_notification_email_consent(또는email_consent) 연동 - HTML 사용 시 주요 클라이언트에서 미리보기·테스트 발송 확인
Freemarker 템플릿 타입은 무엇인가요?
데이터 모델에는 templateType 이 default 와 freemarker 가 구분되어 있으나, 현재 콘솔 UI에서는 기본값(default) 위주로 동작합니다. API·연동에서 별도 템플릿 타입을 쓰는 경우 개발 문서를 확인해 주세요.
제목만 광고 표기하면 되나요?
콘솔 검증은 광고 여부 ON 시 제목의 (광고) 시작을 요구합니다. 운영 정책상 본문 내 광고 표기·수신거부 안내가 추가로 필요할 수 있으니 내부 가이드에 맞춰 주세요.