| 구분 | 코드 | 메시지 | 설명 |
|---|---|---|---|
| K | K000 | 카카오 비즈메시지 발송 성공 | |
| K101 | NotAvailableSendMessage | 수신불가 사용자 알림톡/브랜드메시지 수신이 가능한 사용자 조건은 아래와 같으며, 아래 조건에 해당하지 않는 경우 수신불가 사용자로 판단되어 알림톡/브랜드메시지 발송에 실패됩니다. - 카카오톡채널 친구추가 되어 있는 사용자 (브랜드메시지만 해당) - 서버와 연결되어 있는 카카오톡 사용자 - 발송 당일 가입한 사용자를 제외한 최근 7일(168시간) 내에 카카오톡을 사용한 사용자 |
|
| K102 | InvalidPhoneNumber | 전화번호 오류 | |
| K103 | OverLimitMessageLength |
메시지 길이제한 오류 * 알림톡 텍스트/이미지 타입 : 1,000자 초과 * 알림톡 아이템리스트 타입 : 1,000자 초과 (아이템리스트 설정시, 700자 초과) * 브랜드메시지 텍스트 타입 : 1,300자 초과 * 브랜드메시지 이미지 타입 : 400자 초과 * 브랜드메시지 이미지 와이드형 타입 : 76자 초과 |
|
| K104 | TemplateNotFound | 템플릿을 찾을 수 없음 | |
| K105 | NoMatchedTemplate |
메시지 내용이 템플릿과 일치하지 않음 * 템플릿 내용의 고정문구(변수, 줄바꿈, 공백 제외) 및 템플릿 버튼의 고정문구(변수 제외)가 모두 일치해야 함 |
|
| K106 | InvalidImage | 첨부 이미지 URL 또는 링크 정보가 올바르지 않음 | |
| K107 | TalkUserIdNotFound | 유효하지 않은 app user id 요청 | |
| K108 | NoMatchedTemplateButtonException | 메시지 버튼/바로연결이 템플릿과 일치하지 않음 | |
| K109 | NoMatchedTemplateTitleException | 메시지 강조 표기 타이틀이 템플릿과 일치하지 않음 | |
| K110 | ExceedMaxTitleLengthException | 메시지 강조 표기 타이틀 길이 제한 초과 (50자) | |
| K111 | NoMatchedTemplateWithMessageTypeException | 메시지 타입과 템플릿 강조유형이 일치하지 않음 | |
| K112 | InvalidUserKeyException | 잘못된 형식의 유저키 요청 | |
| K113 | InvalidAppLink | 유효하지 않은 app연결 | |
| K114 | InvalidBizNum | 유효하지 않은 사업자번호 | |
| K115 | MessageEmptyException | 메시지가 비어 있음 | |
| K119 | MessageNoUserException | 톡 유저가 아님 | |
| K120 | MessageUserBlockedAlimtalkException | 알림톡 수신 차단 | |
| K121 | MessageNotSupportedKakaotalkException | 카카오톡 최소 버전 미지원 | |
| K125 | FailedToReadImageException | 카카오 내부 시스템 오류로 이미지 정보를 읽어오는데 실패함 | |
| K128 | UnableUseTargeting | 해당 타겟팅 옵션 사용할 수 없음 | |
| K130 | NoMatchedMessageTypeParameterException | 템플릿 메시지 타입과 chat_bubble_type 파라미터 불일치 | |
| K131 | NoMatchedTemplateHeaderException | 헤더가 템플릿과 일치하지 않음 | |
| K132 | ExceedMaxHeaderLengthException | 헤더 길이 제한 초과(16자) | |
| K133 | NoMatchedTemplateItemHighlightException | 아이템 하이라이트가 템플릿과 일치하지 않음 | |
| K134 | ExceedMaxItemHighlightTitleLengthException | 아이템 하이라이트 타이틀 길이 제한 초과(이미지 없는 경우 30자, 이미지 있는 경우 21자) | |
| K135 | ExceedMaxItemHighlightDescriptionLengthException | 아이템 하이라이트 디스크립션 길이 제한 초과(이미지 없는 경우 19자, 이미지 있는 경우 13자) | |
| K136 | NoMatchedTemplateItemListException | 아이템 리스트가 템플릿과 일치하지 않음 | |
| K137 | ExceedMaxItemDescriptionLengthException | 아이템 리스트의 아이템의 디스크립션 길이 제한 초과(23자) | |
| K138 | NoMatchedTemplateItemSummaryException | 아이템 요약정보가 템플릿과 일치하지 않음 | |
| K139 | ExceedMaxItemSummaryDescriptionLengthException | 아이템 요약정보의 디스크립션 길이 제한 초과(14자) | |
| K140 | InvalidItemSummaryDescriptionException | 아이템 요약정보의 디스크립션에 허용되지 않은 문자 포함(통화기호/코드, 숫자, 콤마, 소수점, 공백을 제외한 문자 포함) | |
| K150 | MessageNotSupportedUnsubscribeException | 말풍선 N타입(비친구) 버전 미지원 | |
| K200 | InvalidSenderKey | 발신 프로필 키가 유효하지 않음 | |
| K201 | DeletedSender | 삭제된 발신프로필 | |
| K202 | StoppedSender | 차단 상태의 발신프로필 | |
| K203 | BlockedProfile | 차단 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| K204 | DeactivatedProfile | 닫힘 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| K205 | DeletedProfile | 삭제된 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| K206 | DeletingProfile | 삭제대기 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| K207 | SpammedProfile | 메시지차단 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| K208 | InvalidParameterException | 잘못된 파라메터 요청 (링크버튼, 아이템리스트 등 전송항목 형식 오류) | |
| K209 | NoValueJsonElement | json에서 name/value를 찾을 수 없음 | |
| K210 | MessageSpammedProfileException | 채널 메시지 제재 상태로 인한 메시지 전송 실패 (카카오톡 채널 운영툴에서 확인) | |
| K220 | InvalidReceiveUser | 전화번호 or app user id가 유효하지 않거나 미입력 요청 | |
| K301 | FailedToSendMessageByNoFriendshipException | 메시지 전송 실패(테스트 서버에서 친구관계가 아닌 경우) | |
| K302 | FailedToMatchTemplateException | 템플릿 일치 확인시 오류 발생 | |
| K303 | NoSendAvailableTimeException | 메시지 발송 가능한 시간이 아님(브랜드메시지 / 마케팅 메시지는 08시부터 20시 50분까지 발송 가능) | |
| K304 | ExceedMaxVariableLengthException | 변수 글자수 제한 초과 | |
| K306 | Button chat_extra(event)-InvalidExtra(EventName)Exception '([A-Za-z0-9_]{1,50}) | 상담/봇 전환 버튼 extra, event 글자수 제한 초과 | |
| K308 | NoMatchedTemplateRepresentLinkException | 대표링크가 템플릿과 일치하지 않음 | |
| K309 | MessageInvalidWideItemListLengthException | 와이드 아이템 리스트 갯수 최대 최소 갯수 불일치 | |
| K310 | InvalidateCarouselItemMinException | 캐러셀 아이템 리스트 갯수 최소, 최대 갯수 불일치 | |
| K311 | CarouselMessageLengthOverLimitException | 캐러셀 아이템 메시지 길이 OVER | |
| K312 | MessageInvalidVideoException | 메시지에 포함된 비디오를 전송할 수 없음(비디오 주소 또는 썸네일 이미지 주소가 올바르지 않거나 썸네일 이미지가 규격에 맞지 않음) | |
| K313 | ExceedMaxAdditionalContentLengthException | 부가 정보 최대 길이 제한 오류 | |
| K314 | ExceedMaxCommerceTitleLengthException | 커머스 정보 상품명 최대 길이 제한 오류 | |
| K315 | WideItemListTitleLengthOverLimitException | 와이드 아이템 리스트 타이틀 길이 제한 오류 | |
| K316 | CarouselHeaderLengthOverLimitException | 캐러셀 헤더 길이 제한 오류 | |
| K317 | 캐러셀 템플릿 불일치 | ||
| K318 | 캐러셀 버튼 템플릿 불일치 | ||
| K319 | 캐러셀 쿠폰 템플릿 불일치 | ||
| K320 | 캐러셀 커머스 템플릿 불일치 | ||
| K343 | NoMatchedTemplateImageVariableException | 이미지 변수 개수 템플릿 불일치 | |
| K344 | NoMatchedTemplateCouponVariableException | 커머스 쿠폰 변수 템플릿 불일치 | |
| K345 | NoMatchedTemplateCommerceException | 커머스 정보 변수 템플릿 불일치 | |
| K400 | ResponseHistoryNotFoundException | 메시지 전송 결과를 찾을 수 없음 | |
| K401 | UnknownMessageStatusError | 알 수 없는 메시지 상태 | |
| K402 | 입력값 오류 발생 | ||
| K403 | Request Body Parsing Error | ||
| K412 | Template 요청 오류 | ||
| K414 | 유효한 발신프로필을 찾을 수 없음 | ||
| K415 | 유효하지 않은 챗버블 타입 또는 메시지 타입 요청 | ||
| K420 | 메시지 요청 페이로드 생성 오류 | ||
| K421 | 메시지 발송 대상 오류 | ||
| K422 | 메시지 결과 조회 오류 | ||
| K443 | 만료된 요청 | ||
| K470 | 동보 발송 요청 실패 | ||
| K471 | 동보 발송 요청을 찾을 수 없음 | ||
| K472 | 동보 발송 요청 상태를 변경할 수 없음 | ||
| K480 | 유효한 친구 그룹을 찾을 수 없음 | ||
| K481 | 유효하지 않은 친구 그룹 파일 | ||
| K482 | 이미 생성된 친구 그룹 | ||
| K483 | 유효하지 않은 친구 그룹 | ||
| K500 | InvalidTestUser | (테스트발송) 관리자 혹은 일회성 인증을 받은 사용자가 아님 | |
| K501 | DailyTestLimitExceeded | (테스트 발송) 일일 발송량 초과 | |
| K990 | 광고성메시지(브랜드메시지)에서 문제가 발생했습니다. | ||
| K997 | ResponseTimeoutException | 결과 대기시간 지남(성공 불확실) | |
| K998 | FailedToSendMessageException | 기타 오류로 메시지 전송 실패 | |
| K999 | UnknownException | 시스템 오류 | |
| M | M000 | SMS/LMS 발송 성공 | |
| M001 | ProcessingMessageSend | SMS 발송 처리 중 | |
| M101 | NotAvailableSendMessage | 메시지를 전송할 수 없음(connect failed) | |
| M102 | InvalidPhoneNumber | 전화번호 오류 | |
| M103 | DoNotDisturb | 수신자 착신거부 | |
| M104 | SpamMessage | 스팸 번호로 등록 됨 | |
| M105 | TurnOff | 수신자 단말기 전원 꺼짐 | |
| M106 | OverLimitMessageLength | 메시지 길이제한 오류 * SMS: 90 byte * LMS: 2,000 byte * MMS: 2,000 byte |
|
| M107 | DeniedSenderNumber | 미등록된 SMS 발신번호 | |
| M108 | InvalidImgUrl | 이미지 URL 누락 | |
| M120 | SmsInvalidParams | 문자발송 파라메터 누락 | |
| M121 | SmsEmojiText | 문자 메시지에 이모지 포함되어 있음 | |
| M122 | SmsEmojiSubject | LMS/MMS 문자 제목에 이모지 포함되어 있음 | |
| M127 | SmsSendTimeLimit | 광고성 문자메시지 발송 가능한 시간이 아님(08시부터 20시 50분까지 발송 가능) | |
| M128 | SmsServerInternalError | 문자발송 서버 내부 오류 | |
| M129 | SmsServerUnknownError | 문자발송 서버 알수없는 오류 | |
| M200 | 기대하지 않은 Head 또는 헤더필드 부적절함 | ||
| M201 | Body 필드의 부적절 | ||
| M202 | 규격 오류 | ||
| M203 | 발/착신 번호 에러 | ||
| M204 | 컨텐츠 크기 오류 | ||
| M205 | 컨텐츠 크기 초과 | ||
| M206 | 첨부파일 개수 오류 | ||
| M207 | 지원하지 않는 컨텐츠 존재 | ||
| M208 | 컨텐츠 관련 기타 | ||
| M209 | 시리얼넘버 오류(크기 초과등) | ||
| M210 | 잘못된 메시지 타입 | ||
| M211 | 동보 전송수 초과 | ||
| M212 | 초당 처리 건수 초과 | ||
| M300 | 일발송량 초과 | ||
| M301 | 월발송량 초과 | ||
| M302 | 발송제한시간 | ||
| M303 | 잔액 부족 | ||
| M304 | 중복발송- sn+da 중복 | ||
| M305 | 요청시간 오류 – pcclient에서 사용 | ||
| M306 | 전화번호 세칙 미준수 발신번호 사용 | ||
| M307 | 사전 미등록 발신번호 사용 | ||
| M308 | 발신번호 변작으로 등록된 발신번호 사용 | ||
| M309 | 번호도용문자차단서비스에 가입된 발신번호 사용 | ||
| M400 | 라우팅 정보 없음 | ||
| M403 | 메시지 크기 초과 | ||
| M404 | 실시간 전송 실패 | ||
| M405 | Gw자체 expired: 리포트 미수신 | ||
| M406 | Gw자체 expired: 미전송 | ||
| M407 | 첨부파일 관련 에러 | ||
| M408 | 기타 | ||
| M409 | 발신번호 스팸 | ||
| M504 | 이통사 expired | ||
| M505 | 착신가입자 없음 | ||
| M507 | 음영지역 | ||
| M508 | 단말 수신용량 초과 | ||
| M509 | MMS를 미 지원 단말 | ||
| M510 | 미 지원 단말 | ||
| M511 | 무응답 및 통화중 | ||
| M512 | 번호이동 | ||
| M513 | NPDB 에러(수신자 번호 등록 안됨, 번호 이동중) | ||
| M514 | 이통사의 컨텐츠에러 | ||
| M515 | 이통사 전화번호 세칙 미준수 발신번호 사용 | ||
| M516 | 이통사 사전 미등록 발신번호 사용 | ||
| M517 | 이통사 발신번호 변작으로 등록된 발신번호 사용 | ||
| M518 | 이통사 번호도용문자차단서비스에 가입된 발신번호 | ||
| M519 | 이통사 기타 | ||
| M520 | 가입자 일시정지 | ||
| M701 | 일시적 용량초과 | ||
| M703 | 중지된 고객 | ||
| M704 | 미등록 고객 | ||
| M705 | 이미 연결됨 | ||
| M706 | 미지원 버전 | ||
| M707 | sms 발송 권한 없음 | ||
| M708 | mms 발송 권한 없음 | ||
| M709 | isms 발송 권한 없음 | ||
| M710 | 네트웍 에러 발생 | ||
| M711 | 바인드 되지 않음 | ||
| M712 | 암호화 에러 | ||
| M713 | 복호화 에러 | ||
| M714 | 발송권한 없음 | ||
| M800 | 첨부 불가능한 확장자 | ||
| M801 | 파일 사이즈가 0 또는 일정 크기 초과 | ||
| M803 | 발송 번호 block 테이블에 등록된 상태 | ||
| M804 | 내용 및 제목의 한글 인코딩 오류 | ||
| M805 | 착신 번호의 번호 유효성 오류 | ||
| M806 | SMS/LMS 경우 내용이 없거나 LMS 2000byte 이상인 경우 | ||
| M807 | 지정한 파일이 없을 경우, HTTP/FTP로 파일을 가져오지 못하는 경우 | ||
| M808 | 회신 번호 미입력시 – NEW | ||
| M809 | 첨부 파일 개수 3개 초과 | ||
| M811 | 착신번호 복호화 오류 | ||
| M812 | 발신번호 복호화 오류 | ||
| M813 | 메시지 내용 복호화 오류 | ||
| M900 | 발송요청이 지정한 시간보다 오래된 경우 | ||
| M901 | 지정시간 리포트 미수신 실패 처리 | ||
| M990 | 발송요청이 지정한 시간보다 오래된 경우 | ||
| M998 | ReportTimeoutException | 이동통신사 결과 수신 시간 초과 | |
| M999 | UnknownException | 기타 시스템 오류 | |
| E | E100 | InvalidJsonArray | Request 데이터 오류 (json array 형식이 아닌 json object로 요청) |
| E101 | InvalidData | Request 데이터 오류 (올바르지 않은 json 형식, json 파싱오류) | |
| E102 | InvalidProfileKey | 발신 프로필 키가 없거나 유효하지 않음 | |
| E103 | EmptyTemplateCode | 템플릿 코드가 없음 | |
| E104 | InvalidPhoneNumber | 유효하지 않은 사용자 전화번호 (전화번호 형식 오류, 안심번호 등) | |
| E105 | InvalidSenderNumber | 유효하지 않은 SMS 발신번호 (전화번호 형식 오류, 안심번호 등) | |
| E106 | EmptyMessage | 메시지 내용이 없음 | |
| E107 | SMSEmptyMessage | 카카오 발송 실패시 SMS 전환 발송을 하는 경우 SMS 메시지 내용이 없음 | |
| E108 | InvalidReservationDate | 예약일자 이상(잘못된 예약일자 요청) | |
| E109 | DuplicatedMsgId | 중복된 MsgId 요청 | |
| E110 | RequestMsgIdNotFound | MsgId를 찾을 수 없음 | |
| E111 | RequestImgNotFound | 첨부 이미지 URL 정보를 찾을 수 없음 | |
| E112 | OverLimitMessageLength | 메시지 길이제한 오류(메시지 제한길이 또는 1,000자 초과) | |
| E113 | InvalidMsgIdLength | 메시지ID 길이제한 오류(메시지ID 없음 또는 20자 초과) | |
| E114 | DeletedSender | 삭제된 발신프로필 | |
| E115 | StoppedSender | 차단 상태의 발신프로필 | |
| E116 | BlockedProfile | 차단 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| E117 | DeactivatedProfile | 닫힘 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| E118 | DeletedProfile | 삭제된 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| E119 | DeletingProfile | 삭제대기 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) | |
| E120 | InvalidSMSProfile | 발신프로필 문자발송 설정 안됨 | |
| E121 | ItemsNotJsonFormat | ITEMS 잘못된 Json 형식 | |
| E122 | ItemsLengthOverLimit | ITEMS 문자열 길이 1000자 초과 | |
| E123 | HeaderLengthOverLimit | HEADER 문자열 길이 초과 (알림톡 16자, 브랜드메시지 25자) | |
| E124 | InvalidButtonJsonObject | button1~button5 중 json object가 아닌 버튼이 존재함 | |
| E125 | InvalidSMSKind | smsKind 유효성 오류 | |
| E126 | BadWordInMessage | 사용불가 단어(금칙어)가 포함되어 있음 | |
| E127 | InvalidSmsSenderCode | 유효하지 않은 문자메시지 사업자 식별코드(9자리) | |
| E128 | InvalidCommerceInputValueType | commerce 속성 내 데이터 타입 또는 값이 올바르지 않음 (API 문서 확인) | |
| E129 | InvalidMessageType | 잘못된 메시지타입 | |
| E130 | InvalidHostUrl(Check the Host URL in the Alimtalk-API manual) | 잘못 접근한 Host Url. 메뉴얼의 host 주소를 확인해주세요. | |
| E998 | OverLimitRequest | 최대 요청 수 초과 | |
| E999 | UnknownException | 시스템 오류 | |
| R | R000 | 발송 예약 성공 | |
| R109 | DuplicatedMsgid | 중복된 MsgId 요청 |