Email 채널 플러그인
Email 채널 플러그인은 Core가 렌더링한 알림 메시지를 SMTP로 전송하는 alert_deliver 플러그인입니다. 알림 의미, 규칙 평가, 수신자 선택은 Core가 담당하고, 이 플러그인은 SMTP 전송 검증과 전송을 담당합니다.
특징
- STARTTLS, TLS, plain SMTP 연결 모드를 지원합니다.
- Core가 렌더링한 제목/본문을 언어별로 선택해 전송합니다.
- 수신자 프로필 언어와 커넥터 대체 언어를 반영합니다.
- 제한 시간, 재시도 횟수, 백오프를 제한하고 일시적 SMTP 실패만 재시도합니다.
등록 전 확인
- SMTP 호스트, 포트, 발신자 주소, 보안 모드, 사용자 이름/비밀번호를 준비합니다.
- 테스트 수신자를 설정하면 연결 테스트와 실제 테스트 메시지 단계를 구분해 확인할 수 있습니다.
- 메일 서버 정책상 발신자, relay, TLS, 인증 제한이 있는지 먼저 확인합니다.
운영 팁
- 비밀번호와 SMTP 인증 정보는 로그나 작업 응답에 노출되지 않아야 합니다.
- 안정적인 Message-ID와 진단 헤더는 후속 메일 추적에 활용할 수 있습니다.
- 수신자 라우팅은 커넥터 설정이 아니라 Core 알림 경로와 전송 페이로드에서 결정됩니다.
운영 화면
- 채널 설정은 SMTP 엔드포인트, 보안 모드, 발신자, 인증, 제한 시간/재시도 정책을 전송 단위로 관리합니다.
- Email은 별도 채널 화면을 제공하지 않습니다. 초안 진단은 등록/수정 폼과 테스트 결과 상세에서 확인합니다.
- 폼 보조 정보는 메일을 보내지 않고 렌더링된 제목/본문, 수신자 파싱, TLS/인증 요약, 재시도 일정을 미리 보여줍니다.
- 연결 테스트는 단순 설정 검증과 실제 테스트 메시지 전송을 구분해 운영자가 메일 서버 정책 문제를 좁힐 수 있게 합니다.
- 전송 결과는 Core 전송 세션과 연결되어 성공/실패, 재시도 가능 여부, 후속 SMTP 응답을 확인하는 근거가 됩니다.
전달 방식과 제한
- 이 플러그인은 Core가 이미 렌더링한 제목과 본문을 SMTP 봉투로 전달합니다.
- 수신자 프로필 언어가 있으면 언어별 렌더링 메시지를 선택하고, 없으면 채널 대체 언어를 사용합니다.
- 일시적 SMTP 오류만 제한적으로 재시도하고, 인증 실패나 잘못된 주소처럼 즉시 수정이 필요한 오류는 반복 재시도하지 않는 것이 맞습니다.
- 첨부 파일, 대량 메일 캠페인, 메일링 리스트 관리는 알림 채널 범위가 아닙니다.
대표 시나리오
- 알림 메일이 도착하지 않으면 Core 전송 세션, SMTP 인증, relay 허용 정책, TLS 모드, 수신 서버 거부 사유를 순서대로 확인합니다.
- 폼 미리보기는 정상인데 전송이 실패하면 먼저 연결 테스트를 실행하고, 이후
test_recipient를 설정해 전송 테스트를 실행합니다. - 다국어 메시지가 기대와 다르면 수신자 언어, 알림 언어, 대체 언어를 확인합니다.
- 중복 메일이 의심되면 Message-ID, 전송 세션 ID, 재시도 횟수, 후속 메일 게이트웨이 추적을 함께 봅니다.