Notification > KakaoTalk Bizmessage > 오류 코드

API 응답 코드

service isSuccess resultCode resultMessage
공통 true 0 성공
공통 false -1000 유효하지 않은 앱키
공통 false -1001 유효하지 않은 비밀 키(secretKey)
공통 false -1002 유효하지 않은 SMS 앱키
공통 false -1003 유효하지 않은 SMS 발신 번호
공통 false -1004 이미 등록된 플러스친구
공통 false -1005 플러스친구 10명 초과하여 등록 요청할 경우
공통 false -1008 플러스친구 토큰 등록 실패
공통 false -1009 첨부 파일 업로드 실패
공통 false -1014 유효하지 않은 사업자등록 번호
공통 false -1016 메시지를 찾을 수 없을 경우
공통 false -1017 일별 발송량을 초과한 발송 실패
공통 false -1018 사업자등록증 파일이 존재하지 않을 경우
공통 false -2016 수신자 1,000명 초과하여 발송 요청할 경우
공통 false -2017 존재하지 않는 플러스친구
공통 false -2018 유효하지 않은 버튼 파라미터
공통 false -2019 템플릿 본문 1,000글자 초과로 실패
공통 false -2000 특정 필드값이 최대 길이보다 클 경우
공통 false -2001 특정 필드값이 공백일 경우
공통 false -2002 특정 필드값이 NULL일 경우
공통 false -2003 특정 필드값이 최소 길이보다 작을 경우
공통 false -2020 버튼명 14글자 초과로 실패
공통 false -2021 모바일 링크/웹 링크(limkMo/linkPc) 100글자 초과로 실패
공통 false -2022 이미지를 첨부하였는데 이미지링크(imageLink)를 입력하지 않은 경우
공통 false -2023 친구톡 메시지 본문이 400글자 초과할 경우(이미지 첨부)
공통 false -2024 친구톡 메시지 본문이 1,000글자 초과할 경우
공통 false -2025 예약 일시가 과거의 일시일 경우
공통 false -2026 예약 일시가 90일 이후의 일시일 경우(최대 90일까지 가능)
공통 false -2027 날짜 포맷이 달라 파싱 오류 발생
공통 false -2028 유효하지 않은 요청 ID
공통 false -2029 요청한 메시지가 없거나, 취소할 수 있는 메시지가 없는 경우
공통 false -2502 발송 실패 설정이 되어 있지 않고, 대체 발송을 요청했을 경우
공통 false -2999 발송 요청한 모든 수신자 요청 실패
공통 false -3000 자유 버튼 타입의 템플릿일 경우, 버튼명/모바일 링크(linkMo)는 필숫값입니다.
공통 false -3001 이미 존재하는 템플릿 코드 또는 템플릿명
공통 false -3002 필요한 요청 본문(request body) 내용을 읽을 수 없을 경우
공통 false -3003 존재하는 않는 템플릿
공통 false -3004 발송할 템플릿 파라미터 오류
공통 false -3005 템플릿 상태 오류(승인 전 발송 요청 시)
공통 false -3006 버튼 URL은 반드시 http:// 또는 https://를 포함해야 합니다.
공통 false -3007 자유 버튼 타입의 템플릿만 버튼명과 버튼 URL 입력 가능합니다.
공통 false -3008 배송 조회 버튼 타입은 버튼 URL을 입력할 수 없습니다.
공통 false -3009 버튼명이 존재하지 않습니다.
공통 false -3010 템플릿 본문이 일치하지 않습니다.
공통 false -3011 템플릿 버튼이 존재하지 않습니다.
공통 false -3100 템플릿 문의 가능한 상태가 아닐 경우
공통 false -4003 조회 범위는 한 달 초과
공통 false -4004 존재하지 않는 앱키
공통 false -4005 사용 종료 상태의 앱키
공통 false -4006 기본 발신 프로필이 등록되지 않은 앱키
공통 false -4007 파일 사이즈 500KB 초과
공통 false -4015 유효하지 않은 요청 ID(requestId)
공통 false -4016 요청한 값에 대응되는 데이터가 없는 경우
공통 false -4100 유효하지 않은 조회 기간 오류
공통 false -4101 유효하지 않은 통계 조회 파라미터
공통 false -4103 조회 시, 발송 요청 시작 시간/발송 요청 끝 시간값이 없을 경우
공통 false -5000 유효하지 않은 수신 번호
공통 false -5001 발송 시, 수신자 목록가 없을 경우
공통 false -7000 벤더 요청 API 실패
공통 false -8000 이미지 시퀀스(imageSeq)가 없는 경우
공통 false -8001 이미지 파일이 정상적이지 않은 경우
공통 false -8002 이미지 시퀀스(imageSeq)에 대응하는 이미지가 없는 경우
공통 false -8003 이미지 삭제에 실패하는 경우
공통 false -8005 이미지 업로드 시 프로젝트에 등록된 플러스친구가 없는 경우
공통 false -9995 fade-out된 버전의 API를 호출했을 경우
공통 false -9996 Content-type이 application/json가 아닐 경우
공통 false -9998 존재하지 않는 API
공통 false -9999 시스템 오류

