Skip to content

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, 재시도 횟수, 후속 메일 게이트웨이 추적을 함께 봅니다.