5. Table Schema

비즈클라이언트 테이블 구조

비즈클라이언트에서 사용하는 테이블의 목록은 다음과 같으며, 테이블 생성 권한만 있다면, 자동으로 해당 테이블들을 생성합니다.

메시지 테이블 : BIZ_MSG

• 메시지 발송을 위한 데이터가 입력되며, 발송 결과 업데이트가 이루어지기까지 데이터가 존재하는 테이블

로그 테이블 – BIZ_LOG_YYYYMM

• 메시지 테이블에서 발송 결과 업데이트가 완료된 데이터가 이동되는 테이블

테이블의 각 컬럼은 다음과 같습니다.

*표시 컬럼은 비즈클라이언트에서 사용

컬럼 명	필수입력 여부		기본값	타입	길이	설명
CMID	공통	Y		String	32	데이터 ID, 고유한 값 MSG_TABLE 일 경우 Primary Key
UMID	공통	N		String	32	비즈뿌리오 서버에서 정의한 MESSAGE ID
MSG_TYPE	공통	Y	0	Number	1	데이터 타입(SMS 0/FAX 2/PHONE 3/MMS 5/AT 6/FT 7/RCS 8)
STATUS	공통	Y	0	Number	1	데이터 발송 상태(대기 0/발송중 1/발송완료 2)
REQUEST_TIME	공통	Y	now	Datetime		데이터 등록 시간
SEND_TIME	공통	Y	now	Datetime		발송 기준 시간
REPORT_TIME	공통	N		Datetime		단말기 수신 시간
DEST_PHONE	공통	Y		String	16	수신번호
DEST_NAME	공통	N		String	32	수신자명
SEND_PHONE	공통	Y		String	16	발신자번호
SEND_NAME	공통	N		String	32	발신자명
SUBJECT	FAX/MMS	N		String	64	제목
MSG_BODY	공통	Y		String	2000	메시지내용
NATION_CODE	AT/FT/BI/BW	Y		String	5	국가코드
SENDER_KEY	AT/FT/BI/BW	Y		String	40	발신프로필 키
TEMPLATE_CODE	AT/FT/BI/BW	Y		String	64	템플릿 코드
RESPONSE_METHOD	AT	N		String	8	발송 방식(PUSH)
TIMEOUT	AT/FT	N		String	4	대체발송을 위한 타임아웃 시간설정
RE_TYPE	AT/FT	N		String	3	대체발송 메시지 타입(대체발송타입 참조)
RE_BODY	AT/FT/RCS	N		String	2000	대체발송 메시지 내용
RE_PART	AT/FT/RCS	N		String	1	대체발송 처리 주체(C : Client, S : Server)
COVER_FLAG	FAX	N	0	Number	1	표지 발송 옵션
SMS_FLAG	PHONE	N	0	Number	1	실패 시 문자 전송 옵션
REPLY_FLAG	PHONE	N	0	Number	1	시나리오 답변기능 여부(Y : 1, N : 0)
RETRY_CNT	FAX/PHONE	N		Number	4	재시도 횟수
ATTACHED_FILE	MMS/FAX/PHONE/AT/FT	N		String	1000	[기본 MODE] 첨부파일 전송 시 파일명 (여러 개일 경우, ‘I’문자로 구분) [첨부파일 테이블 MODE] 첨부파일 테이블 KEY
VXML_FILE	PHONE	N		String	64	음성 시나리오 파일 이름
CALL_STATUS	공통	N		String	4	발송결과 리포트
USE_PAGE	FAX	N	0	Number	2	발송 페이지 수
USE_TIME	PHONE	N	0	Number	4	발송 소요 시간 (단위:초)
SN_RESULT	PHONE	N	0	Number	1	설문 조사 응답 값(0~9)
TEL_INFO	공통	N		String	10	통신사 정보 (SKT/KTF/LGT/KKO)
CINFO	공통	N		String	32	Client Indexed Info 특수기호 (\/:*?”<>|.) 사용불가
USER_KEY	FT	N		String	30	옐로아이디 봇을 이용해 받은 옐로아이디 사용자 식별키
AD_FALG	FT	N		String	1	광고성 메시지 필수 표기 사항을 노출(노출여부 Y/N, 기본값 Y)
RCS_REFKEY	RCS	N		String	32	RCS 테이블 KEY

