Skip to main content
응답의 status 또는 value[].status 필드로 반환되는 코드입니다.

​
요청 파라미터 오류

코드설명
ERR_100authToken 데이터 누락
ERR_101serverName 데이터 누락
ERR_102header 데이터 미일치 (인증 실패)
ERR_200body parameter 가 null
ERR_201지원하지 않는 parameter를 입력
ERR_202mobile 데이터 누락
ERR_203message 데이터 누락
ERR_204template 데이터 누락
ERR_205service 혹은 yellowId 데이터 누락
ERR_206uid 데이터 누락
ERR_207senddate1 데이터 누락
ERR_208senddate2 데이터 누락
ERR_209sendDate1 가 sendDate2 보다 늦은 값이 입력
ERR_210입력된 검색 기간이 7일을 초과
ERR_211추가적인 파라미터가 필요
ERR_212부적절한 service 데이터 입력
ERR_213부적절한 template 데이터 입력
ERR_214지원하지 않는 전화번호 format 입력
ERR_215지원하지 않는 날짜 format 입력
ERR_216부적절한 status 데이터 입력
ERR_217발송결과 상세조회 시 조회결과가 null인 경우 (부적절한 uid 데이터)
ERR_218backupProcessCode 데이터 누락
ERR_219부적절한 backupProcessCode 입력
ERR_220uidList 데이터 누락
ERR_221uid 가 존재하지 않을 경우
ERR_222결과 요청 uid 가 1000개를 초과했을 경우
ERR_223템플릿 버튼 5개를 초과하여 발송 요청했을 경우
ERR_224버튼 url 길이 제한을 초과했을 경우
ERR_225메시지 길이 제한을 초과했을 경우
ERR_226제목 길이 제한을 초과했을 경우
ERR_227중복된 messageId 로 요청
ERR_228messageId 사이즈 초과 (40byte 초과)
ERR_229callback 번호 사이즈 초과
ERR_230callback 번호가 존재하지 않음
ERR_231문자배치발송API에서 mobileList 데이터 누락
ERR_232문자배치발송API에서 mobileList 에 전화번호가 존재하지 않음
ERR_233문자배치발송API에서 mobileList 에 전화번호가 1만개를 초과함
ERR_234custId 사이즈 초과
ERR_235limit 허용범위가 아님
ERR_236startdate 데이터 누락
ERR_237enddate 데이터 누락
ERR_238startDate 가 endDate 보다 늦은 값이 입력
ERR_239traceId 데이터 누락
ERR_250페이징 결과조회에서 limit parameter가 범위내에 있지 않음
ERR_251페이징 결과조회에서 page parameter가 범위내에 있지 않음
ERR_252브랜드톡 배치 발송요청에서 imageType 이 BI 또는 BW가 아님
ERR_253브랜드톡 배치 발송요청에서 발송대상이 존재하지 않음
ERR_254브랜드톡 배치 발송요청에서 발송대상이 1000건이 초과됨
ERR_255브랜드톡 배치 발송요청에서 발송대상이 규격에 맞지 않음
ERR_256브랜드톡 자유형 템플릿의 contentType 누락
ERR_257브랜드톡 발송요청에서 contentType 이 F 또는 V가 아님
ERR_258브랜드톡 자유형 템플릿의 imageType 누락
ERR_259imageId 누락
ERR_260존재하지 않는 imageId 로 요청함
ERR_261정보성 서비스에 이미지를 첨부함
ERR_262전송결과요청에서 limit 이 1~1000 사이가 아님
ERR_263전송결과싱크요청에서 traceId 가 입력되지 않음
ERR_270RCS 발송 요청 campaignId 길이 제한을 초과 (20자 초과)
ERR_271RCS 발송 요청 campaignId 에 허용하지 않는 문자 존재 (허용문자: 영문 대소문자, 숫자, 대시, 언더바)
ERR_280title 템플릿인데 title 가 존재하지 않음
ERR_281title 길이 제한을 초과했을 경우
ERR_282price 길이 제한을 초과했을 경우
ERR_283currencyType 길이 제한을 초과했을 경우
ERR_284알림톡 메시지 타입이 AT 또는 AI가 아님
ERR_285알림톡+실패 시 RCS 발송 요청에 맞는 서비스정보가 아님 (MULTI 서비스가 아니거나 발송순서가 맞지 않음)
ERR_286RCS 발송 요청 수신번호가 1개 이상임
ERR_288yellowId 의 service 없음 (service 없이 yellowId로 발송할 경우)
ERR_289yellowId 의 service 1개 초과 (service 없이 yellowId로 발송할 경우)
ERR_290브랜드 메시지 타입이 존재하지 않음
ERR_291chatBubbleType 이 없음
ERR_292chatBubbleType 이 존재하지 않음
ERR_293targeting 이 없음
ERR_294targeting 이 존재하지 않음
ERR_295부적절한 sendType 데이터 입력
ERR_296sendType 이 존재하지 않음
ERR_300CNS 내부 서버 오류
ERR_400SMB 포인트 부족