ATA V.1.0.9 전송 결과 코드

  • ATA Version : ATA V1.0.9 이상
코드값 의미
1000 성공
1001 Server Busy(RS 내부 저장 Queue Full)
1002 수신 번호 형식 오류
1003 회신 번호 형식 오류
1009 CLIENT_MSG_KEY 없음
1010 CONTENT 없음
1012 RECIPIENT_INFO 없음
1013 SUBJECT 없음
1018 전송 권한 없음
1019 TTL 초과
1020 charset conversion error
1099 인증 실패
2000 전송 시간 초과
2001 메시지 전송 불가(예기치 않은 오류 발생)
3009 메시지 형식 오류
3014 알 수 없는 메시지 상태
3015 msg_type 오류(1008 또는 1009가 아닌 경우)
3023 메시지 문법 오류(JSON 형식 오류)
3024 발신 프로필 키가 유효하지 않음
3025 메시지 전송 실패(테스트 시, 친구 관계가 아닌 경우)
3026 메시지와 템플릿의 일치성 확인 시 오류 발생
3027 카카오톡을 사용하지 않는 사용자(전화번호 오류/050 안심번호)
3029 메시지가 존재하지 않음
3030 메시지 일련번호가 중복됨
3031 메시지가 비어 있음
3032 메시지 길이 제한 오류(공백 포함 1000 자)
3033 템플릿을 찾을 수 없음
3034 메시지가 템플릿과 일치하지 않음
3040 허브 파트너 키가 유효하지 않음
3041 Request Body에서 Name을 찾을 수 없음
3042 발신 프로필을 찾을 수 없음
3043 삭제된 발신 프로필
3044 차단 상태의 발신 프로필
3045 차단 상태의 플러스친구
3046 닫힘 상태의 플러스친구
3047 삭제된 플러스친구
3048 계약 정보를 찾을 수 없음
3049 내부 시스템 오류로 메시지 전송 실패
3050 카카오톡을 사용하지 않는 사용자
72시간 이내에 카카오톡 사용 이력이 없는 사용자 알림톡 차단을 선택한 사용자
친구톡의 경우 친구가 아닌 경우
3051 메시지가 발송되지 않은 상태
3054 메시지 발송 가능한 시간이 아님
3055 메시지 그룹 정보를 찾을 수 없음
3056 메시지 전송 결과를 찾을 수 없음
3060 사용자에게 발송하였으나 수신 여부 불투명(Polling)
9998 시스템에 문제가 발생하여 담당자가 확인 중(현재 서비스 제공 중이 아님)
9999 시스템에 문제가 발생하여 담당자가 확인 중(시스템에 알 수 없는 오류 발생)
E900 전송키가 없는 경우
E901 수신 번호가 없는 경우
E903 제목 없는 경우
E904 메시지가 없는 경우
E905 회신 번호가 없는 경우
E906 메시지 키가 없는 경우
E915 중복 메시지
E916 인증서버 차단 번호
E917 고객DB 차단 번호
E918 USER CALLBACK FAIL
E919 발송 제한 시간인 경우, 메시지 재발송 처리가 금지된 경우
E920 서비스 타입이 알림톡인 경우, 메시지 테이블에 파일 그룹 키가 있는 경우
E999 기타 오류
TOP