UMS_MSG | Notion

문자, RCS, 카카오톡, PUSH를 동일한 스키마로 발송할 수 있는 통합테이블입니다.

또한 미리 설정한 채널 순서에 맞춰 발송하는 통합발송 시에도 이 테이블로 발송할 수 있으나,

통합 템플릿을 통한 발송은 템플릿 발송 테이블인 KV_MSG 테이블 사용을 권장합니다.

발송이 완료되면 msg_status가 complete으로 변경되고 로그 테이블로 이관되며,

로그테이블(UMS_LOG_YYYYMM)의 스키마도 발송테이블과 동일합니다.

<aside> 💡 **스키마 변경 사항 안내

(구) 허브 에이전트를 사용하시던 고객의 경우 UMS_MSG 테이블의 일부 컬럼이 변경/추가 되었으니, 아래 내용을 반드시 확인하시기 바랍니다. (”▶” 화살표 클릭)**

컬럼 사이즈 변경
컬럼 추가
컬럼명 변경
컬럼 제거 </aside>

컬럼명	타입	길이	NULL
CLIENT_KEY	VARCHAR	40	NOT
NULL	메시지 고유 번호
직접 고유 번호를 생성하여 입력
ex) datetime + business name + random string	영문, 숫자만 허용됩니다.
REQ_CH
← ~~REQ_PRODUCT~~	VARCHAR	10	NOT
NULL	발송 채널

문자 : SMS, MMS
글로벌 SMS : GDS
RCS : RCS
카카오톡 : ALIMTALK, FRIENDTALK
PUSH : PUSH
템플릿(통합) 발송 : UMS | | | TRAFFIC_TYPE | VARCHAR | 10 | | 메시지 유형
normal : 일반 (default)
real : 실시간/중요
batch : 마케팅, 광고 | 우선순위 real > normal > batch | | MSG_STATUS | VARCHAR | 10 | NOT NULL | 발송 상태
ready : 발송 대기 (insert 상태 값)
request : 발송 완료
complete : 결과 수신 완료
pre-send : select 완료
pre-image : 이미지 등록 작업 중 | | | REQ_DATE | datetime | | NOT NULL | 발송 요청 시간 미래 시간으로 입력 시, 예약 발송됨 | | | CALLBACK_NUMBER | VARCHAR | 16 | NOT NULL | 발신번호 문자나 RCS 발송 시 필수 입력 | | | KISA_ORIGCODE