​
카카오톡 알림톡 응답 오류

코드설명
OK정상코드 (SUCCESS)
KKO_ERRLGCNS와 카카오간의 네트워크 에러, 카카오톡 서버 응답 타임아웃
KKO_0000정상코드 (response_method가 realtime인 경우 전송/수신 성공, polling인 경우 전송만 성공, push인 경우 전송 성공 및 과금 처리)
KKO_1001Request Body가 JSON 형식이 아님
KKO_1002허브 파트너 키가 유효하지 않음
KKO_1003발신 프로피 키가 유효하지 않음
KKO_1004Request Body(Json)에서 name을 찾을 수 없음
KKO_1005발신프로필을 찾을 수 없음
KKO_1006삭제된 발신프로필
KKO_1007차단 상태의 발신프로필
KKO_1008차단 상태의 옐로아이디
KKO_1009닫힘 상태의 옐로아이디 / (브랜드 메시지) 발송을 위한 특수한 유형의 부가통신 사업자 등록번호 등록 안 됨
KKO_1010삭제된 옐로아이디
KKO_1011계약정보를 찾을 수 없음
KKO_1012잘못된 형식의 유저키 요청
KKO_1013유효하지 않은 app 연결
KKO_1014유효하지 않은 사업자번호
KKO_1015유효하지 않은 app user id 요청
KKO_1016사업자등록번호 불일치
KKO_1020전화번호 또는 app user id가 유효하지 않거나 미입력 요청
KKO_1021차단 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인)
KKO_1022닫힘 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인)
KKO_1023삭제된 카카오톡 채널 (카카오톡 채널 운영툴에서 확인)
KKO_1024삭제대기 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인)
KKO_1025메시지차단 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인)
KKO_1026해당 message_type에서 사용할 수 없는 response_method로 요청 (이미지알림톡(AI)은 realtime으로 발송 불가)
KKO_1027채널 메시지 제재 상태로 인한 메시지 전송 실패 (카카오톡 채널 운영툴에서 확인)
KKO_1028해당 타겟팅 옵션 사용할 수 없음
KKO_1030잘못된 파라메터 요청
KKO_1033템플릿 메시지 타입과 chat_bubble_type 파라미터 불일치
KKO_2003(테스트 발송) 카카오톡 채널을 추가하지 않았음
KKO_2004템플릿 일치 확인시 오류 발생
KKO_2006시리얼넘버 형식 불일치
KKO_3000예기치 않은 오류 발생
KKO_3005(알림톡) 메시지를 발송했으나 수신확인 안 됨 (성공불확실, 3일 이내 수신 가능) / (브랜드메시지) 지원하지 않는 스펙
KKO_3006내부 시스템 오류로 메시지 전송 실패
KKO_3008전화번호 오류
KKO_3010Json 파싱 오류
KKO_3011메시지가 존재하지 않음
KKO_3012메시지 일련번호가 중복됨 (메시지 별로 고유한 값이 부여되어야 함)
KKO_3013메시지가 비어 있음
KKO_3014메시지 길이 제한 오류 (템플릿별 제한 길이 또는 1300자 초과)
KKO_3015템플릿을 찾을 수 없음
KKO_3016메시지 내용이 템플릿과 일치하지 않음
KKO_3018메시지를 전송할 수 없음 (카카오톡 미사용자, 최근 카카오톡 미사용 등)
KKO_3019톡 유저가 아님
KKO_3020알림톡 수신 차단
KKO_3021카카오톡 최소 버전 미지원
KKO_3022메시지 발송 가능한 시간이 아님 (광고 메시지는 08시부터 20시 50분까지 발송 가능)
KKO_3023메시지에 포함된 비디오를 전송할 수 없음 (비디오 주소 또는 썸네일 이미지 오류)
KKO_3024메시지에 포함된 이미지를 전송할 수 없음 (이미지주소 또는 링크 오류)
KKO_3025변수 글자수 제한 초과
KKO_3026상담/봇 전환 버튼 extra, event 글자수 제한 초과
KKO_3027메시지 버튼이 템플릿과 일치하지 않음
KKO_3028메시지 강조 표기 타이틀이 템플릿과 일치하지 않음
KKO_3029메시지 강조 표기 타이틀 길이 제한 초과 (50자)
KKO_3030메시지 타입과 템플릿 강조유형이 일치하지 않음
KKO_3031헤더가 템플릿과 일치하지 않음
KKO_3032헤더 길이 제한 초과 (16자)
KKO_3033아이템 하이라이트가 템플릿과 일치하지 않음
KKO_3034아이템 하이라이트 타이틀 길이 제한 초과 (이미지 없는 경우 30자, 있는 경우 21자)
KKO_3035아이템 하이라이트 디스크립션 길이 제한 초과 (이미지 없는 경우 19자, 있는 경우 13자)
KKO_3036아이템 리스트가 템플릿과 일치하지 않음
KKO_3037아이템 리스트의 아이템의 디스크립션 길이 제한 초과 (23자)
KKO_3038아이템 요약정보가 템플릿과 일치하지 않음
KKO_3039아이템 요약정보의 디스크립션 길이 제한 초과 (14자)
KKO_3040아이템 요약정보의 디스크립션에 허용되지 않은 문자 포함 (통화기호/코드, 숫자, 콤마, 소수점, 공백 외 문자)
KKO_3041와이드 아이템 리스트 갯수 최대 최소 갯수 불일치
KKO_3042대표링크가 템플릿과 일치하지 않음
KKO_3043이미지 변수 개수 템플릿 불일치
KKO_3044커머스 쿠폰 변수 템플릿 불일치
KKO_3045커머스 정보 변수 템플릿 불일치
KKO_3046부가 정보 최대 길이 제한 오류
KKO_3047커머스 정보 상품명 최대 길이 제한 오류
KKO_3048유효하지 않은 그룹태그
KKO_3050수신동의거부 스펙 (N타입) 미지원
KKO_3051캐러셀 아이템 리스트 갯수 최소, 최대 갯수 불일치
KKO_3052캐러셀 아이템 메시지 길이 초과
KKO_3053캐러셀 템플릿 불일치
KKO_3054캐러셀 버튼 템플릿 불일치
KKO_3055캐러셀 쿠폰 템플릿 불일치
KKO_3056와이드 아이템 리스트 타이틀 길이 제한 오류
KKO_3057캐러셀 커머스 템플릿 불일치
KKO_3058캐러셀 헤더 길이 제한 오류
KKO_3059쿠폰 스펙 미지원
KKO_4000메시지 전송 결과를 찾을 수 없음 / (브랜드 메시지) 입력값 오류 발생
KKO_4001알 수 없는 메시지 상태
KKO_9998담당자가 시스템에 문제가 있어 확인하고 있는 경우
KKO_9999담당자가 시스템에 문제가 있어 확인하고 있는 경우
KKO_ME09(폴링 방식으로 발송한 경우만 해당) 사용자에게 발송을 하였으나 특정 시간동안 응답이 없음 (성공 불확실)

