문자, RCS, 카카오톡, PUSH를 동일한 스키마로 발송할 수 있는 통합테이블입니다.
또한 미리 설정한 채널 순서에 맞춰 발송하는 통합발송 시에도 이 테이블을 사용하여 발송합니다.
발송이 완료되면 msg_status가 complete으로 변경되고 로그 테이블로 이관되며,
로그테이블(UMS_LOG_YYYYMM)의 스키마도 발송테이블과 동일합니다.
컬럼명 |
타입 |
길이 |
NULL |
설명 |
비고 |
client_key |
VARCHAR |
40 |
NOT |
|
|
NULL |
메시지 고유 번호 |
|
|
|
|
직접 고유 번호를 생성하여 입력 |
|
|
|
|
|
ex) datetime + business name + random string |
영문, 숫자만 허용됩니다. |
|
|
|
|
req_product |
VARCHAR |
10 |
NOT |
|
|
NULL |
발송 상품 |
|
|
|
|
- 문자 : SMS, LMS, MMS
- 글로벌 SMS : SMS_GLOBAL
- RCS : RCS
- 카카오톡 : KKO_NOTI (알림톡), KKO_FRIEND (친구톡)
- PUSH : PUSH | |
| 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 | 발송 요청 시간
미래 시간으로 입력 시, 예약 발송됨 | |
| msg_biz_key | VARCHAR | 20 | | KISA 최초 발신사업자 구분 코드
재판매사의 경우 필수 입력, 일반 고객은 공란 | |
| template_code | VARCHAR | 20 | | 메시지허브 템플릿 키
허브 사용자 콘솔에 등록한 통합발송 템플릿 키 | |
| send_group_key | VARCHAR | 20 | | 동보 발송 묶음 키
동일한 키로 입력된 메시지들은 묶어서 발송됨
주의! 동일한 메시지일 경우만 같은 그룹키를 사용해야합니다. (수신번호 외 모든 컨텐츠가 동일해야함) | ※ 동보발송이란?
- 동일한 내용의 메시지내용을 10건씩 묶어서 한번에 발송하는 기능입니다. |
| callback_number | VARCHAR | 15 | NOT NULL | 발신번호
문자나 RCS 발송 시 필수 입력 | |
| campaign_id | VARCHAR | 100 | | 캠페인 ID
메시지 허브에서 캠페인 단위 통계내기위해 사용 | 영문, 숫자, 하이픈(-), 언더바(_) 포함 20자리까지 허용 |
| dept_code | VARCHAR | 20 | | 부서코드
부서별 빌링이 필요한 경우 사용 | |
| msg | VARCHAR | 4000 | | 전송할 메시지 내용
가변 데이터 입력 시 #{NAME} 로 입력 | |
| phone | VARCHAR | 20 | | 수신번호 | |
| merge_data | VARCHAR | 1000 | | 가변 데이터
ex) { "NAME" : "홍길동", "SHOP" : "이마트 용산" } | |
| title | VARCHAR | 100 | | 제목
LMS/MMS/RCS/KKO_NOTI/PUSH
발송 시 사용 | |
| file_list | VARCHAR | 1000 | | MMS 파일 절대 경로
”,”로 구분하여 N개 입력 가능 | |
| api_key | VARCHAR | 20 | | 발송된 API KEY
연동된 여러 API KEY 중, 실제 발송된 API KEY | |
| fb_product | VARCHAR | 10 | | fallback 발송할 채널
SMS/LMS/MMS 만 가능 | |
| fb_title | VARCHAR | 100 | | fallback 메시지 제목 | |
| fb_msg | VARCHAR | 4000 | | fallback 메시지 내용 | |
| fb_file_id | VARCHAR | 200 | | fallback MMS 파일
사전등록한 이미지 파일 아이디 지원 | 추후 지원 |
| rcs_msgbase_id | VARCHAR | 50 | | RCS 메시지베이스 ID | |
| rcs_header | VARCHAR | 5 | | RCS 메시지 유형
- info : 정보성 메시지
- ad : 광고성 메시지 | |
| rcs_footer | VARCHAR | 120 | | 무료수신거부번호
| 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_button | VARCHAR | 4000 | | RCS 버튼 Object array | |
| kakao_sender_key | VARCHAR | 40 | | 카카오톡 발신 프로필키 | |
| kakao_template_key | VARCHAR | 40 | | 알림톡, 친구톡 템플릿 키 | |
| kakao_button | VARCHAR | 4000 | | 카카오 버튼 Object | |
| kakao_image_wide_yn | VARCHAR | 1 | | 친구톡 와이드 이미지 여부(Y/N) | |
| kakao_image_url | VARCHAR | 200 | | 친구톡 이미지 URL | |
| kakao_image_link | VARCHAR | 200 | | 친구톡 이미지 링크 | |
| kakao_file_id | VARCHAR | 200 | | kakao 파일 아이디 | |
| kakao_ad_flag | VARCHAR | 1 | | 광고 표기 여부(Y/N) | |
| push_app_id | VARCHAR | 100 | | 앱 아이디
메시지허브 관리자 콘솔에 등록한 APP ID | |
| push_provider | VARCHAR | 20 | | PUSH 공급자
- FCM : 구글
- APNS : 애플 | |
| push_app_user_id | VARCHAR | 20 | | 앱 사용자 아이디
해당 앱을 설치하여 사용하는 사용자 ID | |
| push_file_id | VARCHAR | 200 | | push 이미지 파일 아이디
UMS_IMG에 등록한 FILE_ID | |
| push_ext | VARCHAR | 1000 | | 확장 커스텀 메시지
이미지 푸시를 위한 URL 또는 앱 상세페이지를 꾸밀 데이타 정보 URL(json) | |
| sent_date | datetime | | | 발송 요청 시간
Agent가 메시지허브 G/W 로 발송한 시간 | agent에서 업데이트하는 항목 |
| done_ch | VARCHAR | 10 | | 발송 성공한 채널 | agent에서 업데이트하는 항목 |
| done_product | VARCHAR | 20 | | 발송 성공한 상품 종류 | agent에서 업데이트하는 항목 |
| done_date | datetime | | | 단말 전달 시간 or 실패 최종 시간 | agent에서 업데이트하는 항목 |
| done_code | VARCHAR | 10 | | 처리 결과 코드 | agent에서 업데이트하는 항목 |
| done_code_desc | VARCHAR | 40 | | 처리 결과 상세 | agent에서 업데이트하는 항목 |
| done_fb_detail | VARCHAR | 1000 | | fallback 발송 처리 상세
첫 번째 채널이 발송 실패하고, 다음 채널이 발송될 경우 첫 번째 채널의 실패 코드 및 설명 표기 | agent에서 업데이트하는 항목 |
| done_telco | VARCHAR | 10 | | 이통사 정보
문자 및 RCS발송 성공의 경우 이통사 코드 업데이트 | agent에서 업데이트하는 항목 |