SMTP 정보
SMTP 정보 화면은 관리자가 발신 이메일 서버 설정, 인증 정보, 기본 메시지 템플릿, 테스트 이메일 발송을 한 곳에서 관리할 수 있는 기능입니다.
회원가입 확인, 비밀번호 재설정, 회원 관리, 알림 메시지, 시스템 자동 이메일을 발송해야 할 때 사용합니다.
화면 개요
SMTP Information 화면은 크게 SMTP, Message, Send Test 세 가지 작업 영역으로 구성됩니다.
| 작업 영역 | 설명 |
|---|---|
| SMTP | 이메일 발송 방식과 이메일 제공자 설정을 관리합니다. |
| Message | 회원 관련 이메일의 기본 제목과 내용을 관리합니다. |
| Send Test | 현재 설정으로 실제 테스트 이메일을 발송해 정상 동작 여부를 확인합니다. |
SMTP Server Settings
SMTP Server Settings 영역은 시스템에서 이메일을 어떤 방식으로 발송할지 설정합니다. iBoard는 이 화면에 저장된 SMTP 정보를 사용할 수도 있고, SendGrid 같은 등록된 Communication Provider를 사용할 수도 있습니다.
Sending Method
Sending Method는 이 SMTP 설정에서 사용할 기본 발송 방식을 결정합니다.
| 방식 | 설명 |
|---|---|
| SMTP View Settings | 현재 화면에 저장된 SMTP 정보를 사용합니다. |
| Communication Provider | SendGrid 또는 등록된 다른 이메일 제공자를 사용합니다. |
Email Provider
Email Provider 항목은 Communication Provider 발송 방식을 사용할 때 어떤 등록 제공자를 사용할지 결정합니다.
Default가 선택된 경우 시스템 설정에 따라 SENDGRID_DEFAULT를 먼저 시도하고,
이후 첫 번째 활성 EMAIL Provider를 사용할 수 있습니다.
테스트 이메일을 보내기 전에 SMTP 서버 설정을 먼저 저장하세요.
Message Templates
Message Templates는 회원 관련 이메일의 기본 제목과 내용을 관리하는 영역입니다.
Template Options
| 옵션 | 설명 |
|---|---|
| Enabled | 이 메시지 템플릿 그룹을 사용할지 설정합니다. |
회원가입, 비밀번호 재설정, 회원 관리 이메일에 이 템플릿을 사용하려면 Enabled를 체크합니다.
Template Groups
Message 영역에는 여러 템플릿 그룹이 있습니다. 각 그룹은 특정 발신 이메일 유형을 담당합니다.
| 템플릿 그룹 | 목적 |
|---|---|
| Subscriber Confirmation | 구독 또는 메일링 리스트 등록을 확인하기 위해 보내는 메시지입니다. |
| Reset Password | 사용자가 비밀번호 재설정을 요청했을 때 보내는 메시지입니다. |
| Member Management | 회원 계정 관리와 관련된 이메일에 사용됩니다. |
Subject
Subject 항목은 이메일 제목을 설정합니다.
예:
Thank you for registering with us!
Email Body Editor
이메일 본문 편집기에서는 HTML 이메일 내용을 디자인할 수 있습니다. 텍스트 서식, 링크, 버튼, 이미지, 테이블, 정렬, HTML 편집 기능을 사용할 수 있습니다.
회원가입 확인 메시지, 비밀번호 재설정 안내, 회원 계정 알림 같은 전문적인 이메일 레이아웃을 만들 수 있습니다.
Sample
Sample 버튼은 선택한 템플릿의 샘플 메시지를 미리보기하거나 불러올 때 사용합니다.
템플릿 내용을 변경한 후에는 Save 버튼을 클릭해야 최신 이메일 메시지가 적용됩니다.
Send Test Email
Send Test Email 팝업은 현재 SMTP 설정을 사용해 실제 테스트 이메일을 발송하는 기능입니다. 서버 연결, 인증, Provider 연결, 이메일 본문 형식을 확인할 때 유용합니다.
Quick Delivery Test
Quick Delivery Test는 현재 SMTP 또는 Provider 설정으로 이메일을 정상 발송할 수 있는지 확인합니다.
| 항목 | 설명 |
|---|---|
| From | 발신자 이메일 주소입니다. |
| To | 테스트 이메일을 받을 수신자 주소입니다. |
| Subject | 테스트 이메일 제목입니다. |
| Body | 이메일 본문입니다. IsBodyHtml 설정에 따라 일반 텍스트 또는 HTML로 전송할 수 있습니다. |
| IsBodyHtml | 체크되어 있으면 본문을 HTML 이메일로 발송합니다. |
테스트 이메일 발송 방법
- Admin > Site > SMTP 메뉴로 이동합니다.
- 발송 방식을 선택합니다.
- 필요한 경우 Email Provider를 선택하거나 확인합니다.
- Save 버튼을 클릭해 설정을 저장합니다.
- Send Test를 클릭합니다.
- From, To, Subject, Body를 입력합니다.
- 본문에 HTML이 포함되어 있으면 IsBodyHtml을 체크합니다.
- Send 버튼을 클릭합니다.
- 수신자가 이메일을 받았는지 확인합니다.
권장 작업 순서
- SMTP 발송 방식 또는 Communication Provider를 설정합니다.
- SMTP 설정을 저장합니다.
- 테스트 이메일을 보내 발송 여부를 확인합니다.
- 시스템 기본 이메일 템플릿을 사용할 경우 Message Templates를 활성화합니다.
- Subscriber Confirmation, Reset Password, Member Management 템플릿을 수정합니다.
- 메시지 템플릿을 저장합니다.
- 회원가입 또는 비밀번호 재설정 흐름을 실제로 테스트합니다.
자주 사용하는 작업
| 작업 | 권장 방법 |
|---|---|
| SendGrid로 이메일 발송 | Communication Provider를 선택하고 활성화된 SendGrid Provider를 사용합니다. |
| 회원가입 확인 이메일 발송 | Message Templates를 활성화하고 Subscriber Confirmation 템플릿을 설정합니다. |
| 비밀번호 재설정 이메일 발송 | Reset Password 템플릿을 설정하고 비밀번호 재설정 흐름을 테스트합니다. |
| 이메일 발송 가능 여부 확인 | SMTP 설정을 저장한 후 Send Test Email을 사용합니다. |
| HTML 이메일 발송 | 편집기로 본문을 디자인하고 IsBodyHtml을 체크한 상태로 발송합니다. |
주의사항
- 테스트 이메일을 보내기 전에 반드시 SMTP 설정을 저장하세요.
- SendGrid 같은 Provider를 사용할 경우 인증된 발신자 주소를 사용하세요.
- 이메일 본문에 HTML이 포함되어 있으면 IsBodyHtml을 체크하세요.
- API Key, SMTP 비밀번호, Provider Secret 값을 이메일 템플릿에 노출하지 마세요.
- 템플릿 수정 후 회원가입과 비밀번호 재설정 이메일을 실제로 테스트하세요.
- 테스트 이메일이 오지 않으면 스팸함이나 정크 메일함도 확인하세요.
문제 해결
| 문제 | 가능한 원인 | 해결 방법 |
|---|---|---|
| 테스트 이메일이 발송되지 않음 | SMTP 설정이 저장되지 않았거나 Provider 설정이 잘못되었을 수 있습니다. | 설정을 저장한 뒤 Provider 설정과 인증 정보를 확인합니다. |
| 이메일을 받지 못함 | 메일이 차단되었거나 지연되었거나 스팸함으로 이동했을 수 있습니다. | 스팸함, Provider 로그, 수신자 주소를 확인합니다. |
| Unauthorized 또는 인증 오류 발생 | Provider API Key, SMTP 사용자명, 비밀번호, 발신자 인증이 잘못되었을 수 있습니다. | 인증 정보와 발신자 인증 설정을 확인합니다. |
| HTML이 일반 텍스트로 보임 | IsBodyHtml이 비활성화되어 있을 수 있습니다. | HTML 본문을 보낼 때는 IsBodyHtml을 체크합니다. |
| 템플릿 변경 내용이 반영되지 않음 | 템플릿을 저장하지 않았거나 템플릿 그룹이 비활성화되어 있을 수 있습니다. | 템플릿을 활성화하고 수정 후 Save 버튼을 클릭합니다. |
관리 권장 사항
- 시스템 이메일 전용 발신자 주소를 사용하는 것이 좋습니다.
- 이메일 템플릿은 단순하고 반응형이며 읽기 쉽게 만드세요.
- 데스크톱과 모바일 이메일 클라이언트에서 테스트하세요.
- 회원가입과 비밀번호 재설정 이메일에는 명확한 제목을 사용하세요.
- Provider 인증 정보는 안전하게 보관하세요.
- 문제 해결 시 Provider 발송 로그를 확인하세요.
SMTP 설정은 회원가입 확인, 비밀번호 재설정 같은 중요한 시스템 이메일에 영향을 줍니다. 신중하게 설정하고 변경 후에는 반드시 테스트 발송을 진행하세요.