​
공통 / SMS / LMS 오류

코드설명
OK정상코드 (SUCCESS)
VE10휴대폰 번호 검증 오류
VE20메시지 data 검증 오류
VE30device_id 검증 오류
VE40검증오류 (알 수 없는 오류)
VE41광고수신동의를 하지 않은 사람에게 광고성 메시지를 전송요청함
VE50회신번호 white list에 없음
VE51회신번호 세칙에 의해 발송할 수 없는 번호
VE60암복호화 오류
VE70발송제한으로 메시지 발송불가 (선불 충전고객의 잔액부족 또는 서비스발송제한 적용 시)
QA10QA서버에서 수신자번호 화이트리스트에 등록되지 않은 번호로 발송함

​
SMS 결과코드

코드설명
SMS_00발송 진행 중 (발송 결과는 별도 요청으로 확인 필요)
SMS_01E_SYSFAIL
SMS_02E_AUTH_FAIL
SMS_03BIND 안 됨
SMS_05착신자 없음
SMS_06전송 성공
SMS_07비가입자 (결번)
SMS_08단말기 전원 꺼짐
SMS_09음영지역
SMS_10단말기 메시지 꽉참
SMS_11단말기 전원 꺼짐, 음영지역, 이통사 TIME OUT
SMS_13번호 이동
SMS_14무선망에러
SMS_17Callback 사용자 아님
SMS_18메시지 중복 발송
SMS_19월 송신 건수 초과
SMS_20기타 에러
SMS_21착신번호 에러 (자리수)
SMS_22착신번호 에러 (없는 국번)
SMS_23수신거부 메시지 없음
SMS_2421시 이후 광고
SMS_25광고 (성인, 대출 등)
SMS_26데이콤 스팸 필터링
SMS_27야간 발송 차단
SMS_28사전 미등록 발신번호 사용
SMS_29전화번호 세칙 미준수 발신 번호 사용
SMS_30발신번호 변작으로 등록된 발신번호 사용
SMS_31번호 도용 문자 차단 서비스에 가입된 발신번호 사용
SMS_40단말기 착신 거부 (스팸 등)
SMS_70기타오류
SMS_80결번 (SKT)
SMS_81전송실패 (SKT)
SMS_82번호이동 DB 조회 불가 (SKT)
SMS_83번호이동번호
SMS_84시간 초과 (SKT)
SMS_85전송 실패 (SKT)
SMS_91발송 미허용 시간 발송 실패 처리
SMS_99중복 발송 (환경설정 파일)

