알림메시지

알림메시지는 쇼핑몰에서 특정 업무를 수행한 후 처리 완료를 안내하거나 쇼핑몰의 정보를 고객에게 전달하는 중요한 기능을 제공합니다. 다양한 알림메시지 종류 중 알림톡, SMS/LMS, 알림함을 활용하여 고객과의 효율적인 소통을 지원합니다.

주요 기능

다양한 알림메시지 유형
- 알림톡, SMS/LMS, 알림함과 같은 다양한 알림메시지 유형을 제공합니다.
- 각각의 유형은 특정 상황에 적합하게 사용됩니다.
알림메시지 전송 API
- 타 모듈에서 알림메시지 전송 시 템플릿ID를 활용하여 알림톡, SMS/LMS, 알림함을 선택하고 전송할 수 있습니다.
- 간편한 API 호출을 통해 유연한 알림메시지 전송이 가능합니다.
템플릿 등록 관리
- 관리자 페이지에서 알림메시지의 템플릿을 등록하고 관리할 수 있습니다.
- 등록된 템플릿을 활용하여 일관된 알림메시지를 제공합니다.
긴 메시지 처리(LMS)
- SMS 발송 시 템플릿 내용이 90바이트를 초과하면 자동으로 LMS로 전송되어 메시지 내용을 보다 자세히 전달할 수 있습니다.

번호

구분

설명

1

알림메시지 다건 전송

알림메세지를 알림메세지 종류에 상관없이 다건 전송할 수 있습니다.

2

알림메시지 단건 전송

알림메세지를 전송합니다.

템플릿 정보 데이터베이스에서 템플릿을 조회합니다. 템플릿은 현재 사용 중인 상태여야 합니다.
템플릿 변수가 공통코드(ST010)의 코드와 맞는 게 있으면 매핑합니다.
템플릿의 기본알림방법코드가 공통코드(CH009)에 맞는 Sender 를 선택합니다.
알림메세지를 전송합니다.
- 템플릿 내용 변수에 넘어온 요청 파라미터로 템플릿 내용을 치환합니다.
- 템플릿 정보에 버튼 정보가 존재하면 버튼 내용을 치환합니다.
- 알림톡/SMS/LMS 전송 시 x2bee-common 을 호출하고, 알림함은 x2bee-member 를 호출합니다.

API	설명	Server	메소드	비고
알림메시지 다건 전송	알림메시지 유형 구분 없이 알림메시지를 다건 전송합니다.	Common	POST
알림메시지 단건 전송	알림메시지를 단건 전송합니다.	Common	POST

명칭	설명	비고
SMS(Short Message Service)	이동통신사에서 제공하는 문자 메시지 전송 서비스 중 하나입니다. 한글 기준 약 40자 정도 발송 가능합니다.
LMS(Long Message Service)	이동통신사에서 제공하는 문자 메시지 전송 서비스 중 하나입니다. 한글 기준 약 500자 정도 발송 가능합니다.
알림톡	기업 고객이 사용자에게 정보성 카카오톡 메시지를 발송하는 서비스입니다.

•타 모듈에서 알림메세지 전송 api 를 호출 시 x2bee-common 공통의 MessageCommonDto 를 상속받아 필수 값을 넣어서 호출해야 합니다.
- 알림톡 필수 값: 템플릿ID, 수신번호
- SMS/LMS 필수 값: 템플릿ID, 수신번호
- 알림함 필수 값: 템플릿ID, 회원번호
넘어온 템플릿ID에 맞는 사용 중인 템플릿이 존재해야 전송 가능합니다.
공통코드 ST010(사이트기타정보) 에 해당하는 코드 값이 템플릿 내용의 변수에 존재할 시 자동으로 매핑합니다. (요청 파라미터에 넣을 필요 X)
템플릿 정보의 기본알림방법코드와 맞는 공통코드 CH009(기본알림방법코드) 에 해당하는 방식으로 메시지를 전송합니다.
X2bee-common 프로젝트를 호출해 요청 파라미터 DTO 를 템플릿 내용에 매핑합니다.
알림톡, SMS/LMS 전송 시 x2bee-common 프로젝트를 호출하고, 알림함 등록 시 x2bee-member 프로젝트를 호출합니다.
알림톡, SMS/LMS 전송 시 전송 정보를 저장하고 싶으면 참조 값1~5 (ref1Val ~ ref5Val) 에 데이터를 넣으면 가능합니다.
알림톡, SMS/LMS 전송 후 각 ST_NAVER_TMS_SND_HIST, ST_NAVER_SMS_SND_HIST 테이블에서 이력을 확인할 수 있습니다.