BizClient 사용자매뉴얼 USER MANUAL V1.3
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 14
BIZCLIENT 사용자 매뉴얼 v1.3
[BIZCLIENT v1.0.0.6 기준]
이 문서의 내용은 사전 공지 없이 변경될 수 있습니다.
이 문서의 소유권은 다우기술에 있으며 사전 승인 없이 무단 복제 및 배포를 금합니다.
ⓒ2017. DAOUTECH Corp. All rights reserved.
- 2 -
목 차
1. 개요........................................................................................................................................................................... 3
2. 발송 선결 조건 ...................................................................................................................................................... 3
3. 고객시스템과 연동 ................................................................................................................................................ 3
4. 설치........................................................................................................................................................................... 5
4.2 설치 및 구동 방법......................................................................................................................................... 5
4.2.1 Linux/Unix 계열 ................................................................................................................................... 5
4.2.2 Windows 계열 ........................................................................................................................................ 5
5. 발송........................................................................................................................................................................... 5
5.1 메시지타입 (MSG_TYPE) ........................................................................................................................... 6
5.2 발송상태변화 (STATUS) ............................................................................................................................. 6
5.3 발송결과확인 (CALL_STATUS) ................................................................................................................ 6
5.4 발송 쿼리 (MYSQL 기준) ........................................................................................................................... 6
5.4.1 참고 ......................................................................................................................................................... 6
5.4.2 SMS 발송 ................................................................................................................................................. 6
5.4.3 LMS/MMS 발송 .................................................................................................................................... 6
5.4.4 AT 발송 .................................................................................................................................................... 6
5.4.5 FT 발송 .................................................................................................................................................... 7
5.4.6 AT/FT + ATTACHMENT 발송 ......................................................................................................... 7
5.4.7 FT + 이미지 발송 .................................................................................................................................. 8
5.1.8 AT/FT + 대체발송 ................................................................................................................................ 9
5.1.9 FAX 발송 ................................................................................................................................................. 9
5.1.10 PHONE 발송 ..................................................................................................................................... 10
6. 지원 가능한 첨부파일 타입 ............................................................................................................................. 10
7. 발송결과코드 ....................................................................................................................................................... 10
8. 개정이력 ............................................................................................................................................................... 14
- 3 -
1. 개요
1.1 비즈클라이언트란?
고객사 시스템 환경에 설치되어 비즈뿌리오 서비스와 연동하여 이동 통신사 기반의 메시지
(SMS/LMS/MMS) 와 카카오톡 비즈메시지 (AT/FT), PHONE, FAX 를 발송해주도록 연계해주는
모듈입니다.
2. 발송 선결 조건
2.1 서비스 계정 생성
# biz.ppurio.com 에서 회원 가입
2.2 서비스 사용 승인요청
# 문의전화 : 070-8707-1273
# 이메일 : bizppurio@daou.co.kr
2.3 카카오톡 비즈메시지를 사용하려면
① 플러스친구 개설 (https://center-pf.kakao.com/login)
② 발신프로필 키 생성 (비즈뿌리오 관리자에게 생성 요청)
③ 알림톡의 경우, 템플릿 승인 필요 (비즈뿌리오 사이트에서 사용자가 직접 진행)
④ 친구톡에 이미지를 삽입하는 경우, 이미지 등록 필요
(비즈뿌리오 사이트에서 사용자가 직접 진행)
3. 고객시스템과 연동
3.1 연동방식은?
비즈클라이언트는 고객사의 데이터베이스 연동을 통하여 메시지를 발송하는 모듈로써, 고객사의
데이터베이스에 테이블을 생성한 후 발송에 필요한 데이터를 입력하면 비즈클라이언트는 이를 체크하여
메시지를 발송하는 방식입니다.
3.2 데이터베이스 테이블 구조
비즈클라이언트에서 사용하는 테이블의 목록은 다음과 같으며, 테이블 생성 권한만 있다면,
자동으로 해당 테이블들을 생성합니다.
메시지 테이블 – 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)
- 4 -
컬럼명
필수입력 여부
기본값
타입
길이
설명
STATUS
공통
Y
0
Number
1
데이터 발송 상태 (대기 0/발송중
1/발송완료 2/에러 3)
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
Y
String
5
국가코드
SENDER_KEY
AT/FT
Y
String
40
발신프로필키
TEMPLATE_CODE
AT/FT
Y
String
30
템플릿 코드
RESPONSE_METHOD
AT
N
String
8
발송 방식 (PUSH)
TIMEOUT
AT/FT
N
String
4
대체발송을 위한 타임아웃 시간설정
RE_TYPE
AT/FT
N
String
3
대체발송 메시지 타입 (SMS/MMS)
RE_BODY
AT/FT
N
String
2000
대체발송 메시지 내용
RE_PART
AT/FT
N
String
1
대체발송 처리 주체 (C:CLIENT, G:G/W)
WAP_URL
WAP
N
String
80
URL 주소
COVER_FLAG
FAX
N
0
Number
1
표지 발송 옵션
SMS_FLAG
PHONE
N
0
Number
1
실패 시 문자 전송 옵션
REPLY_FLAG
PHONE
/SMS_INBOUND
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
첨부파일 전송 시 파일명
(여러 개일 경우, '|' 문자로 구분)
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_FLAG
FT
N
String
1
광고성 메시지 필수 표기 사항을 노출
(노출여부 Y/N, 기본값 Y)
* MSG_GRP_CODE 컬럼은 카카오톡 비즈메시지 API 의 변경으로 비즈클라이언트 v1.0.0.6 부터 테이블 정의에서 제외되었습니다.
해당 버전 이하의 모듈을 패치를 진행하는 경우, 해당 컬럼과 임의로 추가하여 사용하는 컬럼에 대해 메시지 테이블에서 제거하거나
로그 테이블 생성 쿼리를 변경하여야 합니다. {모듈경로}/config/Data 경로에 존재하는 AlioDBScript_{사용하는 DBMS 명}.cfg
파일의 내용 중 CreateMsgTable 과 CreateLogTable 항목의 쿼리를 사용하시는 환경에 맞게 변경해주세요.)
- 5 -
테이블의 인덱스는 필요에 따라 설정하여 사용하시면 됩니다. 기본적으로 메시지테이블의 CMID 컬럼은
Primary Key 로 잡혀 있으며 로그테이블은 중복된 키 값을 허용할 수 있도록 PK 로 잡혀있지 않습니다.
CMID 컬럼값이 중복이 될 경우 데이터 발송에는 문제가 없으나 결과 리포트 반영이 정상적으로 이루어지지
않습니다. CINFO 컬럼은 고객 회사 내에서 구분이 필요할 경우 (예를 들어 발송하는 데이터에 대해 A 팀,
B팀 등으로 구분하고 싶을 때) 해당 정보 값을 넣어서 발송하면 비즈뿌리오 서버에서 구분이 되어 데이터가
전송 되며, biz.ppurio.com 의 [서비스 조회 - 발송 조회]에서 SUB ID 에 해당 CINFO 값이 표시가 됩니다.
4. 설치
4.1 설치 전 확인사항
4.1.1 JDK 설치 여부
# Oracle Sun Java 1.6 이상 설치 필요
4.1.2 DBMS 설치 여부
# MYSQL, ORACLE, MSSQL, SYBASE, CACHE 지원 가능
4.1.3 방화벽 오픈 상태 확인
# 운영 : biz.ppurio.com 26000/26100 (Outbound)
# 테스트 : biztest.ppurio.com 26000/26100 (Outbound)
4.2 설치 및 구동 방법
4.2.1 Linux/Unix 계열
① 비즈클라이언트를 업로드 한 뒤 압축 해제합니다. tar –xvf biz_client_v1xxx.tar
② 환경 설정 파일을 수정합니다. {모듈경로}/config/uds.conf
# 계정 설정 : biz.ppurio.com 사이트의 계정을 설정합니다. (옵션: UDS_ID, UDS_PW)
# DBMS 연결 정보 설정 (옵션: DBNAME, DBURL, DBUSER, DBPASS)
③ 비즈클라이언트를 시작합니다. {모듈경로}/script
# 시작 : ./biz_start
④ 비즈클라이언트를 중지합니다. {모듈경로}/script
# 중지 : ./biz_stop
4.2.2 Windows 계열
① 비즈클라이언트를 업로드 한 뒤 압축 해제합니다. tar –xvf biz_client_v1xxx.tar
② 환경 설정 파일을 수정합니다. {모듈경로}/config/uds.conf
# 계정 설정 : biz.ppurio.com 사이트의 계정을 설정합니다. (옵션: UDS_ID, UDS_PW)
# DBMS 연결 정보 설정 (옵션: DBNAME, DBURL, DBUSER, DBPASS)
③ 비즈클라이언트를 설치/시작합니다. {모듈경로}/bat
# 설치 : sevice-install.bat
비즈클라이언트 등록 확인: 제어판 → 관리도구 → 서비스
(Daoutech BizClient 서비스를 통하여 직접 시작/종료 가능)
# 시작 : sevice-start.bat 실행 (서비스 상태가 ‘시작’ 으로 변경됨)
④ 비즈클라이언트를 중지합니다. {모듈경로}/bat
# 중지 : sevice-uninstall.bat
5. 발송
- 6 -
메시지 문자열은 KSC 5601(ISO 10646-1/Unicode1.1) 한글 코드에 정의된 문자열입니다.
CMID 는 발송데이터의 고유한 키 값(Primary key)으로서 중복되지 않게 생성해주시면 됩니다.
5.1 메시지타입 (MSG_TYPE)
사용자는 총 7 가지 (SMS/MMS/AT/FT/PHONE/FAX/SMSINBOUND)의 메시지 타입 발송이
가능합니다. (사전에 비즈 아이디의 서비스 형태가 관련 메시지타입 발송이 가능하도록 설정이 필요)
5.2 발송상태변화 (STATUS)
STATUS 는 다음과 같은 상태 변화를 가집니다.
상태
0
7
1
2
11
설명
발송대기
발송 중
발송 후 대기
발송결과업데이트
(로그테이블 이동 대상)
클라이언트 대체발송 처리 중
5.3 발송결과확인 (CALL_STATUS)
발송 결과는 메시지 테이블의 CALL_STATUS 컬럼으로 확인이 가능하며 “발송 결과 코드”의
상세 설명은 ‘Ⅵ.발송결과코드’ 항목을 참고하여 주시기 바랍니다.
5.4 발송 쿼리 (MYSQL 기준)
5.4.1 참고
# 2개 이상의 파일을 전송할 때는 ATTACHED_FILE 필드에 파일 1|파일 2|… 형식으로 파일을 ‘|’ 으로
구분하여 입력합니다. (SMS 제외)
# 메시지 타입별 첨부파일이 발송해야하는 경우, 9. 지원 가능한 첨부파일 타입을 참조해주시기를
바랍니다
5.4.2 SMS 발송
SMS (텍스트 90byte 이하의 단문 메시지)
INSERT INTO biz_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY)
VALUES (0, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'본 메시지는 SMS 테스트 메시지 입니다.')
5.4.3 LMS/MMS 발송
LMS (텍스트 2000byte 이하의 장문 메시지)
INSERT INTO biz_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
SUBJECT, MSG_BODY)
VALUES (5, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
‘LMS 제목', '본 메시지는 LMS 테스트 메시지 입니다.')
MMS (텍스트 2000byte 이하, 이미지(60kb 이하) 등 멀티미디어를 같이 보내는 메시지)
INSERT INTO biz_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
SUBJECT, MSG_BODY, ATTACHED_FILE)
VALUES (5, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'MMS 제목', '본 메시지는 MMS 테스트 메시지 입니다.', {첨부파일명.jpg})
5.4.4 AT 발송
- 7 -
알림톡은 비즈뿌리오 서버에 등록된 사용 가능한 발신프로필키와 템플릿코드를 사용하여 발송됩니다.
AT
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE)
VALUES (6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, '82')
5.4.5 FT 발송
친구톡은 비즈뿌리오 서버에 등록된 사용 가능한 발신프로필키를 사용하여 발송되며, 카카오톡 사용자이고
발신프로필(옐로우아이디 또는 플러스친구)과 친구일 경우 발송 가능합니다.
FT
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, SENDER_KEY, NATION_CODE)
VALUES (7, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {발신프로필키}, '82')
5.4.6 AT/FT + ATTACHMENT 발송
알림톡/친구톡에 버튼링크를 추가하고자 할 경우(버튼형 템플릿의 경우) 환경설정파일에서 지정한
파일경로(FILE_PATH)에 JSON 형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.
(버튼링크를 위한 JSON 형식 파일 인코딩은 EUC-KR 로 생성되어 있어야 합니다.)
AT + ATTACHMENT
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE,
ATTACHED_FILE)
VALUES (6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, '82',
‘{파일명}.json’)
# 타입
타입
기 능
배송조회
- 메시지 내용에서 택배사명과 송장번호를 파싱하여 카카오검색 배송조회
페이지로 이동하는 배송 조회하기 버튼을 자동으로 생성함
웹 링크
- 버튼 클릭 시 인앱 브라우저에서 웹 페이지 실행
- Mobile / PC 에서 실행할 URL 을 각각 설정 가능
*현재 알림톡은 PC 에서 메시지 내용이 보이지 않음
앱 링크
- 버튼 클릭 시 앱 커스텀스킴 실행
- Android /iOS 에서 실행할 커스텀스킴 각각 설정 필수
봇 키워드
- 버튼 클릭 시 유저로부터 ’버튼명’이 텍스트로 들어간 챗버블이 발송됨
- 봇 또는 상담원에게 유저의 액션을 전달할 때 사용할 수 있음
메시지전달
- 버튼 클릭 시 유저로부터 ‘버튼명+메시지 본문’이 텍스트로 들어간 챗버블이 발송됨
- 봇 또는 상담원에게 유저가 수신한 알림톡과 함께 유저의 액션을 전달할 경우 사용
# 파라미터
키
타입
필수
설명
button
name
text
Y
버튼 제목
type
text
Y
버튼 타입 (아래 타입별 속성 표 참조)
url_pc
text
-
pc 환경에서 버튼 클릭 시 이동할
url_mobile
text
-
Mobile 환경에서 버튼 클릭 시 이동할 URL
scheme_ios
text
-
Mobile iOS 환경에서 버튼 클릭 시
실행할 Application Custom Scheme
scheme_android
text
-
Mobile Android 환경에서 버튼 클릭 시
실행할 Application Custom Scheme
- 8 -
# 타입별 속성
타입
속성
타입
필수
설명
WL
url_mobile
text
Y
버튼 클릭 시 이동할 pc/mobile환경별 Web URL
url_pc
text
N
AL
scheme_ios
text
Y
버튼 클릭 시 실행할 OS 별 Application Custom Scheme
scheme_android
text
Y
DS
-
-
-
버튼 클릭 시 배송조회 페이지로 이동
BK
-
-
-
해당 버튼 텍스트 전송
MD
-
-
-
해당 버튼 텍스트+메시지본문 전송
알림톡/친구톡 버튼타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.
button.json
{
"button": [
{
"name": "미리 주문하기",
"type": "WL",
"url_mobile": "http://www.kakao.com"
},
{
"name": "상담원 연결하기",
"type": "MD"
},
{
"name": "방송 알림 설정 보기",
"type": "AL",
"scheme_android": "daumapps://open",
"scheme_ios": "daumapps://open"
}
]
}
5.4.7 FT + 이미지 발송
이미지 타입의 친구톡을 발송하기 위하여 반드시 이미지를 사전에 비즈뿌리오 사이트의
[카카오톡 비즈메시지] - [친구톡 이미지 등록] 을 통해 업로드 해주시고, [친구톡 이미지 관리]에서 해당
이미지 URL 을 확인하셔서 발송해주시면 됩니다. 이미지에 대한 정보는 JSON 파일로 만들어
환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON 형식 파일을 업로드 한 후, 첨부될 파일은
ATTACHED_FILE 필드에 입력합니다.
(버튼링크를 위한 JSON 형식 파일 인코딩은 EUC-KR 로 생성되어 있어야 합니다.)
FT + IMAGE
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, SENDER_KEY, NATION_CODE,
ATTACHED_FILE)
VALUES (7, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {발신프로필키}, '82',
‘{파일명}.json’)
# 파라미터
키
타입
필수
설명
image
img_url
text
Y
버튼 제목
img_link
text
N
이미지 클릭 시 이동할 URL
- 9 -
친구톡+이미지타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.
image.json
{
"image":
{
"img_url": "등록된 이미지 URL",
"img_link": “http://bizmessage.kakao.com/”
}
}
친구톡+버튼링크+이미지타입 첨부파일의 실제 내용은 다음과 같이 하나의 JSON 형태로 구성됩니다.
button.json
{
"button":
{
"name": "미리 주문하기",
"type": "WL",
"url_mobile": "http://www.kakao.com"
},
"image":
{
"img_url": "등록된 이미지 URL",
"img_link": "http://bizmessage.kakao.com/"
}
}
5.1.8 AT/FT + 대체발송
알림톡/친구톡 발송결과 실패 시 지정하신 대체발송타입(SMS/MMS)과 대체발송본문을 사용하여 발송됩니다.
(단, 비즈뿌리오 ID 가 대체발송 사용 가능하도록 설정되어 있어야 합니다.)
대체발송본문에 대해 동일 본문을 사용하려면, 대체발송 메시지 필드(RE_BODY)를 비워두시면 됩니다.
(단, SMS 대체발송의 경우에는 메시지본문 (MSG_BODY) 길이가 SMS 의 허용 길이를 초과하였을 때 발송되지 않습니다.)
AT + 대체발송(SMS)
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE,
RE_TYPE, RE_BODY)
VALUES (6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, '82',
'SMS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.')
AT + 대체발송(MMS)
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE,
RE_TYPE, RE_BODY, ATTACHED_FILE)
VALUES (6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, '82',
'MMS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.', {첨부파일명.jpg})
5.1.9 FAX 발송
한글 100 자 이하의 표지를 포함한 이미지 및 문서를 발송할 수 있습니다
FAX
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
SUBJECT, MSG_BODY, ATTACHED_FILE, COVER_FLAG)
VALUES (2, '201XXXXXXXXX', NOW(), NOW(), '03112341234', '0212341234',
- 10 -
'표지제목', '표지내용', {첨부파일}, {팩스표지 사용여부, 사용할 경우 1 입력})
5.1.10 PHONE 발송
한글 100 자 이하의 TTS(Text To Speech) 및 3 분 미만의 WAVE 파일이 발송할 수 있습니다.
PHONE
INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY,
VXML_FILE, REPLY_FLAG)
VALUES (3, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'본 메시지는 테스트입니다. 다우기술 비즈메시지 서비스를 이용해주셔서 감사합니다.',
{시나리오파일 사용시, 시나리오파일명}, {시나리오 답변 기능 사용여부, 사용할 경우 1 입력});
6. 지원 가능한 첨부파일 타입
MMS
Image : jpg
Audio : ma3
Video : k3g
# Image 를 제외한 타입에 대해서는, 전송은 되지만 일부 이동통신사 또는 단말기에 대해
지원하지 않을 수 있습니다.
AT/FT
Button/Image : json
PHONE
Voice : wav (8bit-8KHz mono 형식)
FAX
DOCS : doc, docx, xls, xlsx, ppt, pptx, hwp, pdf, txt, html, html
IMAGE : bmp, gif, jpg, png
7. 발송결과코드
구 분
코 드
설 명
공 통
9903
선불사용자 사용금지
9904
Block time (날짜제한)
9081
선불 사용자 FAX, PHONE 발송 제한
9082
발송해제
9083
IP 차단
9084
DEVICE 발송 제한
9085
사용금지 Callback 번호
9023
Callback error
9905
Block time
9010
아이디틀림
9011
비밀번호 틀림
9012
중복접속량 많음
9013
발송시간 지난 데이터
9014
알림톡/친구톡 유효하지 않은 발신프로필키
9015
알림톡/친구톡 발신프로필키 미입력
9016
알림톡/친구톡 템플릿 미입력
9017
존재하지 않는 첨부파일
9018
0바이트 첨부파일
- 11 -
9019
지원하지 않는 첨부파일
9020
Wrong Data Format
9021
Wrong Data Format (no msg_body)
9022
Wrong Data Format (ex. cinfo 가 특수 문자 / , 공백 을 포함)
9023
시간제한 (리포트 수신대기 timeout)
9024
Wrong Data Format (ex. 메시지 본문 길이)
9026
블랙리스트에 의한 차단
9027
MMS 첨부파일 이미지 사이즈 초과
9080
Deny User Ack
9214
Wrong Phone Num
9215
인코딩 오류
9311
Uploaded File Not Found
9908
PHONE, FAX 선불사용자 제한기능
9090
기타에러
구 분
코 드
설 명
알림톡/친구톡
7000
전달
7101
카카오 형식 오류
7103
Senderkey (발신프로필키) 유효하지 않음
7105
Senderkey (발신프로필키) 존재하지 않음
7106
삭제된 Senderkey (발신프로필키)
7107
차단 상태 Senderkey (발신프로필키)
7108
차단 상태 옐로우 아이디
7109
닫힌 상태 옐로우 아이디
7110
삭제된 옐로우 아이디
7203
친구톡 전송 시 친구대상 아님
7204
템플릿 불일치
7300
기타에러
7305
성공불확실(30 일 이내 수신 가능)
7306
카카오 시스템 오류
7308
전화번호 오류
7311
메시지가 존재하지 않음
7314
메시지 길이 초과
7315
템플릿 없음
7318
메시지를 전송할 수 없음
7322
메시지 발송 불가 시간
7323
메시지 그룹 정보를 찾을 수 없음
7324
재전송 메시지 존재하지 않음
7421
타임아웃
구 분
코 드
설 명
SMS
4100
전달
4400
음영 지역
4401
단말기 전원 꺼짐
4402
단말기 메시지 저장 초과
4403
메시지 삭제 됨
4404
가입자 위치 정보 없음
4405
단말기 BUSY
4410
잘못된 번호
4420
기타에러
4430
스팸
4431
발송제한 수신거부(스팸)
4411
NPDB 에러
4412
착신거절
- 12 -
4413
SMSC 형식오류
4414
비가입자,결번,서비스정지
4421
타임아웃
4422
단말기일시정지
4423
단말기착신거부
4424
URL SMS 미지원폰
4425
단말기 호 처리중
4426
재시도한도초과
4427
기타 단말기 문제
4428
시스템에러
4432
회신번호 차단(개인)
4433
회신번호 차단(기업)
4434
회신번호 사전 등록제에 의한 미등록 차단
4435
KISA 신고 스팸 회신번호 차단
4436
회신번호 사전 등록제 번호규칙 위반
구 분
코 드
설 명
MMS
6600
전달
6601
타임 아웃
6602
핸드폰 호 처리 중
6603
음영 지역
6604
전원이 꺼져 있음
6605
메시지 저장개수 초과
6606
잘못된 번호
6607
서비스 일시 정지
6608
기타 단말기 문제
6609
착신 거절
6610
기타에러
6611
통신사의 SMC 형식 오류
6612
게이트웨이의 형식 오류
6613
서비스 불가 단말기
6614
핸드폰 호 불가 상태
6615
SMC 운영자에 의해 삭제
6616
통신사의 메시지 큐 초과
6617
통신사의 스팸 처리
6618
공정위의 스팸 처리
6619
게이트웨이의 스팸 처리
6620
발송 건수 초과
6621
메시지의 길이 초과
6622
잘못된 번호 형식
6623
잘못된 데이터 형식
6624
MMS 정보를 찾을 수 없음
6625
NPDB 에러
6626
080 수신거부(SPAM)
6627
발송제한 수신거부(SPAM)
6628
회신번호 차단(개인)
6629
회신번호 차단(기업)
6630
서비스 불가 번호
6631
회신번호 사전 등록제에 의한 미등록 차단
6632
KISA 신고 스팸 회신번호 차단
6633
회신번호 사전 등록제 번호규칙 위반
6670
첨부파일 사이즈 초과(60K)
구 분
코 드
설 명
- 13 -
FAX
3200
전달
3241
부분전달
3211
통화 중
3212
응답 없음
3213 3214
잘못된 번호
3242
사람이 받음
3216
호개통거부
3217
번호고장
3219
중계선 호폭주
3220
호개통 시간초과
3221
내부시스템 장애
3222
발신번호 사전 등록제에 의한 미등록 차단
3223
발신번호 사전 등록제 번호규칙 위반
3243
송신프로토콜 에러
3244
데이터 불량
3245
데이터 없음
3218 3250
기타에러
구 분
코 드
설 명
PHONE
일반전화
1200
청취
1201
청취 후 중간종료
1202
청취 후 답변
1211
통화 중
1212
부재 중
1213 1214
잘못된 전화번호
1216
호개통거부
1217
번호고장
1219
중계선 호폭주
1220
호개통 시간초과
1221
내부시스템 장애
1231
시나리오 not found
1232
시나리오 CGI error
1233
Invalid VXML
1234
시나리오 DNS error
1218 1250
기타에러
PHONE
휴대전화
2201
청취
2202
청취 후 답변
2211
통화 중
2200, 2212
부재 중
2213 2214
잘못된 전화번호
2216
호개통거부
2217
번호고장
2219
중계선호폭주
2220
호개통 시간초과
2221
내부시스템 장애
2231
시나리오 Not found
2232
시나리오 CGI error
2233
Invalid VxML
2234
시나리오 DNS error
2218 2250
기타에러
구 분
코 드
설 명
SMS_INBOUND
5100
사서함 미확인
5110
사서함 확인
- 14 -
5111
사서함 확인 후 답변
5400
음영지역
5410
잘못된 전화번호
5420
기타에러
8. 개정이력
버전
작성일
변경내용
작성자
1.0
2016.07.30
신규 작성
정종하
1.1
2017.03.27
내용 추가 및 수정
정종하
1.2
2017.05.12
내용 추가 및 수정
정종하
1.3
2017.05.25
설치가이드 및 상세매뉴얼을 사용자매뉴얼로 통합
전체적인 내용 추가 및 수정
정종하