​
LMS(MMS) 결과코드

코드설명
MMS_0000발송 진행 중 (발송 결과는 별도 요청으로 확인 필요)
MMS_2000포멧 에러
MMS_2001잘못된 번호
MMS_2002컨텐츠 사이즈 및 개수 초과
MMS_2003잘못된 컨텐츠
MMS_3000가업형 MMS 미지원 단말기
MMS_3001메시지 저장 개수 초과
MMS_3002단말기 전원 꺼짐, 음영지역, 이통사 TIME OUT
MMS_3004전원 꺼짐
MMS_3005음영지역
MMS_3006기타
MMS_4000서버문제로 인한 접수 실패
MMS_4001단말기 일시 서비스 정지
MMS_4002통신사 내부 실패 (무선망)
MMS_4003서비스 일시적 에러
MMS_4101계정 차단
MMS_4102허용되지 않은 IP 접근
MMS_4104건수 부족
MMS_4201국제 MMS 발송 권한 없음
MMS_5000번호 이동 에러
MMS_5001선불 발급 발송 건수 초과
MMS_5003스팸 처리
MMS_5201중복된 키 접수 차단
MMS_5202중복된 수신번호 접수 차단
MMS_5301사전 미등록 발신번호 사용
MMS_5302전화번호 세칟 미준수 발신 번호 사용
MMS_5303발신번호 변작으로 등록된 발신번호 사용
MMS_5304번호 도용 문자 차단 서비스에 가입된 발신번호 사용
MMS_9001발송 미허용 시간 발송 실패 처리
MMS_9002폰 번호 에러
MMS_9003스팸 번호 (스팸 사용 시)
MMS_9004이통사 응답 없음
MMS_9005파일 크기 오류
MMS_9006지원되지 않는 파일
MMS_9007파일 오류
MMS_9008메시지 TYPE 오류
MMS_9009중복 발송 (환경설정 파일)
MMS_9010재전송 횟수 초과로 인한 실패
MMS_9011발송 지연 실패

​
카카오 브랜드메시지 이미지 업로드

코드설명
OK정상코드 (SUCCESS)
KKO_ERRLGCNS와 카카오간의 네트워크 에러, 카카오톡 서버 응답 타임아웃
KKO_413이미지 용량 초과 - Request Entity Too Large
KKO_600이미지 업로드 실패 - LGCNS와 카카오의 확인이 필요함
KKO_601이미지 용량 초과 - InvalidImageLengthException
KKO_602발송할 수 없는 이미지 사이즈
KKO_603지원하지 않는 이미지 형식 - jpg, png가 아님
KKO_605업로드 가능한 이미지 개수 초과
KKO_615일부 이미지 업로드 실패

​
PUSH / MMS 이미지 업로드

코드설명
OK정상코드 (SUCCESS)
IMG_700image1~3에 모두 이미지가 없음
IMG_701image를 순서대로 넣지 않음 (image1에 이미지가 없는데 image2에 있을 때 등)
IMG_702이미지 용량 초과 - 사이즈가 80KB 초과임
IMG_703지원하지 않는 이미지 형식 - jpg가 아님