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 -4200 유효하지 않은 대체 발송 메시지
공통 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 시스템 오류

발송 결과 코드

코드값 의미
1000 성공
1001 Server Busy(RS 내부 저장 Queue Full)
1002 수신 번호 형식 오류 (통신사 미가입자)
1003 발신 프로필 키가 유효하지 않음
1004 Request Body(JSON)에서 name을 찾을 수 없음
1006 삭제된 발신 프로필(고객센터에게 문의)
1007 차단 상태의 발신 프로필(고객센터에게 문의)
1011 계약 정보를 찾을 수 없음(고객센터에게 문의)
1012 잘못된 형식의 사용자키 요청
1013 유효하지 않은 앱 연결
1014 유효하지 않은 사업자번호
1015 유효하지 않은 app user id 요청
1016 사업자등록번호 불일치
1021 차단 상태의 카카오톡 채널
1022 차단 상태의 카카오톡 채널
1023 삭제된 카카오톡 채널
1024 삭제 대기 상태의 카카오톡 채널
1025 메시지 차단 상태의 카카오톡 채널
1030 잘못된 파라미터 요청
2000 전송 시간 초과
2001 메시지 전송 불가(예기치 않은 오류 발생)
2004 템플릿 일치 확인 시 오류 발생(내부 오류 발생)
3000 예기치 않은 오류 발생
3005 메시지를 발송했으나 수신 확인이 안 됨(성공 불확실, 서버에는 암호화되어 보관되며 3일 이내 수신 가능)
3006 내부 시스템 오류로 메시지 전송 실패
3008 전화번호 오류
3009 메시지 형식 오류
3010 예기치 않은 오류 발생
3011 메시지가 존재하지 않음
3012 메시지 일련번호가 중복됨
3013 메시지가 비어 있음
3014 알 수 없는 메시지 상태
3015 템플릿을 찾을 수 없음
3016 메시지 내용이 템플릿과 일치하지 않음
3018 메시지를 전송할 수 없음
3023 메시지 문법 오류(JSON 형식 오류)
3024 발신 프로필 키가 유효하지 않음
3025 변수 글자 수 제한 초과
3026 메시지와 템플릿의 일치성 확인 시 오류 발생
3027 카카오톡을 사용하지 않는 사용자(전화번호 오류/050 안심번호)
3028 메시지 강조 표기 타이틀이 템플릿과 일치하지 않음
3029 메시지 강조 표기 타이틀 길이 제한 초과(50자)
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)
4000 메시지 전송 결과를 찾을 수 없음
4001 알 수 없는 메시지 상태
9998 시스템에 문제가 발생하여 담당자가 확인 중(현재 서비스 제공 중이 아님)
9999 시스템에 문제가 발생하여 담당자가 확인 중(시스템에 알 수 없는 오류 발생)
E900 전송키가 없는 경우
E901 수신 번호가 없는 경우
E903 제목 없는 경우
E904 메시지가 없는 경우
E905 회신 번호가 없는 경우
E906 메시지 키가 없는 경우
E915 중복 메시지
E916 인증서버 차단 번호
E917 고객DB 차단 번호
E918 USER CALLBACK FAIL
E919 발송 제한 시간인 경우, 메시지 재발송 처리가 금지된 경우
E920 서비스 타입이 알림톡인 경우, 메시지 테이블에 파일 그룹 키가 있는 경우
E999 기타 오류
TOP