앱 푸시(FCM, APNS) 발송 시, 대상자별 발송 메시지 내용을 전용 테이블(T_UMS_PUSH_MSGBOX)에 저장하는 기능입니다.
이 데이터는 실제 발송 성공 여부와 관계없이 저장되며, 모바일 앱 내 '메시지함' 또는 '알림 센터' API를 구현하기 위한 원천 데이터로 활용됩니다.
SUCC_STATUS 컬럼 값이 실시간으로 업데이트됩니다.
0: 발송 요청1: 발송 성공2: 수신 확인 (App Receipt)3: 읽음 확인 (Open Event)푸시 메시지 박스 기능을 활성화하기 위해 엔진 설정 파일을 수정합니다.
파일 경로: conf/common.properties
############################################################
# 푸시 메시지함 설정
############################################################
# 푸시 메시지함 사용 여부
# - Y: 사용 (T_UMS_PUSH_MSGBOX 테이블에 데이터 적재)
# - N: 미사용 (기본값)
PUSH.MSGBOX.YN = Y
Agent의 pushFailWatcher 설정을 통해 메시지 박스 사용 여부 및 발송 감시 프로세스의 세부 성능을 제어합니다.
파일 경로: conf/config.xml
<pushFailWatcher>
<!-- 1. 푸시 실패 감시 프로세스 사용 여부 (Y/N) -->
<useYN>Y</useYN>
<!-- 2. 프로세스 처리를 위한 스레드 개수 -->
<ThreadCnt>10</ThreadCnt>
<!-- 3. DB 감시 주기 (Millisecond 단위, 1000 = 1초) -->
<dbWatchMiliTime>1000</dbWatchMiliTime>
<!-- 4. 메모리 내 최대 큐(Queue) 사이즈 -->
<maxQueueSize>10000</maxQueueSize>
<!-- 5. 1회 DB 조회 시 가져올 데이터 건수 (Fetch Size) -->
<fetchCnt>500</fetchCnt>
<!-- 6. 발송 메시지 만료 시간 설정 (분 단위) -->
<expireSendMsgMinute>90</expireSendMsgMinute>
<!-- 7. APNS 응답 타임아웃 시 재전송 처리 여부 -->
<apns_rev_timeout_send>Y</apns_rev_timeout_send>
<!-- 8. 푸시 메시지 박스 적재 여부 설정 (핵심) -->
<!-- Y: T_UMS_PUSH_MSGBOX 테이블에 데이터 저장 활성화 -->
<usePushMsgBox>Y</usePushMsgBox>
</pushFailWatcher>
T_UMS_PUSH_MSGBOX 테이블에는 실제 단말기 도달 여부와 관계없이 발송 요청 시점에 데이터가 생성됩니다. 이는 사용자가 앱을 실행했을 때 언제든 이전 알림 이력을 확인할 수 있는 원천 데이터가 됩니다.PUSH.MSGBOX.YN 설정과 Agent의 <usePushMsgBox> 설정이 모두 Y로 일치해야 데이터 유실 없이 정상적인 메시지함 서비스 운영이 가능합니다.