본 문서는 기존의 채널별 수신거부 방식을 넘어, 비즈니스 목적에 따른 메세지 유형(인증, 안내, 결제 등)별로 수신거부를 정밀하게 제어하기 위한 설정 및 운영 방법을 안내합니다.
기존 시스템은 SMS, 알림톡 등의 채널이나 광고성(A)/정보성(I)이라는 대분류 기반의 수신거부만 지원했습니다.
메세지 유형별 수신거부는 고객사가 직접 정의한 서비스 유형 코드(예: 인증, 거래대금, 안내 등)를 기반으로 발송 단계에서 실시간 수신 거부 처리를 수행하는 고도화된 기능입니다.
고객사의 서비스 특성에 맞춰 관리할 메세지 유형과 코드를 매핑합니다.
MSGTYPE01MSGTYPE02MSGTYPE03정의된 코드를 시스템 인프라(UMS 및 UMSAgent)에 동일하게 등록해야 합니다.
발송 시 메세지 유형 정보(쉼표 구분)를 담을 파라미터를 지정합니다.
# 정의한 메세지 유형 코드 목록 (쉼표 구분)
UMS.PREVENT.MSGTYPECODE = MSGTYPE01, MSGTYPE02, MSGTYPE03
# 체크할 파라미터 선택 (SENDGROUPCODE, APP_ID, VAR1~VAR5 중 택 1)
# 아래 예시에서는 VAR5를 사용함
UMS.PREVENT.MSGTYPECODE.CHECKPARAM = VAR5
UMS 엔진과 동일한 정보를 세팅하여 발송 모듈에서 동기화되도록 합니다.
<MSGTYPE>
<CODES>MSGTYPE01, MSGTYPE02, MSGTYPE03</CODES>
<CHECKPARAM>VAR5</CHECKPARAM>
</MSGTYPE>
사용자가 앱이나 웹 서비스에서 특정 유형의 수신거부를 설정하면, 해당 정보를 시스템 (REDIS or DB)에 등록해야 합니다.
수신거부 설정으로 인해 발송이 차단된 경우, 아래와 같은 에러 결과가 반환됩니다.
설정 일치: UMS API와 UMSAgent의 설정값이 서로 다를 경우 정상적으로 필터링되지 않을 수 있습니다.
파라미터 전용 사용: 수신거부 체크용으로 지정한 파라미터(VAR1~5 등)는 다른 용도로 중복 사용하지 않을 것을 권장합니다.