재판매사의 경우 필수 입력, 일반 고객은 공란 |  |
| CAMPAIGN_ID | VARCHAR | 20 |  | **캠페인 ID** 
메시지 허브에서 캠페인 단위 통계내기위해 사용 | 영문, 숫자, 하이픈(-), 언더바(_) 포함 20자리까지 허용 |
| DEPT_CODE | VARCHAR | 20 |  | **부서코드** 
부서별 빌링이 필요한 경우 사용 |  |
| PHONE | VARCHAR | 16 |  | **수신번호** |  |
| MSG | VARCHAR | 2000 |  | **전송할 메시지 내용**
가변 데이터 입력 시 #{NAME} 로 입력  |  |
| TITLE | VARCHAR | 100 |  | **제목** 
LMS/MMS/RCS/ALIMTALK/PUSH
발송 시 사용 |  |
| TEMPLATE_CODE | VARCHAR | 20 |  | **메시지허브 템플릿 키**
허브 사용자 콘솔에 등록한 통합발송 템플릿 키 |  |
| MERGE_DATA | VARCHAR | 2000 |  | **가변 데이터** 
ex) { "NAME" : "홍길동", "SHOP" : "이마트 용산" } |  |
| FILE_DATA | VARCHAR | 1000 |  | **템플릿 이미지 변경 발송 데이터**
”서비스명 . 변경할 이미지 번호 . 이미지 첨부 방식(.친구톡 이미지 Wide 여부)” key 와 값으로 이루어진 데이터
ex) {”rcs.1.path”:”pokemon.jpg”, “friendtalk.1.url.y”:”<https://msghub.uplus.co.kr/image/digimon.jpg”>} |  |
| MMS_FILE_LIST
← ~~FILE_LIST~~ | VARCHAR | 450
~~600~~ |  | **MMS 파일**
”,”로 구분하여 3개 까지 입력 가능 | 절대 경로/상대 경로/
URL/메시지허브 파일 ID |
| FB_CH
← ~~FB_PRODUCT~~ | VARCHAR | 10 |  | **fallback 발송할 채널**
SMS/LMS/MMS 만 가능 |  |
| FB_MSG | VARCHAR | 4000 |  | **fallback 메시지 내용** |  |
| FB_TITLE | VARCHAR | 100 |  | **fallback 메시지 제목** |  |
| FB_FILE_LIST
← ~~FB_FILE_ID~~ | VARCHAR | 450
~~60~~ |  | **fallback MMS 파일**
”,”로 구분하여 3개 까지 입력 가능 | 절대 경로/상대 경로/
URL/메시지허브 파일 ID |
| RCS_MSGBASE_ID | VARCHAR | 40 |  | **RCS 메시지베이스 ID**  |  |
| RCS_HEADER | VARCHAR | 1 |  | **RCS 메시지 유형**
- ~~info~~ → 0 : 정보성 메시지
- ~~ad~~   → 1 : 광고성 메시지 | 기존 입력 값에서 0,1로 변경됨 |
| RCS_FOOTER | VARCHAR | 16 |  | **무료수신거부번호**
 | header의 값이 광고성일 때 footer 값을 포함하지 않고 발송하면 실패 처리 |
| RCS_COPY_ALLOWED | VARCHAR | 1 |  | **RCS 메시지 복사/공유 허용 여부**
- Y : 허용 (default)
- N : 미허용 기본값 |  |
| RCS_EXPIRY_OPTION | VARCHAR | 1 |  | **발송 타임아웃 시간 옵션**
해당 시간만큼 발송 시도 및 결과 대기
****- 1 : 72시간
- 2 : 30초
- 3 : 3분
- 4 : 1시간  |  |
| RCS_AGENCY_ID | VARCHAR | 20 |  | **대행사 ID**
ex) lguplus |  |
| RCS_AGENCY_KEY | VARCHAR | 20 |  | **대행사 인증 Key**
입력하는 agencyId가 대행사의 것일 경우,
해당 대행사의 agencyKey를 함께 전송해야 함 | RCS 메시지 보안 인증 강화 항목 |
| RCS_BRAND_KEY | VARCHAR | 20 |  | **발신자 인증 Key**
기업에서 생성한 브랜드마다 부여되는 Key로,
메시지 전송 시 발신번호가 속한 브랜드의 Key를 함께 전송해야 함 | RCS 메시지 보안 인증 강화 항목 |
| RCS_BUTTON | VARCHAR | 1000 |  | **RCS 버튼 Object array** |  |
| KAKAO_CH_ID
← ~~KAKAO_SENDER_KEY~~ | VARCHAR | 65 |  | **카카오톡 채널 아이디** |  |
| KAKAO_TEMPLATE_CODE
← ~~KAKAO_TEMPLATE_KEY~~ | VARCHAR | 20 |  | **알림톡, 친구톡 템플릿 코드** |  |
| KAKAP_BUTTON | VARCHAR | 1000 |  | **카카오 버튼 Object** |  |
| KAKAO_IMAGE_WIDE_YN | VARCHAR | 1 |  | **친구톡 와이드 이미지 여부(Y/N)** |  |
| KAKAO_IMAGE_URL | VARCHAR | 150
~~200~~ |  | **친구톡 이미지 URL** |  |
| KAKAO_IMAGE_LINK | VARCHAR | 150
~~200~~ |  | **친구톡 이미지 링크** |  |
| KAKAO_FILE
← ~~KAKAO_FILE_ID~~ | VARCHAR | 150
~~20~~ |  | **친구톡 이미지 파일** | 절대 경로/상대 경로/
URL/메시지허브 파일 ID |
| KAKAO_AD_FLAG | VARCHAR | 1 |  | **광고 표기 여부(Y/N)** |  |
| KAKAO_GROUP_KEY | VARCHAR | 100
~~200~~ |  | 알림톡 그룹 발송용 kEY |  |
| PUSH_APP_ID | VARCHAR | 255 |  | **앱 아이디**
메시지허브 관리자 콘솔에 등록한 APP ID |  |
| PUSH_PROVIDER | VARCHAR | 20 |  | **PUSH 공급자**
- FCM : 구글
- APNS : 애플 |  |
| PUSH_APP_USER_ID | VARCHAR | 20 |  | **앱 사용자 아이디**
해당 앱을 설치하여 사용하는 사용자 ID |  |
| PUSH_FILE
← ~~PUSH_FILE_ID~~ | VARCHAR | 150
~~20~~ |  | **PUSH 이미지 파일** | 절대 경로/상대 경로/
URL/메시지허브 파일 ID |
| PUSH_EXT | VARCHAR | 1000 |  | **확장 커스텀 메시지**
이미지 푸시를 위한 URL 또는 앱 상세페이지를 꾸밀 데이타 정보 URL(json) |  |
| ROUTE_INFO
← ~~API_KEY~~ | VARCHAR | 20 |  | **발송된 세션 ID/ API Key**
연동된 여러 세션 중, 실제 발송된 세션 |  |
| SENT_DATE | datetime |  |  | **발송 요청 시간** 
Agent가 메시지허브 G/W 로 발송한 시간 | agent에서 업데이트하는 항목 |
| DONE_CH | VARCHAR | 10 |  | **발송 성공한 채널** | agent에서 업데이트하는 항목 |
| DONE_PRODUCT | VARCHAR | 10 |  | **발송 성공한 상품 종류** | agent에서 업데이트하는 항목 |
| DONE_DATE | datetime |  |  | **단말 전달 시간 or 실패 최종 시간**  | agent에서 업데이트하는 항목 |
| DONE_CODE | VARCHAR | 10 |  | **처리 결과 코드** | agent에서 업데이트하는 항목 |
| DONE_CODE_DESC | VARCHAR | 200 |  | **처리 결과 상세** | agent에서 업데이트하는 항목 |
| DONE_FB_DETAIL | VARCHAR | 1000 |  | **fallback 발송 처리 상세**
첫 번째 채널이 발송 실패하고, 다음 채널이 발송될 경우 첫 번째 채널의 실패 코드 및 설명 표기 | agent에서 업데이트하는 항목 |
| DONE_TELCO | VARCHAR | 10 |  | **이통사 정보**
문자 및 RCS발송 성공의 경우 이통사 코드 업데이트 | agent에서 업데이트하는 항목 |
| ETC1 | VARCHAR | 50 |  | **기타**
고객사 예비 필드1 |  |
| ETC2 | VARCHAR | 50 |  | **기타**
고객사 예비 필드2 |  |
| ETC3 | VARCHAR | 50 |  | **기타**
고객사 예비 필드3 |  |
| ETC4 | VARCHAR | 50 |  | **기타**
고객사 예비 필드4 |  |
| ETC5 | VARCHAR | 50 |  | **기타**
고객사 예비 필드5 |  |
| ETC6 | VARCHAR | 50 |  | **기타**
고객사 예비 필드6 |  |
|  |  |  |  |  |  |

※ TRAFFIC_TYPE 에 대한 설명

- 실시간 : 인증, 카드승인, 긴급공지/장애 등 지연발송이 거의 없어야 하는 경우
- 일반 : 일반적으로 수초 이내 발송되면 문제없는 경우
- 배치 : 광고/이벤트 안내/공지 등 지연이 일부 있더라도 대량의 메시지를 발송해야 하는 경우