추가적인 인덱스는 필요에 따라 설정하여 사용하시면 됩니다.

메시지 테이블의 CMID 컬은 Primary Key 로 잡혀 있으며, 로그테이블은 중복된 키 값을 허용할 수 있도록 PK가 잡혀있지 않습니다.
참고로, CMID 컬럼이 중복 될 경우 데이터 발송에는 문제가 없으나 결과 리포트 반영이 정상적으로 이루어지지 않을 수 있습니다.

CINFO 컬럼은 고객 회사 내에서 구분이 필요할 경우 (예를 들어 발송하는 데이터에 대해 A 팀, B 팀 등으로 구분하고 싶을 때) 해당 정보 값을 넣어서 발송하면 비즈 뿌리오 서버에서 구분이 되어 데이터가 전송 되며, biz.ppurio.com 의 *[서비스 조회 – 발송 조회]에서 SUB ID 에 해당 CINFO 값이 표시가 됩니다.

CMID_ASCII_CHAR

CMID 필드에 ASCII 범위 외의 문자를 사용하길 희망하는 경우 사용하는 옵션

CMID 필드는 기본 ASCII 범위의 문자열만 입력 가능합니다.

• Y (DEFAULT): ASCII 문자로 구성된 CMID 만 사용 가능합니다.
• N: ASCII 범위 외 한글 및 특수문자를 포함하려는 경우 사용합니다.

* 주의사항 *
- 허용 불가한 CMID 가 입력될 경우에는 발송이 실패할 수 있습니다.

MESSAGE_SUPPORT_TYPE

MESSAGE_SUPPORT_TYPE 설정에 따라 RCS 발송에 사용하는 테이블을 생성합니다.

RCS 메시지 테이블 : BIZ_RCS

• RCS 메시지 발송을 위한 데이터가 입력되며, 메시지 테이블의 발송 결과 업데이트가 이루어지기까지 데이터가 존재하는 테이블

RCS 로그 테이블 – BIZ_RCS_LOG_YYYYMM

• RCS 메시지 테이블에서 발송 결과 업데이트가 완료된 데이터가 이동되는 테이블

컬럼명	필수입력 여부	타입	길이	설명
REFKEY	Y	String	32	테이블 참조키 MSG_TABLE일 경우, Primary Key
CHATBOT_ID	Y	String	40	RCS비즈센터를 통해 생성한 챗봇ID
HEADER	Y	String	1	메시지 상단에 식별 문구를 입력 (0:Web발신, 1:광고)
FOOTER	N	String	64	메시지 하단에 수신거부 문구를 입력
MESSAGEBASE_ID	Y	String	40	RCS 공통포맷 또는 템플릿ID (RCS SMS, LMS, MMS 공통포맷, 템플릿은 별도등록) * RCS 공통포맷참고
COPY_ALLOWED	N	String	1	단말기에서 사용자에게 '복사'/'공유'메뉴 보기 여부 (Y/N, 기본 N)
RCS_BODY	Y	String	2000	메시지 베이스에서 치환할 파라미터 정보(Json 형식)
BUTTONS	N	String	2000	메시지에 삽일할 버튼 정보 (Json 형식)
AGENCY_KEY	N	String	64	대행사 Key(2차 대행사의 경우 값이 필수)
BRAND_KEY	Y	String	64	브랜드 별 제공되는 특수 키

FILE_HANDLING_MODE

FILE_HANDLING_MODE 설정에 따라 다음과 같은 테이블을 생성합니다.

첨부파일 테이블 : BIZ_ATTACHMENTS

• 메시지 발송을 위한 첨부파일 데이터가 입력되는 테이블

첨부파일 로그 테이블 : BIZ_ATTACHMENTS_LOG_YYYYMM

• 첨부파일 테이블에서 발송 결과 업데이트가 완료된 데이터가 이동되는 테이블

참고:  [첨부파일 관리]

컬럼명	필수입력 여부	기본값	타입	길이	설명
MSG_KEY	Y		String	32	MSG_TABLE과 매칭되는 KEY 값	복합키
SEQ	Y		Number		데이터 시퀀스
TYPE	Y	FILE	String	10	데이터 타입 (FILE / HTTP / JSON)
CONTENTS	Y		String	2000	데이터 값 (파일명 / URL / JSON String)