‘통합 템플릿’을 Key:Value 형식의 데이터로 발송 할 수 있는 템플릿 발송 테이블 입니다.

이 테이블은 메시지 허브에서 문자/RCS/카카오톡/PUSH의 다양한 채널을

원하는 발송 순서대로 정의한 ‘통합 템플릿’을 먼저 등록 후 템플릿 key를 기준으로 발송 가능하며,

서비스 별 단 건 발송은 불가합니다. (템플릿 없이 단건 발송을 원할 경우 UMS_MSG 테이블 이용)

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

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

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

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

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

• normal : 일반 (default)
• real : 실시간/중요
• batch : 마케팅, 광고 | 표 하단 설명 참조 | | REQ_DATE | datetime | | NOT NULL | 발송 요청 시간 미래 시간으로 입력 시, 예약 발송됨 | | | MSG_STATUS | VARCHAR | 10 | NOT NULL | 발송 상태
• ready : 발송 대기 (insert 상태 값)
• request : 발송 완료
• complete : 결과 수신 완료
• pre-send : select 완료
• pre-image : 이미지 등록 작업 중 | | | MSG_BIZ_KEY → KISA_ORIGCODE | VARCHAR | 20 | | KISA 최초 발신사업자 구분 코드 재판매고객은 건 별 입력, 일반 고객은 config파일에 설정한 값으로 사용 | | | RCS_AGENCY_ID | VARCHAR | 100 | | 대행사 ID ex) lguplus | | | RCS_AGENCY_KEY | VARCHAR | 64 | | 대행사 인증 Key 입력하는 agencyId가 대행사의 것일 경우, 해당 대행사의 agencyKey를 함께 전송해야 함 | RCS 메시지 보안 인증 강화 항목 | | RCS_BRAND_KEY | VARCHAR | 64 | | 발신자 인증 Key 기업에서 생성한 브랜드마다 부여되는 Key로, 메시지 전송 시 발신번호가 속한 브랜드의 Key를 함께 전송해야 함 | RCS 메시지 보안 인증 강화 항목 | | TEMPLATE_CODE | VARCHAR | 20 | NOT NULL | 메시지허브 템플릿 키 허브 사용자 콘솔에 등록한 통합발송 템플릿 키 | | | CALLBACK_NUMBER | VARCHAR | 15 | | 발신번호 문자나 RCS 발송 시 필수 입력 | | | CAMPAIGN_ID | VARCHAR | 100 | | 캠페인 ID 메시지 허브에서 캠페인 단위 통계내기위해 사용 | 영문, 숫자, 하이픈(-), 언더바(_) 포함 20자리까지 허용 | | DEPT_CODE | VARCHAR | 20 | | 부서코드 부서별 빌링이 필요한 경우 사용 | | | PHONE | VARCHAR | 20 | | 수신번호 | | | KV_DATA | VARCHAR | 4000 | | Key-Value 변환데이터 등록된 통합템플릿에 정의된 변수를 key로 하여 각 값 표기 ex) {”name”:”홍길동”, “shop”:”이마트 용산”} | | | KV_DATA2 | VARCHAR | 4000 | | Key-Value 변환데이터2 kv_json에서 입력할 데이터가 부족할 경우 사용 | | | PUSH_USER_ID | VARCHAR | 20 | | PUSH 앱 사용자 아이디 | | | FILE_DATA | VARCHAR | 4000 | | 템플릿 이미지 변경 발송 데이터 ”서비스명 . 변경할 이미지 번호 . 이미지 첨부 방식(.친구톡 이미지 Wide 여부)” key 와 값으로 이루어진 데이터 ex) {”rcs.1.path”:”pokemon.jpg”, “friendtalk.1.url.y”:”https://msghub.uplus.co.kr/image/digimon.jpg”} | | | ROUTE_INFO | VARCHAR | 20 | | 라우팅 정보 실제 발송된 중계 및 API KEY 표기 ****ex) kt:a1234156, lgu:d324fdsare, dau:xxxxxxxx | agent에서 업데이트하는 항목 | | SENT_DATE | datetime | | | 발송 요청 시간 Agent가 메시지허브 G/W 로 발송한 시간 | 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 발송 처리 상세 각 채널이 발송 실패할 경우, 실패 코드와 설명 표기

ex) 첫 번째 채널이 실패하고 두 번째 채널로 발송성공할 경우, DONE_FB_DETAIL에는 첫 번째 채널의 실패 코드 및 설명 표기되며, 성공한 두 번째 채널에 대한 설명은 DONE_CODE와 DONE_CODE_DESC에 표기됨 | agent에서 업데이트하는 항목 | | DONE_TELCO | VARCHAR | 10 | | 이통사 정보 문자 및 RCS 발송 성공의 경우 이통사 코드 업데이트 | agent에서 업데이트하는 항목 | | ETC1 | VARCHAR | 256 | | 기타 고객사 예비 필드1 | | | ETC2 | VARCHAR | 256 | | 기타 고객사 예비 필드2 | | | ETC3 | VARCHAR | 256 | | 기타 고객사 예비 필드3 | | | ETC4 | VARCHAR | 256 | | 기타 고객사 예비 필드4 | | | ETC5 | VARCHAR | 256 | | 기타 고객사 예비 필드5 | | | ETC6 | VARCHAR | 256 | | 기타 고객사 예비 필드6 | |

※ TRAFFIC_TYPE 에 대한 설명

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