AGENT 결과 코드
카카오
1000
전송 성공
정상 발송 완료
100F
전송 성공(브랜드 메시지)
브랜드 메시지 발송 성공 (2026년부터 친구관계 발송 성공 시 리턴)
100N
전송 성공(비친구)
브랜드 메시지 비 친구관계 발송 성공 (2026년부터 리턴)
1001
형식 오류
Request Body가 Json 형식이 아님
1003
프로필 키 오류
발신 프로필 키가 유효하지 않음
1004
파라미터 누락
Request Body(Json)에서 name을 찾을 수 없음
1006
프로필 삭제
삭제된 발신프로필
1007
프로필 차단
차단 상태의 발신프로필
1011
계약 정보 없음
계약정보를 찾을 수 없음
1012
유저키 형식 오류
잘못된 형식의 유저키 요청
1013
앱 연결 오류
유효하지 않은 app 연결
1014
사업자번호 오류
유효하지 않은 사업자번호
1015
앱 유저 ID 오류
유효하지 않은 app user id 요청
1016
사업자번호 불일치
사업자등록번호 불일치
1020
수신처 정보 오류
전화번호 또는 app user id가 유효하지 않거나 미입력
1021
채널 차단
차단 상태의 카카오톡 채널
1022
채널 닫힘
닫힘 상태의 카카오톡 채널
1023
채널 삭제
삭제된 카카오톡 채널
1024
채널 삭제대기
삭제대기 상태의 카카오톡 채널
1025
메시지 차단
메시지차단 상태의 카카오톡 채널
1026
응답 방식 오류
해당 messageType에서 사용할 수 없는 response_method 요청 (이미지알림톡 실시간 불가)
1027
채널 제재
채널 메시지 제재 상태로 인한 전송 실패
1028
타겟팅 옵션 오류
해당 타겟팅 옵션을 사용할 수 없음
1030
파라미터 요청 오류
이미지형 타입 누락, 아이템 리스트 오류, 브랜드 메시지 변수/버튼/링크 오류 등
1033
타입 불일치
템플릿 메시지 유형과 발송 메시지 타입 파라미터 불일치
2004
템플릿 확인 오류
템플릿 일치 확인 시 내부 오류 발생
2005
이미지 로드 실패
내부 시스템 오류로 이미지 정보를 읽어오는데 실패
3000
알 수 없는 오류
예기치 않은 오류 발생
3005
수신확인 불가
메시지를 발송했으나 수신확인 안됨 (성공불확실) 또는 미지원 스펙
3006
시스템 오류
내부 시스템 오류로 메시지 전송 실패
3008
번호 오류
전화번호 오류
3010
파싱 오류
Json 파싱 오류
3011
메시지 없음
메시지가 존재하지 않음
3012
일련번호 중복
메시지 일련번호(고유값) 중복
3013
메시지 빈 값
메시지 내용이 비어 있음
3014
길이 제한 초과
템플릿별 제한 길이 또는 1000자 초과
3015
템플릿 없음
등록된 템플릿을 찾을 수 없음
3016
템플릿 불일치
메시지 내용, 버튼명 등이 등록된 템플릿과 다름
3018
전송 불가 상태
브랜드 메시지 친구 아님, 차단 상태, 7일 내 카톡 미사용자 등
3019
미가입자
카카오톡 유저가 아님
3020
수신 차단
알림톡 수신 차단 상태
3021
버전 미지원
카카오톡 최소 버전 미지원
3022
발송 시간 아님
브랜드/마케팅 메시지 발송 가능 시간(08시~20시 50분) 외 요청
3023
비디오 전송 실패
비디오 주소, 썸네일 오류 또는 규격 불일치
3024
이미지 전송 실패
메시지에 포함된 이미지를 전송할 수 없음
3025
변수 길이 초과
변수 내용의 글자수 제한 초과
3026
버튼 제한 초과
상담/봇 전환 버튼 extra, event 글자수 제한 초과
3027
버튼 불일치
버튼내용 또는 바로연결 버튼이 템플릿과 불일치
3028
타이틀 불일치
강조 표기 타이틀이 템플릿과 불일치
3029
타이틀 길이 초과
강조 표기 타이틀 길이 제한 초과 (50자)
3030
타입 불일치
등록된 템플릿과 일치하지 않는 메시지 타입
3031
헤더 불일치
헤더 내용이 템플릿과 일치하지 않음
3032
헤더 길이 초과
헤더 길이 제한 초과 (16자)
3033
하이라이트 불일치
아이템 하이라이트가 템플릿과 일치하지 않음
3034
하이라이트 타이틀 초과
아이템 하이라이트 타이틀 길이 초과 (이미지 유무에 따라 21~30자)
3035
하이라이트 설명 초과
아이템 하이라이트 디스크립션 길이 초과 (이미지 유무에 따라 13~19자)
3036
아이템 리스트 불일치
아이템 리스트가 템플릿과 일치하지 않음
3037
아이템 설명 초과
아이템 리스트 디스크립션 길이 제한 초과 (23자)
3038
요약정보 불일치
아이템 요약정보가 템플릿과 일치하지 않음
3039
요약정보 설명 초과
아이템 요약정보 디스크립션 길이 제한 초과 (14자)
3040
허용되지 않은 문자
요약정보에 숫자, 통화기호 외 문자 포함
3041
리스트 개수 불일치
브랜드 메시지 와이드 아이템 리스트 개수 오류
3042
링크 불일치
대표링크가 템플릿과 일치하지 않음
3043
이미지 변수 오류
이미지 변수 개수 템플릿 불일치
3044
쿠폰 변수 오류
커머스 쿠폰 변수 템플릿 불일치
3045
커머스 변수 오류
커머스 정보 변수 템플릿 불일치
3046
부가정보 길이 초과
부가 정보 최대 길이 제한 오류
3047
상품명 길이 초과
커머스 정보 상품명 최대 길이 제한 오류
3048
그룹태그 오류
유효하지 않은 그룹태그
3050
수신동의거부 미지원
수신동의거부 스펙(타겟팅 N 타입) 미지원
3051
캐러셀 개수 오류
브랜드 메시지 캐러셀 아이템 리스트 개수 오류
3052
캐러셀 길이 초과
브랜드 메시지 캐러셀 아이템 메시지 길이 초과
3056
와이드 타이틀 오류
와이드 아이템 리스트 타이틀 길이 제한 오류
3058
캐러셀 헤더 오류
캐러셀 헤더 길이 제한 오류
3059
쿠폰 미지원
쿠폰 스펙 미지원
4000
값 오류
입력 값 오류 발생
4001
바디 파싱 에러
알 수 없는 메시지 상태 또는 요청 바디 파싱 에러
4102
템플릿 요청 오류
Template 요청 오류
4104
프로필 없음
유효한 발신프로필을 찾을 수 없음
4110
타입 요청 오류
유효하지 않은 메시지 타입 요청
4120
페이로드 생성 오류
메시지 요청 페이로드 생성 오류
4121
대상 오류
메시지 발송 대상 오류
4143
만료된 요청
요청 유효 시간 만료
9999
시스템 오류
알 수 없는 오류
B800
벤더사 요청 오류
Http 요청 오류 또는 벤더사 발송 요청 시 발생한 파라미터 오류
B801
벤더사 내부 오류
벤더사(대행사) 시스템 오류
ME09
수신 불투명
사용자에게 메시지를 발송했으나 수신여부 불투명
문자
1000
성공
정상적으로 전송 완료
4001
전송 시간 초과
타임아웃 발생
4002
통신사 내부 실패
무선망단 오류
4003
단말기 전원 꺼짐
수신자 휴대폰 꺼짐
4004
메시지 저장초과
단말기 메시지함 가득 참
4005
음영지역
수신 불가 지역
4006
메시지 삭제됨
전송 과정 중 삭제
4007
단말 문제
일시적인 단말기 오류
4008
전송 불가
기타 전송 불가 사유
4009
수신처 오류
잘못된 번호, 비가입자, 결번, 서비스 정지
4010
성인 인증 실패
성인 콘텐츠 인증 미통과
4011
번호 형식 오류
수신번호 형식 부정확
4012
서비스 정지
단말기 일시 정지 등
4013
호 처리 상태
단말기 통화 중 등 상태 오류
4014
착신 거절
수신자가 수신 거부
4015
메시지 형식 오류
규격에 맞지 않는 메시지
4016
MMS 미지원
단말기가 MMS를 수신할 수 없음
4017
통신사 스팸차단
번호/문구가 통신사 스팸 리스트에 등록됨
4018
서비스 거부
수신 서비스 거부 상태
4020
전송 경로 없음
전송 루트 미확보
4021
사이즈 오류
첨부파일 크기 제한 초과
4022
변작방지 위반
발신번호 변작방지 세칙 위반
4023
발신번호 보호
변작 방지 부가서비스 가입 번호 사용
4024
변작 번호 사용
변작으로 등록된 발신번호 사용
4025
정부 차단 번호
KISA/미래부 요청 차단 번호 사용
4026
인코딩 에러
Charset conversion error
4027
번호이동 에러
번호이동 정보 불일치
4028
과도한 발송
5초 내 동일 번호 4개 이상 거부
4029
번호 자리수 에러
착신번호 자리수 부정확
4030
없는 국번
착신번호 국번 오류
4032
미등록 발신번호
사전 미등록 발신번호 사용
4033
세칙 미준수
전화번호 세칙 미준수 번호 사용
4034
번호도용차단가입
번호도용문자차단서비스 가입 번호
4038
컨텐츠 초과
컨텐츠 사이즈 및 개수 초과
4052
중복 차단
중복된 수신번호 접수 차단
4056
확장자 에러
MMS 이미지 jpg, jpeg만 가능
4060
광고 전송 제한
21시 이후 광고성 메시지 발송 제한
4061
광고 내용 제한
성인, 대출 등 제한 문구 포함
4062
야간발송차단
야간 발송 제한 시간대
4084
본문 길이 초과
메시지 본문 길이 제한 초과
4086
블랙리스트 차단
블랙리스트에 의한 차단
4227
요청 시간 초과
요청 시간 10분 초과
4231
API KEY 오류
잘못된 API_KEY 사용
4242
속도 제한 초과
발송 제한 속도 초과
4243
일 제한 초과
일 발송 제한 건수 초과
4245
잔액 부족
선불 충전 금액 부족
4264
수신거부 차단
SPAM 테이블에 등록된 메시지 차단
4439
통신사 큐 풀
통신사 전송 대기열 가득 참 (Que Full)
4990
시스템 에러
문자 통신사 시스템 에러
E203
이미지 크기 초과
이미지 최대 크기(300KB) 초과
E321
메시지 길이 초과
문자 길이 초과 (2000 bytes)
E703
변환 실패
EUC-KR 변환 실패 (지원하지 않는 특수문자/한글)
Last updated