코드표
API 코드, AGENT 코드, 코드 분석기를 한 곳에서 확인할 수 있습니다.
API 코드
API 코드는 공통부와 개별부를 함께 확인할 수 있는 코드표입니다.
공통 응답 코드는 공통부에서, 상품별 응답 코드는 개별부와 Report Code에서 확인할 수 있습니다.
HTTP Status Code
HTTP 통신 상태 코드 입니다.
| Code | Text | Description |
|---|---|---|
| 200 | OK | 성공 |
| 400 | Bad Request | 잘못된 요청 |
| 401 | Unauthorized | 권한 없음 |
| 403 | Forbidden | 금지됨 |
| 404 | Not Found | 찾을 수 없음 |
| 405 | Method Not Allowed | 허용되지 않은 방법 |
| 413 | Payload Too Large | 너무 큰 전송데이터 |
| 429 | Too Many Requests | 너무 많은 요청 |
| 500 | Internal Server Error | 내부 서버 오류 |
| 503 | Service Unavailable | 서비스를 이용할 수 없음 |
API Response Code
API요청 응답코드 입니다.
공통부
common 컨테이너의 "authCode", "authResult" 파라미터에서 확인할 수 있습니다.
| Code | Text | Category | Description | Korean Description |
|---|---|---|---|---|
| A000 | SUCCESS | Success | HTTP 2XX or application success | 성공 - 요청이 정상적으로 처리됨 |
| A100 | Failed | Application Error | General failure | 실패 - 일반적인 처리 실패 |
| A301 | Moved Permanently | 3XX Redirection | Permanent redirect | 영구 이동 - 페이지가 다른 주소로 완전히 이동됨 |
| A302 | Found | 3XX Redirection | Found | 찾음 - 페이지가 임시로 다른 위치에 있음 |
| A303 | See Other | 3XX Redirection | See other location | 다른 곳 보기 - 다른 페이지를 확인해야 함 |
| A304 | Not Modified | 3XX Redirection | Not modified | 수정되지 않음 - 요청한 내용이 변경되지 않음 |
| A307 | Temporary Redirect | 3XX Redirection | Temporary redirect | 임시 이동 - 페이지가 일시적으로 다른 곳에 있음 |
| A308 | Permanent Redirect | 3XX Redirection | Permanent redirect | 영구 이동 - 페이지가 영구적으로 다른 곳으로 이동됨 |
| A400 | Bad Request | 4XX Client Error | Invalid request | 잘못된 요청 - 요청 형식이 잘못됨 |
| A401 | Unauthorized | 4XX Client Error | Authentication required | 인증 필요 - 로그인이 필요함 |
| A403 | Forbidden | 4XX Client Error | Access forbidden | 접근 금지 - 권한이 없어 접근할 수 없음 |
| A404 | Not Found | 4XX Client Error | Resource not found | 찾을 수 없음 - 요청한 페이지나 파일이 존재하지 않음 |
| A405 | Method Not Allowed | 4XX Client Error | HTTP method not allowed | 허용되지 않은 방법 - 사용한 요청 방식이 지원되지 않음 |
| A406 | Not Acceptable | 4XX Client Error | Not acceptable | 허용되지 않음 - 요청한 형식을 처리할 수 없음 |
| A407 | Proxy Authentication Required | 4XX Client Error | Proxy authentication required | 프록시 인증 필요 - 중간 서버를 통한 인증이 필요함 |
| A413 | Request Entity Too Large | 4XX Client Error | Request payload too large | 요청이 너무 큼 - 전송하려는 데이터가 너무 큼 |
| A414 | Request URI Too Long | 4XX Client Error | Request URI too long | 주소가 너무 김 - 요청한 주소가 너무 길어서 처리할 수 없음 |
| A415 | Unsupported Media Type | 4XX Client Error | Unsupported media type | 지원되지 않는 파일 형식 - 업로드한 파일 형식이 지원되지 않음 |
| A500 | Internal Server Error | 5XX Server Error | Internal server error | 서버 내부 오류 - 서버에서 처리 중 오류가 발생함 |
| A501 | Not Implemented | 5XX Server Error | Feature not implemented | 구현되지 않음 - 요청한 기능이 아직 개발되지 않음 |
| A502 | Bad Gateway | 5XX Server Error | Bad gateway | 잘못된 게이트웨이 - 중간 서버에 문제가 있음 |
| A503 | Service Unavailable | 5XX Server Error | Service unavailable | 서비스 사용 불가 - 서버가 일시적으로 사용할 수 없음 |
| A504 | Gateway Timeout | 5XX Server Error | Gateway timeout | 게이트웨이 시간 초과 - 중간 서버 응답이 너무 늦음 |
| A511 | Network Authentication Required | 5XX Server Error | Network authentication required | 네트워크 인증 필요 - 네트워크 레벨에서 인증이 필요함 |
Response
{
"common": {
"authCode" :"A000",
"authResult" :"Success",
"infobankTrId": "헤더값 X-Infobank-Tracking-Id",
}
}
커뮤니케이션 API 코드
커뮤니케이션 API는 접수/검증 응답 코드와 전송 결과 코드를 함께 제공합니다.
개별부
data 컨테이너의 "code", "result", "resultMsg" 파라미터에서 확인할 수 있습니다.
| Http Status | Code | Result | Description |
|---|---|---|---|
| 200 | A000 | Success | 요청 성공 |
| 401 | A001 | Expired token | 만료된 토큰 |
| 403 | A002 | Invalid token | 토큰 권한 없음 |
| 400 | A010 | Cannot parse JSON | JSON을 파싱 할 수 없음 |
| 400 | A011 | Cannot mapping JSON | JSON을 매핑 할 수 없음 |
| 429 | A020 | Number of 'Ratelimit' exceeded | Ratelimit(TPS) 초과 |
| 500 | A910 | Internal server error | Internal server error |
| 503 | A920 | Server busy | 서비스 처리 일시적 불가 |
| 500 | A999 | Unknown error | 알려지지 않은 에러 |
| 401 | A100 | Invaild authentication information | 잘못된 인증 정보 |
| 403 | A110 | Blocked account | 차단된 계정 |
| 403 | A111 | Blocked account | 차단된 계정 |
| 403 | A113 | Invaild Expired Set Value | 유효하지 않은 Expired Set Value |
| 400 | A200 | Oversize attached file | 파일 크기 초과 |
| 400 | A201 | Overlength the image title | 이미지명 길이 초과 |
| 400 | A202 | Invaild file | 사용할 수 없는 파일 |
| 400 | A203 | Invalid Image resolution | 유효하지 않은 이미지해상도 |
| 400 | A204 | Missing file in the request | 업로드된 파일이 없거나 잘못된 요청 |
| 400 | A205 | Invalid MediaType | 파일의 Content-Type과 실제 MIME 타입 불일치 |
| 400 | A206 | Unsupported file format | 지원하지 않는 파일 형식 |
| 400 | A207 | Invalid or Empty Content-Disposition | 유효하지 않거나 비어있는 Content-Disposition |
| 400 | A208 | Invalid or Empty fileName | 유효하지 않거나 비어있는 fileName |
| 400 | A213 | Wrong request | 잘못된 요청 |
| 500 | A214 | Failed to process image file | 이미지 파일 처리 실패 |
| 500 | A215 | Upload to Mobile carrier failed | 이동통신사 이미지 업로드 실패 |
| 400 | A217 | Invaild fileKey | 유효하지 않은 fileKey |
| 400 | A219 | Invalid serviceType | 유효하지 않은 serviceType |
| 400 | A220 | Invalid msgType | 유효하지 않은 msgType |
| 400 | A801 | No permission to POLLING API | 리포트 POLLING API 사용권한 없음 |
| 403 | A802 | Invalid Report ID | 유효하지 않는 Report ID |
| 400 | A300 | Wrong request | 잘못된 메시지 발송 요청 |
| 400 | A302 | Invalid or empty 'from' | 유효하지 않거나 비어있는 필드 (필드명 : from) |
| 400 | A303 | Invalid or empty 'text' | 유효하지 않거나 비어있는 필드 (필드명 : text) |
| 400 | A304 | Invalid or empty 'ttl' | 유효하지 않거나 비어있는 필드 (필드명 : ttl) |
| 400 | A305 | Invalid or empty 'ref' | 유효하지 않거나 비어있는 필드 (필드명 : ref) |
| 400 | A306 | Invalid or empty 'to' | 유효하지 않거나 비어있는 필드 (필드명 : to) |
| 400 | A312 | Invalid or empty 'fallback.type' | 유효하지 않거나 비어있는 필드 (필드명 : fallback.type) |
| 400 | A313 | Invalid or empty 'clientSubId' | 유효하지 않거나 비어있는 필드 (필드명 : clientSubId) |
| 400 | A314 | Invalid or empty 'fallback.text' | 유효하지 않거나 비어있는 필드 (필드명 : fallback.text) |
| 400 | A317 | Number of 'fallback.filekey' exceeded | fallback 메시지 파일 키 수(3건) 초과 |
| 400 | A318 | Number of 'to' exceeded | 발송 가능한 수신번호 수(200건) 초과 |
| 400 | A319 | Number of 'filekey' exceeded | 첨부 가능한 파일 키 수(3건) 초과 |
| 400 | A320 | Number of 'client message count' exceeded | 메시지 제한건수 여분 초과 |
| 400 | A322 | Spam filtering(text) | 스팸 차단(메시지 내용) |
| 400 | A323 | Spam filtering(from) | 스팸 차단(발신 번호) |
| 400 | A324 | Spam filtering(to) | 스팸 차단(수신 번호) |
| 400 | A325 | No permission 'Message-Send' | 발송채널 권한 없음 |
| 400 | A326 | No Permission 'fallback' | MT fallback 기능 권한 없음 |
| 400 | A327 | Not Allowed 'from' | 미등록 발신번호 |
| 400 | A328 | Length of 'text' exceeded | 최대 길이 초과 (필드명 : text) |
| 400 | A329 | Length of 'fallback.text' exceeded | 최대 길이 초과 (필드명 : fallback.text) |
| 400 | A401 | Invalid or empty 'paymentCode' | 유효하지 않거나 비어있는 필드 (필드명 : paymentCode) |
| 400 | A402 | Invalid or empty 'clientSubId' | 유효하지 않거나 비어있는 필드 (필드명 : clientSubId) |
| 400 | A403 | Invalid or empty 'transferTime' | 유효하지 않거나 비어있는 필드 (필드명 : transferTime) |
| 400 | A404 | Invalid or empty 'formatId' | 유효하지 않거나 비어있는 필드 (필드명 : formatId) |
| 400 | A406 | Invalid or empty 'RCS button' | 유효하지 않거나 비어있는 필드 (필드명 : RCS button) |
| 400 | A407 | Invalid or empty 'copyallowed' | 유효하지 않거나 비어있는 필드 (필드명 : copyallowed) |
| 400 | A408 | Invalid or empty 'expiryOption' | 유효하지 않거나 비어있는 필드 (필드명 : expiryOption) |
| 400 | A409 | Invalid or empty 'groupId' | 유효하지 않거나 비어있는 필드 (필드명 : groupId) |
| 400 | A411 | Invalid or empty 'header' | 유효하지 않거나 비어있는 필드 (필드명 : header) |
| 400 | A412 | Invalid or empty 'footer' | 유효하지 않거나 비어있는 필드 (필드명 : footer) |
| 400 | A413 | Invalid or empty 'agencyId' | 유효하지 않거나 비어있는 필드 (필드명 : agencyId) |
| 400 | A415 | Invalid or empty 'rcs.content' | 유효하지 않거나 비어있는 필드 (필드명 : rcs.content) |
| 400 | A417 | Number of 'Carousel card' exceeded | RCS Carousel Card 수 초과 |
| 400 | A418 | Invalid or empty 'agencyKey' | 유효하지 않거나 비어있는 필드 (필드명 : agencyKey) |
| 400 | A419 | Invalid or empty 'brandId' | 유효하지 않거나 비어있는 필드 (필드명 : brandId) |
| 400 | A420 | Invalid or empty 'brandKey' | 유효하지 않거나 비어있는 필드 (필드명 : brandKey) |
| 400 | A424 | Number of 'SubContent' exceeded | RCS subContent 수 초과 |
| 400 | A425 | buttons field is optional when using body field | body 필드를 사용할 때, buttons 필드는 선택 사항입니다. |
| 400 | A426 | Invalid or empty 'button.type' | 유효하지 않거나 비어있는 필드 (button.type) |
| 400 | A427 | Invalid or empty 'button.name' | 유효하지 않거나 비어있는 필드 (button.name) |
| 400 | A428 | Invalid or empty button.type 'MAP_LOC' | 유효하지 않거나 비어있는 필드 ('MAP_LOC' 버튼) |
| 400 | A429 | Invalid or empty button.type 'MAP_QRY' | 유효하지 않거나 비어있는 필드 ('MAP_QRY' 버튼) |
| 400 | A430 | Invalid or empty button.type 'CALENDAR' | 유효하지 않거나 비어있는 필드 ('CALENDAR' 버튼) |
| 400 | A431 | Invalid or empty button.type 'COPY' | 유효하지 않거나 비어있는 필드 ('COPY' 버튼) |
| 400 | A432 | Invalid or empty button.type 'COM_T' | 유효하지 않거나 비어있는 필드 ('COM_T' 버튼) |
| 400 | A433 | Invalid or empty button.type 'COM_V' | 유효하지 않거나 비어있는 필드 ('COM_V' 버튼) |
| 400 | A434 | Invalid or empty button.type 'DIAL' | 유효하지 않거나 비어있는 필드 ('DIAL' 버튼) |
| 400 | A501 | Invalid or empty 'responseMethod' | 유효하지 않거나 비어있는 필드 (responseMethod) |
| 400 | A502 | Invalid or empty 'senderKey' | 유효하지 않거나 비어있는 필드 (senderKey) |
| 400 | A503 | Invalid or empty 'button' | 유효하지 않거나 비어있는 필드 (button) |
| 400 | A505 | Invalid or empty 'templateCode' | 유효하지 않거나 비어있는 필드 (templateCode) |
| 400 | A506 | Invalid or empty 'adFlag' | 유효하지 않거나 비어있는 필드 (adFlag) |
| 400 | A513 | Invalid or empty 'image' | 유효하지 않거나 비어있는 필드 (image) |
| 400 | A521 | Invalid or empty 'item.title/description' | 유효하지 않거나 비어있는 필드 (item`s tltle/description) |
| 400 | A523 | Invalid or empty 'msgType' | 유효하지 않거나 비어있는 필드 (msgType) |
| 400 | A524 | Invalid or empty 'button.type' | 유효하지 않거나 비어있는 필드 (button.type) |
| 400 | A525 | Invalid or empty 'button.name' | 유효하지 않거나 비어있는 필드 (button.name) |
| 400 | A526 | Invalid or empty 'timeout' | 유효하지 않거나 비어있는 필드 (timeout) |
| 400 | A559 | Invalid or empty 'price' | 유효하지 않거나 비어있는 필드 (price) |
| 400 | A560 | Invalid or empty 'itemHighlight.title/description' | 유효하지 않거나 비어있는 필드 (item.title/description) |
| 400 | A561 | Invalid or empty 'item.summary' | 유효하지 않거나 비어있는 필드 (item.summary) |
| 400 | A562 | Invalid or empty 'supplement.quickReply' | 유효하지 않거나 비어있는 필드 (supplement.quickReply) |
| 400 | A563 | Invalid or empty 'supplement.quickReply.type' | 유효하지 않거나 비어있는 필드 (supplement.quickReply.type) |
| 400 | A564 | Invalid or empty 'supplement.quickReply.name' | 유효하지 않거나 비어있는 필드 (supplement.quickReply.name) |
| 400 | A565 | Invalid or empty 'header' | 유효하지 않거나 비어있는 필드 (header) |
| 400 | A567 | Invalid or empty 'carousel' | 유효하지 않거나 비어있는 필드 (carousel) |
| 400 | A568 | Wrong FC/FA request | 잘못된 친구톡 케로셀 요청 |
| 400 | A569 | Invalid or empty 'adult' | 유효하지 않거나 비어있는 필드 (adult) |
| 400 | A570 | Invalid or empty 'targeting' | 유효하지 않거나 비어있는 필드 (targeting) |
| 400 | A571 | Invalid or empty 'sendType' | 유효하지 않거나 비어있는 필드 (sendType) |
| 400 | A572 | Invalid or empty 'message' | 유효하지 않거나 비어있는 필드 (message) |
| 400 | A573 | Invalid or empty 'attachment' | 유효하지 않거나 비어있는 필드 (attachment) |
Report Code
메시지 전송 결과 코드 입니다.
| Code | Result |
|---|---|
| 10000 | 성공 : 단말기 메시지 정상 도착 |
| 90000 | 실패 : 내부구간 실패 |
| 99999 | 실패 : 알수 없는 에러 |
| 22000 | 전송 시간 초과 |
| 22001 | 전송 실패 (무선망단) |
| 22002 | 전송 실패 (무선망 -> 단말기단) |
| 22003 | 단말기 전원 꺼짐 |
| 22004 | 단말기 메시지 버퍼 풀 |
| 22005 | 음영지역 |
| 22006 | 메시지 삭제됨 |
| 22007 | 일시적인 단말 문제 |
| 23000 | 전송할 수 없음 |
| 23001 | 가입자 없음 |
| 23002 | 성인 인증 실패 |
| 23003 | 수신번호 형식 오류 |
| 23004 | 단말기 서비스 일시 정지 |
| 23005 | 단말기 호 처리 상태 |
| 23006 | 착신 거절 |
| 23008 | 기타 단말기 문제 |
| 23009 | 메시지 형식 오류 |
| 23010 | MMS 미지원 단말 |
| 23011 | 서버 오류 (이통사) |
| 23012 | 스팸 |
| 23013 | 서비스 거부 |
| 23014 | 기타 |
| 23015 | 전송 경로 없음 |
| 23016 | 첨부파일 사이즈 제한 실패 |
| 23018 | 휴대폰 가입 이동통신사를 통해 발신번호 변작 방지 부가 서비스에 가입된 번호를 발신번호로 사용하는 경우 |
| 23019 | KISA에서 모든 고객사에 대하여 차단 처리 요청된 번호를 발신번호로 사용하는 경우 |
| 23022 | Charset conversion error |
| 23023 | 국내 수신 메시지에 적용되는 발신번호가 발신번호 사전등록 번호가 아닌 경우 |
| 23025 | 24시간 이내 중복 발송 |
| 23029 | 광고 전송 제한 시간 발송 |
| 23030 | MMS MT Failover 첨부파일 처리가 실패한 경우 |
| 23031 | FAILOVER_TIMEOUTSEND 발송 안함 설정에 의해Failover 처리하지 않은 경우 |
| 23032 | FAILOVER(MT) 기능 사용 불가 계정 |
| 23033 | MT Failover Parameter Error |
| 23034 | Invalid MMS MT File Key |
| 23035 | 해당 통신사 장애 설정 으로 전송 불가 |
| 23036 | KISA 최초 발신자 식별코드 오류로 발송 불가 |
| 23037 | RCS MT Failover 발송 시,KISA 최초 발신자 식별코드 오류로 발송 |
| 32000 | 전송 시간 초과 |
| 32001 | 전송 실패 (무선망단) |
| 32002 | 전송 실패 (무선망 -> 단말기단) |
| 32003 | 단말기 전원 꺼짐 |
| 32004 | 단말기 메시지 버퍼 풀 |
| 32005 | 음영지역 |
| 32006 | 메시지 삭제됨 |
| 32007 | 일시적인 단말 문제 |
| 33000 | 전송할 수 없음 |
| 33001 | 가입자 없음 |
| 33002 | 성인 인증 실패 |
| 33003 | 수신번호 형식 오류 |
| 33004 | 단말기 서비스 일시 정지 |
| 33005 | 단말기 호 처리 상태 |
| 33006 | 착신 거절 |
| 33008 | 기타 단말기 문제 |
| 33009 | 메시지 형식 오류 |
| 33010 | MMS 미지원 단말 |
| 33011 | 서버 오류 (이통사) |
| 33012 | 스팸 |
| 33013 | 서비스 거부 |
| 33014 | 기타 |
| 33015 | 전송 경로 없음 |
| 33016 | 첨부파일 사이즈 제한 실패 |
| 33018 | 휴대폰 가입 이동통신사를 통해 발신번호 변작 방지 부가 서비스에 가입된 번호를 발신번호로 사용하는 경우 |
| 33019 | KISA에서 모든 고객사에 대하여 차단 처리 요청된 번호를 발신번호로 사용하는 경우 |
| 33022 | Charset conversion error |
| 33023 | 국내 수신 메시지에 적용되는 발신번호가 발신번호 사전등록 번호가 아닌 경우 |
| 33025 | 24시간 이내 중복 발송 |
| 33029 | 광고 전송 제한 시간 발송 |
| 33030 | MMS MT Failover 첨부파일 처리가 실패한 경우 |
| 33031 | FAILOVER_TIMEOUTSEND 발송 안함 설정에 의해Failover 처리하지 않은 경우 |
| 33032 | FAILOVER(MT) 기능 사용 불가 계정 |
| 33033 | MT Failover Parameter Error |
| 33034 | Invalid MMS MT File Key |
| 33035 | 해당 통신사 장애 설정 으로 전송 불가 |
| 33036 | KISA 최초 발신자 식별코드 오류로 발송 불가 |
| 33100 | 통신사 재전송 시도 타임아웃 |
| 33101 | 아이폰이거나, 단말 자체가 RCS를 지원하지 않는 경우 |
| 33102 | 템플릿 발송시 header 필드 값을 1로 설정한 경우 |
| 33103 | 템플릿 발송시 button을 설정하여 발송한 경우 |
| 33104 | header 필드값이 0(광고문구표시안함),1(광고문구표시함) 이 아닐 경우 |
| 33105 | header 필드가 0(광고문구표시안함)인경우, footer에 값을 설정하는 경우 |
| 33106 | header 필드가 1(광고문구표시함)인경우, footer에 값을 설정하지 않는 경우 |
| 33107 | footer 에는 숫자/하이픈만 허용되며, 최대 20자까지만 허용 됨 |
| 33108 | 템플릿에서 description 타입의 경우, 등록 템플릿의 패턴과 일치 하지 않을 경우 |
| 33109 | title 최대글자수를 초과한 경우 |
| 33110 | description 최대글자수를 초과한 경우 |
| 33111 | 최대 버튼수를 초과한 경우 |
| 33112 | messagebaseID 별 정의된 카드개수에 대해 하기 내용이 한 개라도 없는 경우- MMS 캐로셀 : 카드별 내용, 제목, 이미지 중 한가지라도 입력 필요- MMS Standaard : 이미지 필수 |
| 33113 | 최대 미디어 용량을 초과한 경우 |
| 33114 | 이통사에서 중복 메시지 발생한 경우 |
| 33115 | 발신번호에 대해서 지정하지 않은 대행사로 발송한 경우 |
| 33116 | 브랜드에 대한 대행사가 지정되어 있지 않는 경우 |
| 33117 | 메시지 유효기간에 대한 통신사 설정값이 1(40초), 2(72시간) 이 아닌 경우 |
| 33118 | 최대 버튼 글자수 초과한 경우 |
| 33119 | 정의되지 않은 버튼을 사용한 경우 |
| 33120 | 유효하지 않은 파일 키 |
| 33121 | 메세지베이스 ID가 존재하지 않는 경우 |
| 33122 | 브랜드에 등록되지 않은 발신번호를 사용한 경우 |
| 33123 | 일 메시지 발송량을 초과한 경우 |
| 33124 | messagebase의 param 부정확하거나 누락된 필수 항목이 있을 경우 |
| 33200 | 브랜드 정보 오류 |
| 40001 | Authorization Header 가 누락됨 |
| 40002 | 접근 토큰이 누락됨 |
| 40003 | 접근 토큰이 유효하지 않음 |
| 40004 | 접근 토큰의 유효기간이 만료됨 |
| 40006 | 접근 토큰 내 client_id가 유효하지 않음 |
| 40007 | 접근 토큰 내 scope이 유효하지 않음 |
| 41002 | 송신 요청한 메시지의 상태가 전달됨(delivered)로 변경되기 전에 송신 요청을 취소하거나, expiry 시점에 송신 요청을 취소한 결과 |
| 41100 | RCS 서버 연결이 실패함 |
| 41101 | RCS 서버 연결이 지연됨 |
| 41102 | RCS 서버 요청 처리가 실패함 |
| 41103 | RCS 서버 요청 처리가 지연됨 |
| 41104 | RCS 메시지 처리 서비스(IM) 연결이 실패함 |
| 41105 | RCS 메시지 처리 서비스(IM) 연결이 지연됨 |
| 41106 | RCS 메시지 처리 서비스(IM) 요청 처리가 실패함 |
| 41107 | RCS 메시지 처리 서비스(IM) 요청 처리가 지연됨 |
| 41108 | RCS 메시지 처리 서비스(IM) 요청 처리 수행 중 실패함 |
| 41109 | RCS 메시지 처리 서비스(IM) 내부 오류 |
| 41111 | RCS 사용자 상태 서버 연결이 실패함 |
| 41112 | RCS 사용자 상태 서버 연결이 지연됨 |
| 41113 | RCS 사용자 상태 서버 요청이 실패함 |
| 41114 | RCS 사용자 상태 서버 요청 처리가 지연됨 |
| 41115 | 챗봇 정보 서버 요청이 실패함 |
| 41116 | 챗봇 정보 서버 요청 처리가 지연됨 |
| 41117 | 송신 메시지 취소 요청 처리가 실패함. 해당 메시지가 RCS 사용자에게 전달 되었는지 알 수 없음. |
| 41118 | 송신 요청한 파일 메시지의 파일을 삼성전자 MaaP 서비스 저장소에 저장 실패함. |
| 41200 | RCS 가입자가 아님, 요청한 MSISDN을 사용하는 RCS 사용자가 없음 |
| 41210 | RCS 사용자가 텍스트 메시지를 수신할 수 없음 |
| 41211 | RCS 사용자가 파일 메시지를 수신할 수 없음 |
| 41212 | RCS 사용자가 Richcard 메시지를 수신할 수 없음 * FNW. 111 참고 |
| 41220 | RCS 사용자가 Extended bot message version 1.0 항목이 포함된 메시지를 수신할 수 없음 * FNW. 111 참고 |
| 41221 | RCS 사용자가 Extended bot message version 1.1 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 3 참고 |
| 41222 | RCS 사용자가 Extended bot message version 1.2 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 3 참고 |
| 41230 | RCS 사용자가 Openrichcard version 1.0 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 3 참고 |
| 41231 | RCS 사용자가 Openrichcard version 1.1 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 3 참고 |
| 41232 | RCS 사용자가 Openrichcard version 1.2 항목이 포함된 메시지를 수신할 수 없음 * TTAK.KO-06.0410/R5 3 참고 |
| 41240 | RCS 사용자가 위치 정보 요청 메시지를 수신할 수 없음 * FNW. 111 참고 |
| 42001 | BotServiceId를 사용하는 챗봇의 정보를 찾을 수 없음 |
| 42002 | 요청 parameter 에 Message ID 누락 |
| 42003 | 요청 parameter 에 Bot ID 누락 |
| 42004 | 요청 parameter RCS 사용자 MSISDN 누락 |
| 42005 | 요청 parameter의 RCS 사용자 MSISDN 포맷 오류 (+82) 포함 확인 필요함 |
| 42007 | 챗봇 상용화 전 테스트 시점에 수신 가능한 RCS 사용자 목록에 없는 RCS 사용자에게 메시지 송신 시도함 |
| 42008 | 요청 본문(Body)이 누락됨 |
| 42009 | 요청 메시지 필수 항목이 누락됨. 메시지가 isTyping, status, textMessage, audioMessage, fileMessage, geolocationPushMessage, openrichcardMessage, richcardMessage 중 하나가 아님. |
| 42010 | 요청 메시지 중복 항목이 포함됨. RCS Message 본문에 하나이상의 message 종류가 포함됨. |
| 42011 | 조회/변경 하려는 메시지ID를 가진 메시지가 없거나 상태 변경이 불가함 |
| 42012 | 타이핑 메시지 포맷이 잘못됨 |
| 42013 | trafficType에 예약되지 않은 타입이 포함됨. |
| 42014 | Suggested chiplist를 사용할 수 없는 메시지에 포함됨 |
| 42015 | Text 메시지가 비어 있음 (최소 1) |
| 42031 | richcardMessage내부에 richcard 혹은 richcardcarousel이 없음 |
| 42032 | richcardMessage내부에 richcard 와 richcardcarousel이 모두 존재함 |
| 42034 | Richcard layout이 없음 |
| 42035 | Richcard content가 없음 |
| 42036 | Richcard layout에 방향정보가 없거나 잘못됨. (“HORIZONTAL”과 “VERTICAL”만 허용함) |
| 42038 | Richcard 내 이미지 정렬 기준이 잘못됨. (layout 방향이 “HORIZONTAL”인 경우, “LEFT”, “RIGHT”만 허용함) |
| 42039 | Richcard 내 이미지 정렬 기준이 잘못됨. (layout 방향이 “VERTICAL”인 경우, 정력 기준 허용하지 않음. |
| 42040 | Richcard carousel의 카드넓이가 없거나 잘못됨. (“SMALL_WIDTH”, “MEDIUM_WIDTH”만 허용함) |
| 42041 | Richcard carousel의 카드넓이가 “SMALL_WIDTH”인 경우 모든 미디어의 높이가 “TALL_HEIGHT”가 아님. |
| 42042 | Richcard에 media, description, title이 모두 없음. Richcard Title이 없거나 200자 이상임. Richcard Description이 없거나 2000자 이상임. |
| 42043 | SuggestedChipList에 Suggestion 이 없음 |
| 42044 | SuggestedChipList에 Suggestion 이 11개를 초과함 |
| 42045 | Suggestion에 action과 reply가 없음 |
| 42046 | Suggestion이 action과 reply를 모두 가짐. |
| 42047 | Suggestion의 action내 action이 1개 이상임 |
| 42048 | Richcard에 Suggestion이 4개를 초과함 |
| 42049 | Suggestion의 action 혹은 reply의 postback data 길이가 2048을 초과함 |
| 42050 | Suggestion의 action 혹은 reply의 display text가 25자를 초과함 |
| 42051 | Map Action에 포함된 Location 오류 |
| 42052 | Map Action에 포함된 Location 내 query 혹은 latitude/longitude 만 허용함. 모두 포함됨 |
| 42053 | Map Action에 showLocation 혹은 requestLocationPush가 없음 |
| 42054 | Map Action에 showLocation 과 requestLocationPush가 모두 있음. |
| 42055 | Dialer Action에 phone number, enriched call, video call이 모두 없음 |
| 42056 | Dialer Action에 phone number, enriched call, video call 중 두 가지가 있음. |
| 42057 | Compose Action에 text나 recording message가 없음 |
| 42058 | Compose Action에 text와 recording message가 모두 존재함 |
| 42059 | Settings Action에 항목이 존재하지 않음 |
| 42060 | Settings Action에 항목이 중복됨. |
| 42061 | Clipboard Action에 복사할 text가 없음. |
| 42062 | Local browser Action에 url 이 없음 |
| 42063 | Share Action에 공유할 text 가 없음. |
| 42064 | Calendar Action에 createCalendarEvent가 없음 |
| 42065 | Calendar Action의 createCalendarEvent 내에 startTime, endTime, title 중 하나라도 없음 |
| 42066 | Calendar Action의 createCalendarEvent의 title이 최소 1자 최대 100자를 넘어섬 |
| 42067 | Calendar Action의 createCalendarEvent의 description이 최소 1자 최대 500자를 넘어섬 |
| 42068 | Compose Action의 composeTextMessage 내에 전화번호가 없거나 text가 최소 1자 최대 100자를 넘어섬 |
| 42069 | Compose Action의 composeRecodingMessage 내에 전화번호가 없거나 type이 “AUDIO” 혹은 “VIDEO” 가 아님 (대문자) |
| 42070 | Device Action에 requestDeviceSpecifics 가 비어있음 |
| 42071 | Dialer Action에 전화번호가 없거나 DialEnrichedCall 내의 subject 가 60자를 초과함 |
| 42072 | Map Action의 showLocation 내에 location 이 없음 |
| 42073 | Url Action의 openUrl이 없음 |
| 42100 | Richcard media thumbnail URL이 있으나 content type, file size 가 없음 |
| 42101 | File 메시지에 file URL이 없음 |
| 42102 | 오디오 메시지에 file URL이 없음 |
| 42103 | Geolocation push 메시지에 pos 정보가 없음 |
| 42104 | Richcard Media내 URL이 없음 |
| 42105 | Richcard Media내 content type이 없음 |
| 42106 | Richcard Media내 file size가 없음 |
| 42107 | Richcard Media내 높이가 없거나 잘못됨. “SHORT_HEIGHT”, “MEDIUM_HEIGHT”, “TALL_HEIGHT” 만 허용함. |
| 42108 | Suggestion의 action 혹은 reply의 postback data가 없음 |
| 42200 | URL 형태의 항목에 prefix가 없거나 (http:, https:, etc.) URI 포맷에 맞지않음 |
| 42201 | Geolocation push 메시지에 label 길이가 200을 초과함 |
| 42202 | Richcard content description 길이가 200자를 초과함 |
| 42205 | Richcard carousel content가 10개를 초과함 |
| 42206 | Richcard Media내 file size가 잘못됨 (0이하) |
| 42207 | Expiry 포맷이 RFC3339를 따르지 않음. |
| 42208 | Expiry 시각이 현재시각 이전임. |
| 42301 | Openrichcard에 layout이 없음 |
| 42302 | Openrichcard에 card가 없음 |
| 42303 | Openrichcard에 layout widget이 없음 (View, LinearLayout, TextView, ImageView 중 하나가 필수) |
| 42304 | Openrichcard View의 width/height가 누락됨 |
| 42305 | Openrichcard LinearLayout 필수 항목이 누락됨 |
| 42307 | Openrichcard TextView 필수 항목이 누락됨 |
| 42308 | Openrichcard TextView 텍스트 길이가 2000자를 초과함 |
| 42309 | Openrichcard ImageView 필수 항목이 누락됨 |
| 42310 | Openrichcard ImageView 미디어 파일 사이즈가 0 이하임 |
| 42311 | Openrichcard ImageView Scaletype에 허가되지 않은 문자열이 포함됨 |
| 42312 | Openrichcard content의 width/height가 누락됨 |
| 42313 | Openrichcard content의 width/height에 허가되지 않은 문자열이 포함됨 |
| 42314 | Openrichcard 공통 항목 오류 (Weight, Visibility, Background, Padding, PaddingTop, PaddingLeft, PaddingRight, PaddingBottom, Margin, MarginTop, MarginLeft, MarginRight, MarginBottom, CornerRadius) |
| 42315 | Openrichcard depth가 10을 초과함 |
| 42316 | Button widget의 필수 항목인 Click이 누락됨. |
| 42402 | 파일 메시지에 포함된 파일 URL로 다운로드 실패함 |
| 42514 | seqID와 동일한 messageID를 가진 이전 메시지가 존재함. 중복된 메시지 전송일 가능성이 있음. |
| 42601 | 삼성전자 MaaP 서비스가 제공하는 봇 메시지 처리량을 초과함 |
| 42602 | SPAM 메시지로 판정된 메시지(trafficType: advertisement-filtered, filtered)를 수신하여 CDR 생성 후 응답함. |
| 45000 | Internal Server Error |
| 45001 | 봇 정보 parsing 오류 |
| 45002 | RCS 사용자 혹은 봇 capability parsing 오류 |
| 45003 | 파일 메시지(xml) parsing 오류 |
| 45004 | 봇/사용자 메시지 remote cache 접근 실패 |
| 45005 | ChatID remote cache 접근 실패 |
| 45006 | 봇 정보 서버 접근을 위한 HTTP client 생성 실패 |
| 45007 | 챗봇 접근을 위한 HTTP client 생성 실패 |
| 50001 | Authorization 헤더 파라미터 누락 |
| 50002 | Authorization 헤더 값 누락 |
| 50003 | 토큰이 일치하지 않습니다. |
| 50004 | 토큰이 만료되었습니다. |
| 50005 | 인증 토큰 에러 |
| 50006 | 요청된 계정 정보를 찾을 수 없습니다(BP ID) |
| 50007 | 요청된 중계사 전송 계정을 찾을 수 없습니다(RCS ID) |
| 50008 | 잘못된 패스워드 |
| 50009 | 접근 허용된 IP가 아닙니다 |
| 50010 | 토큰 발급 요청 허용횟수를 초과하였습니다.(SKT) 미납으로 송신 불가 |
| 50011 | 중계사 상품코드 사용 권환 에러 |
| 50012 | 중계사 API 권환 에러 |
| 50100 | 메시지 전송을 할 수 없는 상태입니다. (서버의 요청 거부) |
| 50101 | 권한이 없는 API 호출 |
| 50201 | RCS 메시지 TPS가 초과되었습니다. |
| 50202 | RCS 메시지 Quota가 초과되었습니다. |
| 51003 | 중복 Key 오류 |
| 51004 | 요청 파라미터 형식 오류 |
| 51005 | 요청 Body JSON 파싱 에러 |
| 51006 | 데이터를 찾을 수 없음 |
| 51101 | AgencyKey를 찾을 수 없습니다. |
| 51102 | AgencyKey가 일치하지 않습니다. |
| 51103 | BrandKey를 찾을 수 없습니다. |
| 51104 | BrandKey가 일치하지 않습니다. |
| 51900 | 잘못된 요청입니다. |
| 51901 | 삼성 MaaP Gateway NB API 연동 에러 |
| 51902 | 삼성 MaaP Registry Chatbot API 연동 에러 |
| 51903 | Capri 연동 에러 |
| 51904 | Webhook 처리 불가 상태 오류가 발생했습니다. |
| 51905 | Webhook 메시지 전송 과금 이력 작성을 실패했습니다. |
| 51906 | 잘못된 Webhook Url 입니다. |
| 51907 | 만료된 메시지 입니다. |
| 51908 | 재시도 횟수 초과로 인해 메시지 전송을 실패했습니다. |
| 51909 | Webhook 발송 메시지가 존재하지 않습니다. |
| 51910 | Webhook 발송 중계사 정보가 존재하지 않습니다. |
| 51911 | 계약관계가 없습니다. |
| 51912 | 삼성 시뮬레이터 연동 오류 |
| 52001 | 전화번호 형식이 일치하지 않습니다 |
| 52002 | 요청을 처리할 수 없는 상태입니다. |
| 52003 | 이미 사용 중인 챗봇 ID입니다. |
| 52004 | 챗봇을 생성할 수 없습니다. |
| 52005 | 챗봇 정보를 변경할 수 없습니다. |
| 52006 | 챗봇이 있는 브랜드는 삭제 할수 없습니다. |
| 52007 | 챗봇 Type은 a2p, chatbot 로 설정해야 함 |
| 52008 | 요청 URL Parameter의 챗봇 Id와 Body Parameter 불일치 |
| 52009 | 챗봇 생성/업데이트 데이터에 오류가 있습니다. |
| 52010 | 챗봇 MO 메시지 웹훅 대행사 데이터 오류 |
| 52011 | 챗봇 MO 메시지 웹훅 대행사 데이터 정보가 누락되었음 |
| 52012 | Persistent menu JSON 데이터 오류 |
| 52016 | 실시간 메시지 인입 후 10초안에 삼성으로 전달되지 못함 |
| 52023 | 메시지 베이스의 상태가 'pause'인 메시지 베이스 메시지로 전문 구성하여 전송 시도 시 |
| 52098 | 해당 속성 접근 권한이 없음 |
| 52099 | Chatbot 접근 권한이 없음 |
| 52101 | 잘못된 Webhook 중계사 요청 파라미터 입니다. |
| 52102 | Webhook 중계 시스템 연결 오류 |
| 52103 | 중계사 Webhook 전송 요청을 실패 했습니다. |
| 52104 | 중계사 Webhook 처리 응답 수신 오류가 발생 했습니다. |
| 52105 | Webhook 메시지 미 수신 오류가 발생 했습니다. |
| 52106 | Webhook 메시지 처리 오류가 발생 했습니다. |
| 53001 | 요청을 처리할 수 없는 파일 유형입니다. |
| 53002 | 파일 속성 오류 |
| 53003 | fileID가 없거나 ID형식에 맞지 않음 |
| 53004 | File 저장 오류 |
| 53005 | Multipart 데이터 전송 오류 |
| 53006 | 업로드 파일 크기 초과 |
| 54001 | 자사 고객이 아닙니다. |
| 54002 | 자사 고객이지만, RCS메시지를 수신할 수 있는 가입자가 아닙니다. |
| 54003 | 단말기기로 RCS 메시지를 전송할 수 없습니다. |
| 54004 | MaaP 시스템 혹은 RCS 프로토콜 상의 이슈로 발송 실패되었음 (삼성 에러 40001 ~ 41100, 42601) |
| 54005 | 스팸 필터링에 의해 차단됨 |
| 54006 | RCS가입고객이지만 오픈리치카드 미지원 단말입니다.(SKT)자사 고객이지만, 요청한 스펙의 RCS 메시지를 수신할 수 있는 가입자가 아닙니다. |
| 55001 | 기업 정보 내용이 누락된 필수항목이 있습니다. |
| 55002 | 필수 파라미터 검증 오류 |
| 55101 | 대행사 정보 내용이 누락된 필수 항목이 있습니다. |
| 55102 | AgencyID가 존재하지 않습니다. |
| 55103 | BrandID에 대행 권한이 없는 AgencyID |
| 55104 | 계약 정보 내용이 부정확하거나 누락된 필수 항목이 있습니다. |
| 55201 | 브랜드 정보 내용이 누락된 필수항목이 있습니다. |
| 55202 | 브랜드 명이 누락되어 있습니다. |
| 55203 | 브랜드 프로필 이미지가 누락되어 있습니다. |
| 55204 | 브랜드 CS번호가 누락되어 있습니다. |
| 55205 | 브랜드 메뉴 최대 개수를 초과하였거나 부정확합니다. |
| 55206 | 브랜드 카테고리 설정이 잘못되어 있습니다. |
| 55207 | 브랜드 홈페이지 설정이 잘못되어 있습니다. |
| 55208 | 브랜드 이메일 설정이 잘못되어 있습니다. |
| 55209 | 브랜드 주소가 잘못되어 있습니다. |
| 55210 | 브랜드ID가 존재하지 않음 |
| 55301 | 챗봇 정보 내용이 부정확하거나 누락된 필수항목이 있습니다. |
| 55302 | BotID(발신번호)가 전화번호 형식에 맞지 않음 |
| 55303 | BrandID에 존재하지 않는 BotID |
| 55304 | BrandID에 존재하지 않는 BotID |
| 55501 | 메시지베이스 내용이 부정확하거나 누락된 필수항목이 있습니다. |
| 55502 | MessagebaseID가 존재하지 않음 |
| 55503 | BrandID에 존재하지 않는 MessagebaseID입니다. |
| 55504 | messagebase의 formatstring 누락된 필수 항목이 있습니다. |
| 55505 | messagebase의 policy Info가 부정확하거나 누락된 필수 항목이 있습니다. |
| 55506 | messagebase의 param 부정확하거나 누락된 필수 항목이 있습니다. |
| 55507 | messagebase의 attribute 부정확하거나 누락된 필수 항목이 있습니다. |
| 55508 | messagebase의 type 부정확하거나 누락된 필수 항목이 있습니다. |
| 55509 | messagebaseID의 product type과 일치하지 않음 |
| 55601 | MessagebaseForm 내용이 부정확하거나 누락된 필수항목이 있습니다. |
| 55602 | messagebaseformID가 존재하지 않습니다. |
| 55603 | messaegBase의 상품코드 에러 |
| 55604 | messaegBase의 child layout depth가 허용값보다 큽니다. |
| 55621 | AutoReplyMsg Body JSON 포맷 오류 |
| 55622 | AutoReplyMsg Buttons JSON 포맷 오류 |
| 55623 | AutoReplyMsg ChipList JSON 포맷 오류 |
| 55701 | "(광고)"를 사용할 수 없음 |
| 55702 | Action button이 허용되지 않는 messagebaseID에서 Action button을 사용하였음 |
| 55703 | 허용되지 않은 header 값 사용 |
| 55704 | header 값과 일치 하지 않은 footer 사용 (ex. header가 0 인데, footer 가 있음) |
| 55705 | footer값이 누락되어 있습니다 (ex. header가 1 인데, footer 가 없음) |
| 55706 | footer validation 오류 (ex. 숫자, 하이픈만 가능. 20자리) |
| 55707 | 등록한 패턴과 일치 하지 않음 |
| 55708 | title 최대글자수를 초과했습니다. |
| 55709 | description 최대글자수를 초과했습니다. |
| 55710 | 최대 버튼수를 초과했습니다. |
| 55711 | messagebaseID의 number of card 와 입력이 일치하지 않음 |
| 55712 | 최대 미디어 용량을 초과했습니다. |
| 55801 | 중계사 정보가 부정확하거나 누락된 필수 항목이 있습니다. |
| 55802 | 메시지 형식이 부정확하거나 누락된 필수항목이 있습니다. |
| 55803 | 메시지 기술방법이 잘못되었습니다. |
| 55804 | 메시지 내용이 누락되었거나 부정확합니다. |
| 55805 | 요청을 처리할 수 없는 메시지 유형입니다. |
| 55806 | 같은 메시지 ID로 두번 이상 메시지 발송이 요청됨 |
| 55807 | 챗봇 권한 오류 |
| 55808 | 발신 가능한 챗봇 상태가 아님 |
| 55809 | 대행사 권한 오류 |
| 55810 | 메시지 유효기간 입력값 오류 |
| 55811 | 메시지베이스 파라미터의 길이가 한계값 이상 |
| 55812 | 버튼 필드를 받을 수 없는 메시지베이스 입니다. |
| 55813 | 최대 버튼 글자수 초과 |
| 55814 | 버튼 형식 오류 |
| 55815 | 존재하지 않는 File이거나 usageType 오류 |
| 55816 | Empty suggestions array 허용 안함 |
| 55817 | 수신 번호 형식 오류 |
| 55818 | 메세지베이스 ID가 존재하지 않음 |
| 55819 | 챗봇ID가 존재하지 않음 |
| 55820 | Webhook Revoked 메시지 |
| 55821 | 전송 성공 불확실함 (revocation fail 등) |
| 55822 | 메시지 취소되어, 전송안됨 |
| 55880 | 버튼 개수 불일치 (Mismatched Suggestions Count) |
| 55881 | (양방향)유효한 replyId 아님 |
| 55882 | (양방향)replyId 값 누락 됨 |
| 55883 | (양방향)messagebase 상품 코드가 세션 메시지 가능하지 않음 |
| 55884 | (양방향)replyId 와 일치하는 수신번호가 아님 |
| 55885 | (양방향)replyId 와 일치하는 chatbotId 아님 |
| 55886 | (양방향)chipList 발송 가능하지 않음 |
| 55887 | (양방향)세션 메시지 발송 가능한 chatbot 아님 |
| 55900 | 잘못된 메시지 형식으로 인해 발송 실패되었고 재시도 가능하지 않음 (삼성 에러 42001 ~ 42514) |
| 55901 | 담당자 정보가 부정확하거나 누락된 필수항목이 있습니다. |
| 56002 | 메시지 회수 실패 (삼성 에러 41002) |
| 56007 | RCS 세션 연결 전 만료되어 발송 실패 (삼성 에러 41007) |
| 56101 | RCS 수신 가능여부를 확인할 수 없습니다. |
| 59001 | 시스템 에러 |
| 59002 | IO 에러 발생 /Backend(삼성 MaaP G/W) 서버 내부 에러 |
| 59003 | Backend(삼성 MaaP G/W) 서버 타임 아웃 발생 |
| 59202 | Backend 서버(삼성) 전송 에러 |
| 59203 | Backend 서버(삼성) 전송 타임 아웃 |
| 59901 | 시스템이 요청을 처리할 수 없는 상태 |
| 59999 | 기타 정의되지 않은 Error (Webhook Cancelled 메시지 등) |
| 60162 | 최초 발신자 식별 코드 에러 |
| 60400 | 권한 없음 |
| 60500 | 인증 실패 |
| 60501 | 발신프로필 키가 유효하지 않거나 상담을 진행할 수 없음 |
| (카카오톡 채널이 activated 상태가 아닌 경우 | |
| 상담톡 이용 중 상태가 아닌 경우) | |
| 60502 | 세션이 만료되었거나 존재하지 않음 |
| 60503 | 잘못된 형식의 사용자 키 요청 |
| 60504 | 메시지 일련번호가 중복됨 |
| (메시지 일련번호는 CS처리를 위해 고유한 값이 부여되어야 함.) | |
| 60505 | 잘못된 파일 전송 요청 |
| 60506 | 메시지 길이 제한 오류 1000자 초과 |
| 60507 | 허브파트너 키가 유효하지 않음 |
| 60508 | 채팅 기능이 비활성 상태인 경우 |
| 60509 | 잘못된 파라메터 요청 |
| 60510 | 잘못된 형식의 메시지 타입 요청 |
| 60511 | 차단된 사용자에게 메시지 전송 요청 |
| 60512 | 유효한 상담톡 계약이 존재하지 않음 |
| 60600 | 메시지 전송 실패 |
| 60681 | 챗봇대화내역 전달 방법이 상담 시작에 포함되어 있음 |
| 61001 | Request Body가 Json형식이 아님 |
| 61002 | 허브 파트너 키가 유효하지 않음 |
| 61003 | 발신 프로필 키가 유효하지 않음 |
| 61004 | Request Body(Json)에서 name을 찾을 수 없음 |
| 61006 | 삭제된 발신프로필. (메시지 사업 담당자에게 문의) |
| 61007 | 차단 상태의 발신프로필. (메시지 사업 담당자에게 문의) |
| 61011 | 계약정보를 찾을 수 없음. (메시지 사업 담당자에게 문의) |
| 61012 | 잘못된 형식의 유저키 요청 |
| 61013 | 유효하지 않은 app연결 |
| 61014 | 유효하지 않은 사업자번호 |
| 61015 | 유효하지 않은 app user id 요청 |
| 61016 | 사업자등록번호 불일치 |
| 61020 | 전화번호 or app user id가 유효하지 않거나 미입력 요청 |
| 61021 | 차단 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) |
| 61022 | 닫힘 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) |
| 61023 | 삭제된 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) |
| 61024 | 삭제대기 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) |
| 61025 | 채널 제재 상태로 인한 메시지 전송 실패 (카카오톡 채널 운영툴에서 확인) |
| 61026 | 해당 message_type에서 사용할 수 없는 response_method로 요청 (이미지알림톡(AI)는 realtime으로 발송 불가) |
| 61027 | 채널 메시지 제재 상태로 인한 메시지 전송 실패 (카카오톡 채널 운영툴에서 확인) |
| 61028 | 해당 타겟팅 옵션 사용할 수 없음 |
| 61030 | 잘못된 파라메터 요청 |
| 61033 | 브랜드메시지 템플릿 타입과 메시지 타입 불일치 |
| 62003 | (테스트 발송) 카카오톡 채널을 추가하지 않았음 |
| 62004 | 템플릿 일치 확인 시 오류 발생(내부 오류 발생) |
| 62005 | 카카오 내부 시스템 오류로 이미지 정보를 읽어오는데 실패함 |
| 62006 | <4.2 메시지 전송 요청>에 명시된 시리얼넘버 형식 불일치 |
| 63000 | 예기치 않은 오류 발생 |
| 63005 | 카카오( Response method REALTIME)메시지를 발송했으나 수신확인 안됨 (성공불확실) - 서버에는 암호화 되어 보관되며 3일 이내 수신 가능 |
| 63006 | 카카오 내부 시스템 오류로 메시지 전송 실패 |
| 63008 | 전화번호 오류 |
| 63010 | Json 파싱 오류 |
| 63011 | 메시지가 존재하지 않음 |
| 63012 | 메시지 일련번호가 중복됨- 메시지 일련번호는 CS처리를 위해 고유한 값이 부여되어야 함. |
| 63013 | 메시지가 비어 있음 |
| 63014 | 메시지 길이 제한 오류(템플릿별 제한 길이 또는 1000자 초과) |
| 63015 | 템플릿을 찾을 수 없음 |
| 63016 | 메시지 내용이 템플릿과 일치하지 않음 |
| 63018 | 메시지를 전송할 수 없음 |
| 63019 | 톡 유저가 아님 |
| 63020 | 알림톡 수신 차단 |
| 63021 | 카카오톡 최소 버전 미지원 |
| 63022 | 메시지 발송 가능한 시간이 아님(친구톡/마케팅 메시지는 08 시~ 20 시까지 발송가능) |
| 63023 | 메시지에 포함된 비디오를 전송할 수 없음(비디오 주소 또는 썸네일 이미지 주소가 올바르지 않거나 썸네일 이미지가 규격에 맞지 않음) |
| 63024 | 메시지에 포함된 이미지를 전송할 수 없음(이미지 주소 또는 링크가 올바르지 않거나 이미지가 규격에 맞지 않음) |
| 63025 | 변수 글자수 제한 초과 |
| 63026 | 상담/봇 전환 버튼 extra, event 글자수 제한 초과 |
| 63027 | 메시지 버튼/바로연결이 템플릿과 일치하지 않음 |
| 63028 | 메시지 강조 표기 타이틀이 템플릿과 일치하지 않음 |
| 63029 | 메시지 강조 표기 타이틀 길이 제한 초과 (50자) |
| 63030 | 메시지 타입과 템플릿 강조유형이 일치하지 않음 |
| 63031 | 헤더가 템플릿과 일치하지 않음 |
| 63032 | 헤더 길이 제한 초과(16자) |
| 63033 | 아이템 하이라이트가 템플릿과 일치하지 않음 |
| 63034 | 아이템 하이라이트 타이틀 길이 제한 초과(이미지 없는 경우 30자, 이미지 있는 경우 21자) |
| 63035 | 아이템 하이라이트 디스크립션 길이 제한 초과(이미지 없는 경우 19자, 이미지 있는 경우 13자) |
| 63036 | 아이템 리스트가 템플릿과 일치하지 않음 |
| 63037 | 아이템 리스트의 아이템의 디스크립션 길이 제한 초과(23자) |
| 63038 | 아이템 요약정보가 템플릿과 일치하지 않음 |
| 63039 | 아이템 요약정보의 디스크립션 길이 제한 초과(14자) |
| 63040 | 아이템 요약정보의 디스크립션에 허용되지 않은 문자 포함(통화기호/코드, 숫자, 콤마, 소수점, 공백을 제외한 문자 포함) |
| 63041 | 와이드 아이템 리스트 갯수 최대 최소 갯수 불일치 |
| 63042 | 대표링크가 템플릿과 일치하지 않음 |
| 63043 | 이미지 변수 개수 템플릿 불일치 |
| 63044 | 쿠폰 변수 템플릿 불일치 |
| 63045 | 커머스 정보 변수 템플릿 불일치 |
| 63046 | 부가 정보 최대 길이 제한 오류 |
| 63047 | 커머스 정보 상품명 최대 길이 제한 오류 |
| 63048 | 유효하지 않은 그룹태그 |
| 63050 | 수신동의거부 스펙 (N타입) 미지원 |
| 63051 | 캐러셀 아이템 리스트 갯수 최소, 최대 갯수 불일치 |
| 63052 | 캐러셀 아이템 메시지 길이 OVER |
| 63053 | 캐러셀 템플릿 불일치 |
| 63054 | 캐러셀 버튼 템플릿 불일치 |
| 63055 | 캐러셀 쿠폰 템플릿 불일치 |
| 63056 | 와이드 아이템 리스트 타이틀 길이 제한 오류 |
| 63057 | 캐러셀 커머스 템플릿 불일치 |
| 63058 | 캐러셀 헤더 길이 제한 오류 |
| 64000 | 메시지 전송 결과를 찾을 수 없음 / 입력값 오류 발생 |
| 64001 | 알 수 없는 메시지 상태 / Request Body Parsing Error |
| 64008 | 계정 사용 권한 없음 |
| 64009 | 알림톡 서비스 사용 권한 없음 (AT(AL), AI) |
| 64010 | 친구톡 서비스 사용 권한 없음 (FT, FI, FW) |
| 64102 | Template 요청 오류 |
| 64104 | 유효한 발신프로필을 찾을 수 없음 |
| 64110 | 유효하지 않은 챗버블 타입 또는 메시지 타입 요청 |
| 64121 | 메시지 발송 대상 오류 |
| 64122 | 메시지 결과 조회 오류 |
| 65000 | (테스트 발송) 관리자 혹은 일회성 인증을 받은 사용자가 아님 |
| 65001 | (테스트 발송) 일일 발송량 초과 |
| 67011 | 시리얼 넘버 패턴 에러 |
| 67014 | 메시지 유효 시간 초과 에러 |
| 68512 | 수신자 타입 찾을 수 없음 |
| 68514 | request_id 찾을 수 없음 |
| 68520 | 지원하지 않는 상품 타입 오류 |
| 68521 | 지원하지 않는 메시지 타입 오류 |
| 68522 | 지원하지 않는 텍스트 유형 오류 |
| 68523 | 지원하지 않는 response method 오류 |
| 68530 | 수신자 목록 사이즈 오류 |
| 68999 | 내부 서버 오류 |
| 6ME09 | (카카오 Response method POLLING)사용자에게 메시지를 발송했으나 수신여부 불투명(성공불확실/비과금) |
| 69998 | 현재 서비스를 제공하고 있지 않습니다. |
| 69999 | 시스템에서 알 수 없는 문제가 발생하였습니다. 담당자가 확인 중입니다. |
| 70001 | 메세지가 유저에게 웹으로 전송되었으나 앱 전송에는 실패하였습니다. |
| 71001 | AgentKey나 PartnerKey가 누락되었습니다. |
| 71002 | 보내기 API의 요청 Body에 문제가 있습니다. |
| 71003 | 전화번호나 액세스 토큰 중 적어도 하나의 파라미터가 필요합니다. |
| 71004 | 전화번호 패턴이 잘못되었습니다. |
| 71005 | 파트너키나 발송그룹키가 반드시 있어야 합니다. |
| 71006 | 유효하지 않은 상품에 해당하는 템플릿 발송으로 계약을 확인해야 합니다. |
| 71007 | 등록된 템플릿의 상품코드와 발송요청한 상품코드가 일치해야 합니다. |
| 72001 | 템플릿에 필요한 파라미터가 부족합니다. |
| 72002 | 템플릿 아이디가 존재하지 않습니다. |
| 72003 | 템플릿에 필요한 파라미터가 일치하지 않습니다. |
| 72004 | 템플릿에 필요한 버튼 갯수와 요청한 버튼 갯수가 일치하지 않습니다. |
| 72005 | 템플릿에 필요한 파라미터가 일치하지 않습니다. 버튼코드를 확인하세요. |
| 72006 | 등록된 템플릿과 일치하지 않는 메세지(message) 파라미터입니다. |
| 72007 | 승인되지 않은 템플릿은 발송할 수 없습니다. 템플릿 승인 상태를 확인하세요. |
| 72008 | 등록된 템플릿과 메세지 파라미터를 비교하던 중 오류가 발생하였습니다.2006 응답코드와 거의 동일한 상황이나, 특수문자에 의해 불일치가 있는 경우입니다. |
| 72009 | 관리자에 의해 차단된 템플릿입니다. 자세한 내용은 문의해주세요. |
| 72010 | 템플릿에 사용하는 샘플 이미지가 등록되지 않았습니다. 샘플 이미지를 등록해주세요. |
| 72011 | 이미지 해시 아이디에 해당하는 파트너키나 템플릿 그룹키를 사용해야 합니다. |
| 72101 | 템플릿에 저장된 템플릿그룹 아이디와 일치하지 않는 템플릿 요청입니다. 템플릿 설정을 확인해주세요. |
| 72102 | 유효하지 않은 템플릿 그룹키 입니다. 그룹키를 확인해주세요. |
| 72103 | 템플릿 그룹의 파트너 목록에 존재하지 않는 요청입니다. |
| 72104 | 이미지 해시 아이디에 해당하는 템플릿 그룹키를 확인해주세요. |
| 72105 | 쿠폰이 첨부된 경우, 이미지는 첨부되지 않습니다. |
| 72106 | 쿠폰이 첨부된 경우, 쿠폰 이미지 URL이 반드시 필요합니다. |
| 72107 | 쿠폰의 만료기간은 필수이며, 오늘 이후의 날짜가 YYYY-MM-DD 형태로 입력돼야 합니다. |
| 72108 | 발송처정보가 없거나 사업자코드가 잘못되었습니다. |
| 72109 | 할부 개월 수 정보가 잘못되었습니다. 숫자 변환에 실패했습니다. 00~36사이의 수를 입력해 주세요. |
| 72110 | 거래유형이 잘못되었습니다. 거래유형 승인(01)/취소(02)/거절(03)으로 입력돼야 합니다. |
| 72111 | 거래금액이 잘못되었습니다. 숫자로 변환하지 못하였습니다. |
| 72112 | 통화코드가 잘못 입력되었습니다. ISO-4217의 통화코드 중 숫자코드를 입력해 주세요. |
| 72113 | 거래일시를 변환하지 못했습니다. 14자리(YYYYMMDDHH24MISS)으로 입력해 주세요. |
| 72114 | 거래금액을 원화로 표시할 때 소수점을 사용할 수 없습니다. |
| 73001 | 에이전트 키에 해당하는 파트너가 매핑되어 있지 않습니다. |
| 73002 | 전화번호에 해당하는 유저가 존재하지 않습니다. |
| 73003 | 매핑된 파트너가 존재하지 않습니다. |
| 73004 | 이미 존재하는 메세지 키입니다. |
| 73005 | 전화번호에 해당하는 서로 다른 유저가 존재합니다. |
| 73006 | 발송 파트너 계정 상태가 비정상 상태입니다. |
| 73007 | 발송 파트너 계정 상태가 비정상 상태입니다. |
| 74001 | 유저가 정보성 알림을 받을 수 있는 상태가 아닙니다. |
| 74002 | 유저가 스마트알림 수신을 차단하였습니다. |
| 74003 | 유저가 파트너 계정을 차단하였습니다. |
| 74004 | 카드승인알림에 가입하지 않은 유저입니다. |
| 74005 | 카드승인알림 가입 단말기에 푸쉬가 도달하지 않았습니다. |
| 74006 | 카드승인알림 가입 전화번호와 일치하지 않는 유저입니다. |
| 79051 | 메세지 시스템의 오류로 정보성 알림 송신이 불가합니다. |
| 79052 | 템플릿에 상품 정보가 없어 발송이 불가합니다. 네이버 담당자에게 연락부탁드립니다. |
| 79999 | 알 수 없는 이유로 메세지가 전송되지 않았습니다. |
Carrier Code
이통사 코드 입니다.
| Code | Text | Description |
|---|---|---|
| 10000 | ETC | 기본값 |
| 10001 | SKT | SK텔레콤 |
| 10002 | KT | 케이티 |
| 10003 | LGU | LG유플러스 |
| 10006 | Internet number | 인터넷, 기타 번호(070) |
| 10010 | Safety number | 050번호 |
Service / Message Type
서비스 타입 및 메시지 타입 코드 입니다.
| Service Type | Message Type | Description |
|---|---|---|
| SMS | SM | SMS 메시지 |
| MMS | LM, MM | LMS 메시지, MMS 메시지 |
| INTERNATIONAL | IM | 국제메시지 |
| RCS | RS, RL, RM, RT, RI | RCS SMS 메시지, RCS LMS 메시지, RCS MMS 메시지, RCS 템플릿 메시지, RCS 이미지 템플릿 메시지 |
| ALIMTALK | AT, AI | 알림톡 텍스트, 알림톡 이미지 |
| FRIENDTALK | FT, FI, FW, FC, FL, FM, FA, FP | 친구톡 텍스트, 친구톡 이미지, 친구톡 와이드 이미지, 친구톡 캐러셀, 친구톡 아이템 리스트, 친구톡 커머스, 친구톡 캐러셀커머스, 친구톡 동영상 프리미엄 |
| BRANDMESSAGE | FTFIFWFCFLFMFAFP | 브랜드메시지 텍스트브랜드메시지 이미지브랜드메시지 와이드 이미지브랜드메시지 캐로셀브랜드메시지 아이템 리스트브랜드메시지 커머스 |
| 브랜드메시지 캐러셀 커머스 | ||
| 브랜드메시지 동영상 프리미엄 |
Report Type
리포트 종류 코드 입니다.
| Code | Text | Description |
|---|---|---|
| 0 | 최종 결과 | (국내) 최종 단말기 전송 결과(국제) 국제 중계사 접수 결과*과금 기준 |
| 1 | 중간 결과 | 인포뱅크 접수 |
| 2 | 이통사 접수 결과 | 이통사 접수 |
| 3 | DLR 결과 | Delivery Reporting국제메시지 단말기 전송 결과 |
인증 API 코드
인증 API는 인증/검증 흐름에서 사용하는 2FA 및 소셜로그인 개별 응답 코드를 제공합니다.
2FA 코드 (개별부)
| Code | Result | Result Message |
|---|---|---|
| A000 | SUCCESS | 요청 성공 |
| A010 | Empty Header 'Authorization' | 유효하지 않거나 비어있는 헤더 (Authorization) |
| A011 | Invalid or empty 'to' | 유효하지 않거나 비어있는 필드 (필드명 : to) |
| A012 | Invalid or empty 'authNumber' | 유효하지 않거나 비어있는 필드 (필드명 : authNumber, 6자리 숫자) |
| A013 | Invalid or exceeded 'authNumber' | 유효하지 않거나 만료된 인증번호 (필드명 : authNumber) |
| A014 | Invalid 'requestDate' | 유효하지 않는 날짜 형식 (예시. 20250601) |
| A020 | Number of unsuccessful attempts exceeded | 인증번호 요청 횟수 초과 (5회) |
| A021 | Internal send API error | 발송 API 연동 실패 |
| A910 | Internal server error | 내부 서버 오류 |
| A911 | Request Body Format Error | 요청 바디 포맷 오류 |
| A999 | Unknown error | 알려지지 않은 에러 |
소셜로그인 코드 (개별부)
| Code | Result | Result Message |
|---|---|---|
| A000 | SUCCESS | 요청 성공 |
| A010 | Empty Header 'Authorization' | 유효하지 않거나 비어있는 헤더 (Authorization) |
| A011 | Invalid or empty 'to' | 유효하지 않거나 비어있는 필드 (필드명 : to) |
| A012 | Invalid or empty 'authNumber' | 유효하지 않거나 비어있는 필드 (필드명 : authNumber, 6자리 숫자) |
| A013 | Invalid or exceeded 'authNumber' | 유효하지 않거나 만료된 인증번호 (필드명 : authNumber) |
| A014 | Invalid 'requestDate' | 유효하지 않는 날짜 형식 (예시. 20250601) |
| A020 | Number of unsuccessful attempts exceeded | 인증번호 요청 횟수 초과 (5회) |
| A021 | Internal send API error | 발송 API 연동 실패 |
| A910 | Internal server error | 내부 서버 오류 |
| A911 | Request Body Format Error | 요청 바디 포맷 오류 |
| A999 | Unknown error | 알려지지 않은 에러 |