RCS 발송
RCS(Rich Communication Suite)는 메시지 내에 버튼 및 여러 장의 메시지 카드(Carousel)를 하나의 메시지로 발송할 수 있는 차세대 서비스입니다. RCS 서비스를 발송하기 위해서는 RCS Biz Center에서 브랜드 개설 및 메시지 템플릿을 사전 등록해야 합니다.
RCS 발송하기
RCS 서비스로 다양한 형태의 메시지 유형에 따라 메시지를 발송할 수 있는 코드 예제를 제공합니다.
안내
- 메시지 유형별 스펙에 대한 자세한 정보는 부록. 메시지 타입별 가이드 및 스펙 문서를 참고하시기 바랍니다.
- 각 테이블에 입력하는 데이터는 테이블 명세 문서를 참고하시기 바랍니다.
- RCS를 발송하기 위해서는 Kakao Biz Message 사이트에서 템플릿을 등록 후 검수를 받아야 합니다.
RCSSMS 발송
RCSSMS 발송은 단문 메시지를 보낼 수 있는 서비스입니다.
코드예제RCSSMS 발송 Sample Code
# RCSSMS 기본형 + BUTTONS 1개
INSERT INTO RCS_MESSAGE (
MSG_SEQNO,
RESERVE_DATE,
AGENCY_ID,
PHONE_NO,
CALLBACK,
MESSAGE_BASE_ID,
SERVICE_TYPE,
HEADER,
FOOTER,
COPY_ALLOWED,
BODY,
BUTTONS
) VALUES (
‘2022010100001’,
now(),
‘kakaoenterprise’,
‘01012345678’,
‘1544-0000’,
‘SS000000’, # 메시지 템플릿 코드
‘RCSSMS’, # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
‘1’, # 0 : 정보성, 1 : 광고성
‘080-0000-0000’, # 광고성인 경우 필수 입력
true,
‘{ "title": "","description":"일반 RCSSMS 메시지입니다.\\n" }’,
‘[
{
"suggestions":[{
"action":{
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "Open Url",
"postback": {
"data": "set_by_open_url"
}
}
}]
}
]’
);
RCSLMS 발송
RCSLMS 발송은 장문 메시지를 보낼 수 있는 서비스입니다.
코드예제RCSLMS 발송 Sample Code
# RCSLMS 기본형 + BUTTONS 1개
INSERT INTO RCS_MESSAGE (
MSG_SEQNO,
RESERVE_DATE,
AGENCY_ID,
PHONE_NO,
CALLBACK,
MESSAGE_BASE_ID,
SERVICE_TYPE,
HEADER,
FOOTER,
COPY_ALLOWED,
BODY,
BUTTONS
) VALUES (
‘2022010100001’,
now(),
‘kakaoenterprise’,
‘01012345678’,
‘1544-0000’,
‘SL000000’, # 메시지 템플릿 코드
‘RCSLMS’, # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
‘1’, # 0 : 정보성, 1 : 광고성
‘080-0000-0000’, # 광고성인 경우 필수 입력
true,
‘{"title": "RCSLMS 타이틀","description":"일반 RCSLMS 메시지입니다." }’,
‘[
{
"suggestions":[{
"action":{
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "Open Url",
"postback": {
"data": "set_by_open_url"
}
}
}]
}
]’
);
RCSMMS(세로형) 발송
RCSMMS는 발송하기 전에 미리 이미지를 업로드하여 업로드가 완료된 이미지만 발송할 수 있습니다.
RCS_MESSAGE_CONTENTS 테이블에 사전에 발송할 이미지를 입력하면 업로드가 완료된 후 이미지 업로드 URL을 테이블에 입력합니다. 입력된 업로드 URL을 메시지 발송 시 MMS_IMG_URL 칼럼에 입력하여 발송하면 됩니다.
코드예제RCSMMS(세로형) 발송 Sample Code
# RCSMMS 기본형 + 첨부 파일 1개 + BUTTONS 1개
INSERT INTO RCS_MESSAGE_CONTENTS(
REG_DATE,
IMG_FILE_PATH,
IMG_MIME_TYPE,
IMG_DESCRIPTION
) VALUES (
now(),
‘/files/test.jpg’,
‘image/jpg’,
‘ 이미지 업로드’
);
INSERT INTO RCS_MESSAGE (
MSG_SEQNO,
RESERVE_DATE,
PHONE_NO,
CALLBACK,
MESSAGE_BASE_ID,
SERVICE_TYPE,
HEADER,
FOOTER,
COPY_ALLOWED,
MMS_TITLE1,
MMS_MSG1,
MMG_IMG_URL1
BUTTONS
) VALUES (
‘2022010100001’,
now(),
‘01012345678’,
‘1544-0000’,
‘SM000000’, # 메시지 템플릿 코드
‘RCSMMS’, # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
‘1’, # 0 : 정보성, 1 : 광고성
‘080-0000-0000’, # 광고성인 경우 필수 입력
true,
‘20220608000001’,
‘1’,
‘MMS 타이틀’,
‘일반 RCSMMS 메시지입니다.’,
‘maapfile://testImgUrl’,
‘[
{
"suggestions":[{
"action":{
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "Open Url",
"postback": {
"data": "set_by_open_url"
}
}
}]
}
]’
);
RCSMMS(Carousel) 발송
RCSMMS(Carousel)는 발송하기 전에 미리 이미지를 업로드하여 업로드가 완료된 이미지만 발송할 수 있습니다. 캐러셀(Carousel)은 이미지나 텍스트의 가로 슬라이드를 여러 개를 표시하는 컴포넌트입니다.
코드예제RCSMMS(Carousel) 발송 Sample Code
# 캐로셀은 5장까지 가능하며, 캐로셀 당 버튼은 2개까지 삽입 가능
INSERT INTO RCS_MESSAGE_CONTENTS(
REG_DATE,
IMG_FILE_PATH,
IMG_MIME_TYPE,
IMG_DESCRIPTION
) VALUES (
now(),
‘/files/caousel_001.jpg’,
‘image/jpg’,
‘ 이미지 업로드1’
);
INSERT INTO RCS_MESSAGE_CONTENTS(
REG_DATE,
IMG_FILE_PATH,
IMG_MIME_TYPE,
IMG_DESCRIPTION
) VALUES (
now(),
‘/files/caousel_002.jpg’,
‘image/jpg’,
‘ 이미지 업로드2’
);
INSERT INTO RCS_MESSAGE_CONTENTS(
REG_DATE,
IMG_FILE_PATH,
IMG_MIME_TYPE,
IMG_DESCRIPTION
) VALUES (
now(),
‘/files/caousel_003.jpg’,
‘image/jpg’,
‘ 이미지 업로드3’
);
INSERT INTO RCS_MESSAGE (
RESERVE_DATE,
PHONE_NO,
CALLBACK,
MESSAGE_BASE_ID,
SERVICE_TYPE,
HEADER,
FOOTER,
COPY_ALLOWED,
IMG_GROUP_CODE,
IMG_CNT,
MMS_TITLE1,
MMS_MSG1,
MMG_IMG_URL1,
MMS_TITLE2,
MMS_MSG2,
MMG_IMG_URL2,
MMS_TITLE3,
MMS_MSG3,
MMG_IMG_URL3,
BUTTONS
) VALUES (
now(),
‘01012345678’,
‘1544-0000’,
‘SMwMgM0300’, # 메시지 템플릿 코드
‘RCSMMS’ # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
‘1’, # 0 : 정보성, 1 : 광고성
‘080-0000-0000’, # 광고성인 경우 필수 입력
true,
‘20220608000001’,
‘1’,
‘MMS 타이틀1’,
‘첫번째 Carousel 메시지’’,
‘maapfile://testImgUrl_001’,
‘MMS 타이틀2’,
‘두번째 Carousel 메시지’’,
‘maapfile://testImgUrl_002’,
‘MMS 타이틀3’,
‘세번째 Carousel 메시지’’,
‘maapfile://testImgUrl_003’,
‘[
{
"suggestions":[{
"action":{
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "Open Url",
"postback": {
"data": "set_by_open_url"
}
}
}]
}, #첫번째 Crousel 의 버튼 (1개)
{}, #두번째 Crousel 의 버튼 (0개)
{
"suggestions":[{
"action":{
"urlAction": {
"openUrl": {
"url": "https://www.google.com"
}
},
"displayText": "Open Url",
"postback": {
"data": "set_by_open_url"
}
}
}]
} #세번째 Crousel 의 버튼 (1개)
]’
);
RCSTMPL(서술형) 발송
RCSTMPL(서술형)은 사전에 등록한 텍스트 형식의 템플릿 유형으로 메시지를 발송하는 서비스입니다.
코드예제RCSTMPL(서술형) 발송 Sample Code
# RCSTMPL
INSERT INTO RCS_MESSAGE (
RESERVE_DATE,
PHONE_NO,
CALLBACK,
MESSAGE_BASE_ID,
SERVICE_TYPE,
BODY
) VALUES (
now(),
‘01012345678’,
‘1544-0000’,
‘RCS_TMPL001’, # 메시지 템플릿 코드
‘RCSTMPL’, # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
true,
‘{"description":"안녕하세요? 홍길동님으로부터 1,000 원이 입금되었습니다."}’ #템플릿 가변부 입력
);
RCSTMPL(스타일형) 발송
RCSTMPL(스타일형)은 사전에 등록한 템플릿 유형으로 메시지를 발송하는 서비스입니다.
코드예제RCSTMPL(스타일형) 발송 Sample Code
# RCSTMPL
INSERT INTO RCS_MESSAGE (
RESERVE_DATE,
PHONE_NO,
CALLBACK,
MESSAGE_BASE_ID,
SERVICE_TYPE,
BODY
) VALUES (
now(),
‘01012345678’,
‘1544-0000’,
‘RCS_TMPL001’, # 메시지 템플릿 코드
‘RCSTMPL’, # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
true,
‘{
"변수명1”:”변수값”,
“변수명2”:”변수값”
}’
);
RCS + SMS/LMS 대체 메시지 발송
RCS 서비스 발송 실패 시 일반 SMS 및 LMS로 대체 메시지를 발송합니다.
코드예제RCS + SMS/LMS 대체 메시지 발송 Sample Code
– RCSSMS + 부달발송
INSERT INTO RCS_MESSAGE (
RESERVE_DATE,
PHONE_NO,
CALLBACK,
MESSAGE_BASE_ID,
SERVICE_TYPE,
HEADER,
FOOTER,
COPY_ALLOWED,
BODY,
FALLBACK_YN,
FALLBACK_TYPE,
FALLBACK_CALLBACK,
FALLBACK_SUBJECT,
FALLBACK_MESSAGE
) VALUES (
now(),
‘01012345678’,
‘1544-0000’,
‘SS000000’,
‘RCSSMS’ # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
‘1’, # 0 : 정보성, 1 : 광고성
‘080-0000-0000’, # 광고성인 경우 필수 입력
true,
‘{ "title": "","description":"일반 RCSSMS 메시지입니다." }’,
true,
‘SM’, # [SM, LM]
‘1544-0000’,
‘’,
‘부달 발송 메시지.’
);
RCS 중계사 에러 코드
RCS 발송과 관련한 중계사 에러 코드는 다음과 같습니다.
표범례구분 | Error Code 사용 범위 |
---|---|
삼성 MaaP-Core | 40,000 |
이통사 MaaP-FE | 50,000 |
이통사 RcsBizCenter | 60,000 |
중계사 | 70,000 |
삼성 MaaP-Core 에러코드(40000~49999)
삼성 MaaP-Core 에러코드(40000~49999)는 다음과 같습니다.
표삼성 MaaP-Core 에러코드(40000~49999)Error Code | Error Message | 설명 |
---|---|---|
40001 | Missing Authorization header | Valid access token in Authorization header is required for RESTful API calls. |
40002 | Missing token | Authorization header does not contain a token. Note that token type is required. |
40003 | Invalid token | Token has been tampered. |
40004 | Token has expired | Token Has Expired |
40005 | Malformed token payload | Token payload has insufficient information. |
40006 | Invalid client id | Token is not issued to the client. |
40007 | Insufficient scope | Token is not authorized to use the scope. |
41000 | Internal Server Error | Internal Server Error |
41001 | RCS Request Timeout | RCS Request Timeout |
41002 | Revocation Failed | Revocation Failed |
41003 | Throttled by message rate | Throttled by message rate |
41004 | RCS Server Busy | RCS Server Busy |
41005 | RCS Server Temporarily unavailable | RCS Server Temporarily unavailable |
41006 | Session does not exist | Session does not exist |
41007 | Expired Before Session Establishment | RCS 세션 연결 전 만료되어 발송 실패 |
41008 | Session already expired | Session already expired |
41009 | Device not support revocation | |
41010 | IMDN received even already revoked | IMDN received even already revoked |
41011 | Message was already revoked | |
41100 | Connecting RCS Allocator Failed | Message Status on Response of Sending Message API |
41101 | Connecting RCS Allocator Timeout | Message Status on Response of Sending Message API |
41102 | RCS Allocation Failed | Message Status on Response of Sending Message API |
41103 | RCS Allocation Timeout | Message Status on Response of Sending Message API |
41104 | Connecting RCS Failed | Message Status on Response of Sending Message API |
41105 | Connecting RCS Timeout | Message Status on Response of Sending Message API |
41106 | Sending Message to RCS Failed | Message Status on Response of Sending Message API |
41107 | Sending Message to RCS Timeout | Message Status on Response of Sending Message API |
41108 | RCS handle request Failed | Message Status Webhook |
41109 | RCS Internal Server Error | Message Status Webhook |
41110 | RCS User Not Found | Message Status Webhook |
41117 | Process Revocation Request Failed | Message Status Webhook |
41200 | User for Message receiving Not Found | |
41201 | Message Not Acceptable | Message Session 형성 과정 중 단말의 SDP에 message 송신에 필요한 feature tag가 없는 경우 발생 |
41210 | User is not capable for TEXT | Bot이 Text message를 보낼 때 user의 capability에 chat이 없는 경우 발생 |
41211 | User is not capable for FT | Bot이 File message를 보낼 때 user의 capability에 fthttp가 없는 경우 발생 |
41212 | User is not capable for RICHCARD | Bot이 Richcard message를 보낼 때 user의 capability에 bot 또는 chatbot.sa가 없는 경우 발생 |
41220 | User is not capable for XBOTMESSAGE 1.0 | clipboardAction, messageHeader, messageFooter, openrichcard, geolocationPushMessage, copyAllowed |
41221 | User is not capable for XBOTMESSAGE 1.1 | clipboardAction, localBrowserAction, messageHeader, messageFooter, openrichcard, geolocationPushMessage, copyAllowedBot이 v1.1에 해당하는 Extended message를 보낼 때 user의 capability에 bot, chatbot.sa, xbotmessage 1.1이 없는 경우 발생. 이 때 xbotmessage는 상위 version이 하위 version을 포함한다. (1.2 version이 있다면 1.1에 해당하는 capability를 가진 것으로 간주함) |
41222 | User is not capable for XBOTMESSAGE 1.2 | clipboardAction, localBrowserAction, messageHeader, messageFooter, openrichcard, geolocationPushMessage, copyAllowed, shareAction, streamingPlay |
41230 | User is not capable for OPENRICHARD 1.0 | Bot이 v1.0에 해당하는 Openrichcard를 보낼 때 user의 capability에 bot, chatbot.sa, xbotmessage 1.0이 없는 경우 발생 |
41231 | User is not capable for OPENRICHARD 1.1 | v1.1에 해당하는 Openrichcard가 현재 정의 및 사용되지 않으므로, 실제 발생하지 않는 code |
41232 | User is not capable for OPENRICHARD 1.2 | v1.2에 해당하는 Openrichcard가 현재 정의 및 사용되지 않으므로, 실제 발생하지 않는 code |
41240 | User is not capable for GEOLOCATION PUSH REQUEST | User is not capable for GEOLOCATION PUSH REQUEST |
41250 | Failed to get message content type | Failed to get message content type |
41300 | File download failed | |
42001 | Invalid state | Bot is in an invalid state to call the API. |
42002 | Invalid message | Message is missing required fields or has malformed format. |
42003 | Invalid date/time format | Date and time format does not comply with ISO 8601. |
42004 | Missing contact | Missing recipient information. |
42005 | Invalid contact | Incorrect contact format (e.g., phone number is not start with '+') |
42006 | Emulator access only | Bot is in a state which allows access via Emulator only. |
42007 | Contact not in whitelist | Bot is accessible only to authorized users via MaaP client. |
42008 | Missing message content | Token Has Expired |
42009 | Invalid message content | Message is not any of textMessage, fileMessage, audioMessage, geolocationPushMessage, richcardMessage, or isTyping. |
42010 | Ambiguous message | One and only one of textMessage, fileMessage, audioMessage, geolocationPushMessage, richcardMessage, or isTyping should be provided if sending a message to the user. |
42011 | Invalid message status | Invalid MessageStatus |
42012 | Invalid isTyping status | Invalid IsTyping Status |
42013 | Invalid traffic type | Invalid TrafficType |
42014 | Invalid suggested chiplist association | suggestedChipList can be used together with one and only one of textMessage, fileMessage, audioMessage, geolocationPushMessage, or richcardMessage. |
42015 | Empty text message | Empty TextMessage |
42031 | Missing richcard | richcardMessage should contain a message, which should contain either generalPurposeCard or generalPurposeCardCarousel. |
42032 | Ambiguous richcard | A message should contain either richcard or richcard carousel. |
42033 | Too many richcards | Richcard carousel exceeds the maximum allowed richcards. |
42034 | Missing richcard layout | generalPurposeCard or generalPurposeCardCarousel should contain layout. |
42035 | Missing richcard content | generalPurposeCard or generalPurposeCardCarousel should contain content. |
42036 | Invalid cardOrientation | cardOrientation should be either HORIZONTAL or VERTICAL. |
42037 | Missing image alignment | Richcard HORIZONAL orientation should contain image alignment. |
42038 | Invalid image alignment | imageAlignment should be either LEFT or RIGHT. |
42039 | Redundant image alignment | Richcard VERTICAL orientation should not contain image alignment. |
42040 | Invalid richcard carousel cardWidth | Richcard carousel cardWidth should be either SMALL_WIDTH or MEDIUM_WIDTH. |
42041 | Mismatched media height | Media height cannot be TALL_HEIGHT for SMALL_WIDTH carousel. |
42042 | Invalid richcard content | generalPurposeCard or generalPurposeCardCarousel content should have at least one of media, title, or description. |
42043 | Invalid suggestions | Suggestion list should contain at least one suggested reply or action. |
42044 | Too many suggestions in chiplist (max 11) | Suggestion list exceeds the maximum allowed items. |
42045 | Invalid suggestion | Suggestion should be either reply or action. |
42046 | Ambiguous suggestion | Suggestion should be one and only one reply or action. |
42047 | Ambiguous suggested action | Suggested action should be one and only one type of action. |
42048 | Too many suggestions in richcard (max 4) | Richcard suggestion list exceeds the maximun allowed items (4). |
42049 | Too many suggestion data (max 2048) | Suggestion data exceeds the maxmun data size (2048). |
42050 | Invalid Action | Either latitude and longitude or query are required in location. |
42051 | Invalid location | Either latitude and longitude or query are required in location. |
42052 | Ambiguous location | Location should contain either query or latitude and longitude. |
42053 | Invalid mapAction | One of showLocation or requestLocationPush is required in mapAction. |
42054 | Ambiguous mapAction | mapAction should contain either showLocation or requestLocationPush. |
42055 | Invalid dialerAction | One of dialPhoneNumber, dialEnrichedCall, or dialVideoCall is required in dialerAction. |
42056 | Ambiguous dialerAction | dialerAction should contain only one type of dialer action. |
42057 | Invalid composeAction | Either composeTextMessage or composeRecordingMessage is required in composeAction. |
42058 | Ambiguous composeAction | composeAction should contain only one type of compose action. |
42059 | Invalid settingsAction | Either enableDisplayedNotifications or disableAnonymization is required in settingsAction. |
42060 | Ambiguous settingsAction | settingsAction should contain only one type of settings action. |
42061 | Invalid ClipboardAction | ClipboardAciton should contain copy text. |
42062 | Missing localBrowserAction | LocalBrowserAction should contain url. |
42063 | Invalid ShareAction | ShareAction should contain url. |
42064 | Ambiguous ShareAction | Sharetext of ShareAction should contain text. |
42100 | Invalid thumbnail | thumbnailFileSize and thumbnailContentType should be provided together with thumbnailUrl. |
42101 | Missing fileUrl | Missing FileUrl |
42102 | Missing audio fileUrl | Missing AudioFile Url |
42103 | Missing pos | Missing Pos |
42104 | Missing Media information | Missing Media Information |
42105 | Missing Media Content Type | Missing Media Information |
42106 | Missing Media FileSize | Missing Media Information |
42107 | Missing Media Height | Missing Media Information |
42108 | Missing postback data information | Missing postback data information |
42201 | Invalid Location Label | geolocationPushMessage should not contain label length > 200 Characters. |
42202 | Invalid media content description | Content Description of media is not in limit <1 Character or >200 Character. |
42203 | Invalid media title | Media title is not in limit <1 Character or >200 Character. |
42204 | Invalid media description | Media card description is not in limit <1 Character or >2000 Character. |
42205 | Too many contents in richard carousel | Richcard carousel list exceeds the maximum allowed items (10). |
42206 | Invalid media file size | Minimum Value for file size is 0. |
42207 | Invalid expiry time format | Invalid expiry time |
42208 | Invalid expiry time | Invalid expiry time |
42301 | Ambiguous Openrichcard | OpenrichcardMessage should contain a message, which should contain either generalPurposeCard or generalPurposeCardCarousel. |
42302 | Missing Openrichcard | A OpenrichcardMessage should contain open_rich_card. |
42303 | Missing Openrichcard Layout Widget | Openrichcard should contain widget. |
42304 | Missing Openrichcard View Content | View layout of Openrichcard do not have mandatory parameters. |
42305 | Missing Openrichcard LinearLayout Content | Parameters in LinearLayout have invalid value. |
42306 | Missing Openrichcard Textview Content | TextView layout of Openrichcard do not have mandatory parameters. |
42307 | Invalid Contents In Openrichcard Textview | Parameters in TextView have invalid value. |
42308 | Invalid Text Length In Openrichcard Textview | text is not limit in [0 < text < 2000]. |
42309 | Missing Openrichcard Imageview Content | ImageView layout of Openrichcard do not have mandatory parameters. |
42310 | Too Small Media In Openrichcard Imageview | MediaFileSize is under 0. |
42311 | Invalid Openrichcard Imageview Scaletype | ScaleType value of ImageView should be center or centerCrop or centerInside or fitCenter or fitEnd or fitStart or fitXY or matrix. |
42312 | Missing Openrichcard width or height | width or height is not in Openrichcard. |
42313 | Invalid Openrichcard width or height | width or height in Openrichcard has invalid value. |
42314 | Invalid Openrichcard Common Contents | Common Contents in Openrichcard has invalid value. |
42315 | Too many child in open rich card | |
42401 | Invalid file type | Invalid file type |
42402 | Download failure | Download failure |
42501 | Missing contact | Missing contact |
42502 | Missing content | Missing content |
42503 | Missing title | Missing title |
42504 | Missing description | Missing description |
42505 | Missing image url | Missing image url |
42506 | Missing image type | Missing image type |
42507 | Missing button link | Missing button link |
42508 | Missing button text | Missing button text |
42509 | Invalid title | Invalid title |
42510 | Invalid description | Invalid description |
42511 | Invalid image url address | Invalid image url address |
42512 | Invalid button url address | Invalid button url address |
42513 | Invalid button text | Invalid button text |
42514 | Duplicated message ID | Duplicated message ID |
42601 | Too Many Request | Too Many Request |
이통사 MaaP-FE 에러코드(50000~59999)
이통사 MaaP-FE 에러코드(50000~59999)는 다음과 같습니다.
표이통사 MaaP-FE 에러코드(50000~59999)Category | Error Code | Error Message | 설명 |
---|---|---|---|
N/A | 40000~49999 | MaaP-Core | SamSung MaaP-Core Error Code 참고 |
Authorization | 50001 | Missing Authorization header | |
50002 | Missing token | Authorization 헤더 값 누락 | |
50003 | Invaild token | 토큰이 일치하지 않습니다. | |
50004 | Token has expired | 토큰이 만료되었습니다. | |
50005 | Authorization Error | 인증 토큰 에러 | |
50006 | Invalid client id | 요청된 계정 정보를 찾을 수 없습니다. (BP ID) | |
50007 | Invalid sender id | 요청된 중계사 전송 계정을 찾을 수 없습니다. (RCS ID) | |
50008 | Invalid password | 잘못된 패스워드 | |
50009 | NonAllowedIp | 접근 허용된 IP가 아닙니다. | |
50100 | Invalid state | 메시지 전송을 할 수 없는 상태입니다. (서버의 요청 거부) | |
Limit | 50201 | Message TPS Exceeded | RCS 메시지 TPS가 초과되었습니다. |
50202 | Message Quota Exceeded | RCS 메시지 Quota가 초과되었습니다. | |
- | 59001 | SystemError | 시스템 에러 |
59002 | IOError | IO 에러 발생 | |
General | 51001 | SystemError | 시스템 에러 |
51002 | IOError | IO 에러 발생 | |
51003 | DuplicationError | 중복 Key 오류 | |
51004 | ParameterError | 요청 파라미터 형식 오류 | |
51005 | JsonParsingError | 요청 Body JSON 파싱 에러 | |
51006 | DataNotFound | 데이터를 찾을 수 없음 | |
51007 | Duplicated AutoReplyMsgId | 이미 사용 중인 자동응답 메시지 ID입니다. | |
51008 | Duplicated PostbackId | 이미 사용 중인 Postback ID입니다. | |
Chatbot | 52001 | Invalid phone number format | 전화번호 형식이 일치하지 않습니다. |
52002 | Invalid message status | 요청을 처리할 수 없는 상태입니다. | |
52003 | Bot Aleady Exists | 이미 사용 중인 챗봇 ID입니다. | |
52004 | Bot Creation Failed | 챗봇을 생성할 수 없습니다. | |
52005 | Bot Update Failed | 챗봇 정보를 변경할 수 없습니다. | |
52006 | Brand Delete Failed | 챗봇이 있는 브랜드는 삭제할 수 없습니다. | |
52007 | InvalidChatbotServiceType | 챗봇 Type은 a2p, chatbot로 설정해야 함 | |
52008 | MismatchedChatbotId | 요청 URL Parameter의 챗봇 Id와 Body Parameter 불일치 | |
52009 | Persistent Menu Permission Error | Persistent Menu 등록이 허용되지 않습니다. | |
52010 | Invalid Persistent Menu Data | Persistent menu JSON 데이터 오류 | |
- | 52016 | Message Transmission Time Exceeding | 실시간 메시지 인입 후 10초안에 삼성으로 전달되지 못함 |
52023 | Messagebase Id Stopped Temporarily | 메시지 베이스의 상태가 'pause'인 메시지 베이스 메시지로 전문 구성하여 전송 시도 시 | |
Webhook I/F | 52101 | Invalid Webhook Request Parameter | 잘못된 Webhook 중계사 요청 파라미터입니다. |
52102 | Webhook Host Connect Error | Webhook 중계 시스템 연결 오류 | |
52103 | Webhook Host Server Request Failure | 중계사 Webhook 전송 요청을 실패했습니다. | |
52104 | Webhook Response Receive Failure | 중계사 Webhook 처리 응답 수신 오류가 발생했습니다. | |
52105 | Webhook Message Non Receive Failure | Webhook 메시지 미 수신 오류가 발생했습니다. | |
52106 | Webhook Message Process Failure | Webhook 메시지 처리 오류가 발생했습니다. | |
Auto Reply Message | 52201 | Invalid Auto Reply Message ID | 자동응답 메시지 ID가 존재하지 않습니다. |
52202 | Auto Reply Message Contents Error | 자동응답 메시지 내용 중 누락된 필수 항목이 있습니다. | |
File | 53001 | Invalid file type | 요청을 처리할 수 없는 파일 유형입니다. |
53002 | File Attribute Error | 파일 속성 오류 | |
53003 | FileID format Error | fileID가 없거나 ID 형식에 맞지 않음 | |
53004 | FileUploadError | File 저장 오류 | |
53005 | InvalidMultiPartRequest | Multipart 데이터 전송 오류 | |
53006 | Attached File Size Error | 업로드 파일 크기 초과 | |
Webhook (Message) | 54001 | Invaild Contact number User | 자사 고객이 아닙니다. |
54002 | No Rcs Capability | 자사 고객이지만, RCS메시지를 수신할 수 있는 가입자가 아닙니다. | |
54003 | Unable Sending to Recipient | 단말기기로 RCS 메시지를 전송할 수 없습니다. | |
54004 | MaaP Internal Error | MaaP 시스템 혹은 RCS 프로토콜 상의 이슈로 발송 실패되었음 (삼성 에러 40001 ~ 41100, 42601) | |
Brand, Corp | 55001 | Corp Content Error | |
55002 | Invalid Property | 필수 파라미터 검증 오류 | |
55101 | Agency Content Error | 대행사 정보 내용이 누락된 필수 항목이 있습니다. | |
55102 | Invalid AgencyId | AgencyID가 존재하지 않습니다. | |
55103 | AgencyID permission error | BrandID에 대행 권한이 없는 AgencyID | |
55104 | Contract Content Error | 계약 정보 내용이 부정확하거나 누락된 필수 항목이 있습니다. | |
55201 | Brand Content Error | 브랜드 정보 내용이 누락된 필수항목이 있습니다. | |
55202 | Brand name Error | 브랜드 명이 누락되어 있습니다. | |
55203 | Brand profile image Error | 브랜드 프로필 이미지가 누락되어 있습니다. | |
55204 | Brand CS number Error | 브랜드 CS번호가 누락되어 있습니다. | |
55205 | Brand menu Error | 브랜드 메뉴 최대 개수를 초과하였거나 부정확합니다. | |
55206 | Brand category Error | 브랜드 카테고리 설정이 잘못되어 있습니다. | |
55207 | Brand homepage Error | 브랜드 홈페이지 설정이 잘못되어 있습니다. | |
55208 | Brand email Error | 브랜드 이메일 설정이 잘못되어 있습니다. | |
55209 | Brand address Error | 브랜드 주소가 잘못되어 있습니다. | |
55210 | Invalid BrandID | 브랜드ID가 존재하지 않음 | |
55301 | Bot Content Error | 챗봇 정보 내용이 부정확하거나 누락된 필수 항목이 있습니다. | |
55302 | Invalid BotID | BotID(발신번호)가 전화번호 형식에 맞지 않음 | |
55303 | BotID permission error | BrandID에 존재하지 않는 BotID | |
MessageBase | 55501 | Messagebase Content Error | 메시지베이스 내용이 부정확하거나 누락된 필수 항목이 있습니다. |
55502 | Invalid MessagebaseID | MessagebaseID가 존재하지 않음 | |
55503 | MessagebaseID permission error | BrandID에 존재하지 않는 MessagebaseID입니다. | |
55504 | Invalid formatstring | messagebase의 formatstring 누락된 필수 항목이 있습니다. | |
55505 | Invalid messagebase Policy Info | messagebase의 policy Info가 부정확하거나 누락된 필수 항목이 있습니다. | |
55506 | Invalid messagebase param | messagebase의 param 부정확하거나 누락된 필수 항목이 있습니다. | |
55507 | Invalid messagebase attribute | messagebase의 attribute 부정확하거나 누락된 필수 항목이 있습니다. | |
55508 | Invalid messagebase type | messagebase의 type 부정확하거나 누락된 필수 항목이 있습니다. | |
55509 | mismatching Product type | messagebaseID의 product type과 일치하지 않음 | |
55601 | MessagebaseForm Content Error | MessagebaseForm 내용이 부정확하거나 누락된 필수 항목이 있습니다. | |
55602 | Invalid messagebaseformID | messagebaseformID가 존재하지 않습니다. | |
55603 | Invalid MessageBase ProductCode | messaegBase의 상품코드 에러 | |
Send Message | 55701 | prohibited text content | "(광고)"를 사용할 수 없음 |
55702 | Action button Permission error | Action button이 허용되지 않는 messagebaseID에서 Action button을 사용하였음 | |
55703 | prohibited header value | 허용되지 않은 header 값 사용 | |
55704 | prohibited footer field | header 값과 일치 하지 않은 footer 사용 (ex. header가 0 인데, footer 가 있음) | |
55705 | missing footer content | footer값이 누락되어 있습니다. (ex. header가 1 인데, footer 가 없음) | |
55706 | footer content syntax Error | footer validation 오류 (ex. 숫자, 하이픈만 가능. 20자리) | |
55707 | content pattern error | 등록한 패턴과 일치 하지 않음 | |
55708 | Exceeded max character of title | title 최대글자수를 초과했습니다. | |
55709 | Exceeded max character of description | description 최대글자수를 초과했습니다. | |
55710 | Exceeded max number of buttons | 최대 버튼수를 초과했습니다. | |
55711 | mismatching number of carousel card | messagebaseID의 number of card 와 입력이 일치하지 않음 | |
55712 | Exceeded max size of media | 최대 미디어 용량을 초과했습니다. | |
55714 | Expired ReplyId | Reply ID의 유효시간이 만료되었습니다. | |
55715 | Not Found ReplyId | Reply ID가 존재하지 않음 | |
55801 | GwVendor Content Error | 중계사 정보가 부정확하거나 누락된 필수 항목이 있습니다. | |
55802 | Invalid message | 메시지 형식이 부정확하거나 누락된 필수 항목이 있습니다. | |
55803 | Message Syntax Error | 메시지 기술방법이 잘못되었습니다. | |
55804 | Missing message content | 메시지 내용이 누락되었거나 부정확합니다. | |
55805 | Invalid message content | 요청을 처리할 수 없는 메시지 유형입니다. | |
55806 | Duplicated MessageId | 같은 메시지 ID로 두번 이상 메시지 발송이 요청됨 | |
55807 | Invalid Chatbot Permission | 챗봇 권한 오류 | |
55808 | Invalid Chatbot Status | 발신 가능한 챗봇 상태가 아님 | |
55809 | Invalid Agency Permission | 대행사 권한 오류 | |
55810 | Invalid Expiry Field | 메시지 유효기간 입력값 오류 | |
55811 | Exceeded Max Character Of Param | 메시지베이스 파라미터의 길이가 한계값 이상 | |
55812 | Buttons Not Allowed | ㅊ | |
55813 | Exceed Button Text Length | 최대 버튼 글자수 초과 | |
55814 | Invalid MessageBase Buttons | 버튼 형식 오류 | |
55815 | Message Body File Not Found | 존재하지 않는 File이거나 usageType 오류 | |
55816 | Mismatched Suggestions Count | Empty suggestions array 허용 안함 | |
55817 | Invalid Dest Phone Number | 수신 번호 형식 오류 | |
55818 | Invalid MessageBase Id | 메시지베이스 ID가 존재하지 않음 | |
55819 | Invalid Chatbot Id | 챗봇ID가 존재하지 않음 | |
55820 | Revoked Message | Webhook Revoked 메시지 | |
55821 | Etc TimeOut | 전송 성공 불확실함 (revocation fail 등) | |
55822 | Canceled Message | 메시지 취소되어, 전송안됨 | |
55822 | Invalid Chatbot Yn | 양방향 서비스 사용불가 | |
55823 | Mismatched suggestedChipList Count | Empty suggestedChipList array 허용 안함 | |
55824 | Chiplist Not Allowed | 칩리스트 필드를 사용할 수 없습니다. | |
55825 | Buttons Reply Not Allowed | 버튼 필드에 Reply를 사용할 수 없습니다. | |
55880 | Mismatched CarouselButton Count | 메시지카드 버튼 개수 상이 | |
55881 | Mismatched ChipList Count | 칩리스트 개수 초과 | |
55882 | ChipList Not Allowed | ChipList 발송 가능하지 않음 | |
55883 | Invalid ReplyId | 유효한 replyId 아님 | |
55884 | Missing ReplyId | replyId 값 누락 됨 | |
55885 | Invalid User Contact For SessionMessage | replyId 와 일치하는 수신번호가 아님 | |
55886 | Invalid ChatbotId For Session Message | replyId 와 일치하는 Chatbot ID 아님 | |
55887 | Invalid MessageBase ProductCode For Session Message | messagebase 상품 코드가 세션 메시지 가능하지 않음 | |
55888 | Not Allowed Chatbot For Session Message | Chatbot 이 세션 메시지 가능하지 않음 | |
55900 | Non Retryable Error Caused By Invalid Message | 잘못된 메시지 형식으로 인해 발송 실패되었고 재시도 가능하지 않음 (삼성 에러 42001 ~ 42514) | |
56002 | Revocation Failed | 메시지 회수 실패 (삼성 에러 41002) | |
56007 | Expired Before Session Establishment | RCS 세션 연결 전 만료되어 발송 실패 (삼성 에러 41007) | |
59002 | Backend Error | Backend(삼성 MaaP G/W) 서버 내부 에러 | |
59003 | Backend Timeout | Backend(삼성 MaaP G/W) 서버 타임 아웃 발생 | |
59999 | Etc Error | 기타 정의되지 않은 Error (Webhook Cancelled 메시지 등) | |
임시 실패 코드 | 51900 | Not Found Handler | 잘못된 요청입니다. |
51901 | Samsung MaaP Connect IF Error | 삼성 MaaP Gateway NB API 연동 에러 | |
51902 | Samsung MaaP Service IF Error | 삼성 MaaP Registry Chatbot API 연동 에러 | |
51903 | Capri IF Error | Capri 연동 에러 | |
51904 | Webhook Execute Imposible Status Failure | Webhook 처리 불가 상태 오류가 발생했습니다. | |
51905 | Webhook CDR Log Writing Failure | Webhook 메시지 전송 과금 이력 작성을 실패했습니다. | |
51906 | Invalid Webhook Url | 잘못된 Webhook Url 입니다. | |
51907 | Expired Webhook Message | 만료된 메시지입니다. | |
51908 | Exceed Retry Count to Send Message | 재시도 횟수 초과로 인해 메시지 전송을 실패했습니다. | |
51909 | Non Existing Webhook Message | Webhook 발송 메시지가 존재하지 않습니다. | |
51910 | Non Existing Webhook GW Vendor | Webhook 발송 중계사 정보가 존재하지 않습니다. | |
51911 | No Subscription | 계약관계가 없습니다. | |
51912 | Failure in Preperation for sending Webhook | Webhook 발송 준비 수행 중 오류가 발생했습니다. | |
51913 | Failure in Updating Webhook Sending Result State | Webhook 발송 결과 상태 갱신 중 오류가 발생했습니다. | |
51914 | Failure in Updating CDR Result State | CDR 생성 결과 상태 갱신 중 오류가 발생했습니다. | |
51915 | Failure in Updating Completion Result State | 완료 처리 결과 상태 갱신 중 오류가 발생했습니다. | |
51916 | Failure in Updating Expiration Result State | 만료 처리 결과 상태 갱신 중 오류가 발생했습니다. | |
51917 | Webhook Msg Log Creation Error | 메시지 이력 생성 작업 중 오류가 발생했습니다. | |
51918 | Webhook Msg Log Creation Failure | 메시지 이력 생성 작업을 실패했습니다. | |
51919 | Invalid Webhook Receive Request Error | 잘못된 Webhook 요청 오류 | |
51920 | Non Existing Chatbot For Request | 요청 양뱡향 챗봇에 대한 정보가 존재하지 않습니다 | |
51921 | Non Usable Chatbot State Error | 사용 불가 챗봇 상태 오류입니다. | |
51922 | Non Existing Gw Vendor For Request | 요청 양방향 챗봇에 대한 양방향 중계사 정보가 존재하지 않습니다. | |
51923 | Non Definition Mo Message Url for Chatbot | 챗봇 Mo 발송 URL 정보가 미정의 상태입니다. | |
51924 | Webhook Gateway Execution Error | Webhook 수신 Gateway 수행 오류 | |
51925 | Not Allowed Request Event Error | 미 허용 Webhook 이벤트 요청 오류 | |
51926 | Webhook Receive Execution Error | Webhook 수신 처리 수행 오류 | |
51927 | Webhook Receive Async Execution Error | Webhook 수신 처리 비동기 수행 오류 | |
51928 | Non Definition Webhook Url for Gw Vendor Cid | 중계사 CID Webhook 발송 URL 정보가 미정의 상태입니다. | |
51929 | Non Target GwVendor for CDR Log | 과금 미 처리 대상 중계사입니다. | |
51930 | Non Received Webhook Command Error Log | 수행 명령 객체 미전달 오류입니다. | |
51931 | Mo Message Registration Error | Mo 메시지 DB 등록 오류가 발생했습니다. | |
51932 | Mo Message Registration Failuer | Mo 메시지 DB 등록 작업을 실패했습니다. | |
51933 | Auto Reply Message Sending Error | 자동 응답 메시지 발송 수행 오류가 발생했습니다. | |
51934 | Non Service Supported Error | 처리 미 대상 서비스입니다. | |
51935 | Samsung MaaP Core File Server Connection Error | 삼성 MaaP Core 파일 서버 연결 오류가 발생했습니다. | |
51936 | Message FileMessage Event File Download Error | 파일 메시지 이벤트의 파일 메시지 다운로드 수행 오류가 발생했습니다. | |
51937 | Message FileMessage Event File Download Error | 파일 메시지 이벤트의 파일 메시지 다운로드 수행 오류가 발생했습니다. | |
51938 | Message FileMessage Registration to DB Error | 파일 메시지 이벤트의 파일 정보 DB 등록 오류가 발생했습니다. | |
51939 | Message FileMessage Registration to DB Failure | 파일 메시지 이벤트의 파일 정보 DB 등록 작업을 실패했습니다. | |
51950 | Webhook Scheduler Async Execution Error | Webhook 스케줄러 비동기 수행 오류 | |
51951 | Webhook Scheduler DB Execution Error | Webhook 스케줄러 DB 수행 오류 | |
51952 | Webhook Scheduler DB Execution Failuer | Webhook 스케줄러 DB 수행 실패 | |
51953 | Webhook Scheduler Process Execution Error | Webhook 스케줄러 프로세스 수행 오류 | |
51954 | Webhook Scheduler Process Execution Failuer | Webhook 스케줄러 프로세스 수행 실패 | |
51955 | Webhook Scheduler Processor Execution Error | Webhook 스케줄러 프로세서 수행 오류 | |
51956 | Webhook Scheduler Processor Execution Failuer | Webhook 스케줄러 프로세서 수행 실패 | |
51957 | Non Existing Mo Message Error | Mo 메시지가 존재하지 않습니다. |
이통사 RcsBizCenter 에러코드 (60000~69999)
이통사 RcsBizCenter 에러코드(60000~69999)는 다음과 같습니다.
표이통사 RcsBizCenter 에러코드(60000~69999)Error Code (AS IS) |
Error Code (TO BE) |
Error Message | 설명 |
---|---|---|---|
60004 | 60004 | No Content | 요청을 성공적으로 처리했으나 데이터가 없음 |
61001 | 61001 | Missing Authorization header | Authorization 헤더 파라미터 누락 |
61002 | 61002 | Missing Token | Authorization 헤더 값(Token) 누락 |
61003 | 61003 | Invalid token | 유효하지 않은 Token |
61004 | 61004 | Token has expired | Token 만료 |
61005 | 61005 | Invalid client id | 유효하지 않은 client ID |
61006 | 61006 | Invalid secret key | 유효하지 않은 secret key |
63001 | 63001 | No Brand Permission | 브랜드에 대한 권한 없음 |
64001 | 64001 | Missing X-RCS-BrandKey header | X-RCS-BrandKey 헤더 누락 |
64002 | 64002 | Invalid Brand Key | X-RCS-BrandKey의 Brand Key 오류 |
64101 | 64101 | Invalid brandId on path parameter | URL 내 Brand ID 오류 |
64102 | 64102 | Invalid agencyId on path parameter | URL 내 Agency ID 오류 |
64103 | 64103 | Invalid corpRegNum on path parameter | URL 내 사업자등록번호 오류 |
64104 | 64104 | Invalid personId on path parameter | URL 내 Person ID 오류 |
64105 | 64105 | Invalid chatbotId on path parameter | URL 내 chatbot ID 오류 |
64106 | 64106 | Invalid messagebaseId on path parameter | URL 내 messagebase ID 오류 |
64107 | 64107 | Invalid messagebaseformId on path parameter | URL 내 messagebaseform ID 오류 |
64201 | 64201 | Invalid query parameter ({name of paramter}) | 유효하지 않은 Query 파라미터 : (해당 파라미터) |
64202 | 64202 | Invalid query parameter value ({name of paramter}:{value}) | Query 파라미터 값 오류: (오류발생 값) |
64203 | 64203 | query paramter required ({name of paramter}) | 필수 Query 파라미터 누락: (누락된 파라미터) |
64301 | 64301 | Missing Body data | Body Data 누락 |
64302 | 64302 | Invalid JSON format | Body Data JSON 형식 오류 |
64303 | 64303 | Invalid type of Attribute ({name of attribute}) | Attribute type 오류: (오류 발생 attribute) |
64304 | 64304 | Over specified size ({name of attribute}) | 지정된 사이즈 초과: (사이즈 초과된 attribute) |
64305 | 64305 | Missing Certification document | 발신번호 등록 시 통신서비스이용증명원 파일 누락 |
64306 | 64306 | Exceed MDN registration quantity | 발신번호 등록 시 발신번호 등록 개수 초과 |
64307 | 64307 | Missing MDN | 발신번호 등록 시 발신번호 누락 |
64308 | 64308 | Invalid MDN format | 발신번호 등록 시 발신번호 형식 오류 |
64309 | 64309 | Missing chatbot name | 발신번호 등록 시 챗봇이름 누락 |
64310 | 64310 | Invalid display format | 발신번호 등록 시 display 설정 형식 오류 |
64311 | 64311 | Invalid smsmo format | 발신번호 등록 시 smsmo 형식 오류 |
64312 | 64312 | Missing messagebaseformId | 템플릿 등록 시 템플릿 양식 ID 누락 |
64313 | 64313 | Invalid messagebaseformId | 템플릿 등록 시 템플릿 양식 ID 오류 |
64314 | 64314 | Missing Template name | 템플릿 등록 시 템플릿명 누락 |
64315 | 64315 | Missing brandId | 템플릿 등록 시 브랜드 ID 누락 |
64316 | 64316 | Invalid brandId | 템플릿 등록 시 브랜드 ID 오류 |
64317 | 64317 | Invalid agencyId | 템플릿 등록 시 대행사 ID 오류 |
64318 | 64318 | Invalid formattedString format | 템플릿 등록 시 formattedString 형식 오류 |
중계사 에러코드 (70000~79999)
중계사 에러코드(70000~79999)는 다음과 같습니다.
표중계사 에러코드 (70000~79999)Category | Error Code(RCS) | Error Code (TCP/CMA) |
Error Code (Xroshot) |
Error Message | 설명 |
---|---|---|---|---|---|
MaaP-Core | 40000~49999 | - | N/A | - | SamSung MaaP-Core Error Code 참고 |
MaaP-FE | 50000~59999 | N/A | - | MaaP-FE Error Code 참고 | |
RcsBizCenter | 60000~69999 | N/A | - | RcsBizCenter Error Code 참고 | |
Success | 00000 | 00000 | 0 | Success | 성공 |
Authorization | 70001 | Missing Authorization header | HTTP 요청 헤더에 인증 정보가 없습니다. | ||
70002 | Missing token | 인증정보에 토큰이 없습니다. | |||
70003 | Invaild token | 토큰이 일치하지 않습니다. | |||
70004 | Token has expired | 토큰이 만료되었습니다. | |||
70005 | 70005 | 2 | Authorization Error | 인증에 실패하였습니다. | |
70006 | 70006 | Invalid client id | 요청된 계정 정보를 찾을 수 없습니다. (BP ID) | ||
70007 | 70007 | 5 | Invalid sender id | 요청된 중계사 전송 계정을 찾을 수 없습니다. (RCS ID) | |
70008 | 70008 | 7, 8 | Invalid password | 잘못된 패스워드 | |
70009 | 17 | Non allowed ip | 접근 허용된 IP가 아닙니다. | ||
General | 71001 | 71001 | 1, 500, 503, 504, 600, 603 |
System Error | 시스템 에러 |
71002 | IOError | IO 에러 발생 | |||
71003 | 71003 | Duplication Error | 중복 Key 오류 | ||
71004 | 71004 | Parameter Error | 요청 파라미터 형식 오류 | ||
71005 | 71005 | Json Parsing Error | 요청 Body JSON 파싱 에러 | ||
71006 | 71006 | Data Not Found | 데이터를 찾을 수 없음 | ||
71007 | 71007 | 400 | Not Found Handler | 잘못된 요청입니다. | |
71008 | 71008 | Missing Mandatory Parameter | 필수 파라미터가 누락되었습니다. | ||
71009 | Invalid Data State | 잘못된 데이터 상태입니다. | |||
71010 | MAAP-FE API Error | MAAP-FE API 연동 에러 | |||
71011 | Kisa GW Error | KISA GW 연동 에러 | |||
Message | 72100 | 99, 403 |
Invalid State | 메시지 전송을 할 수 없는 상태입니다. (서버의 요청 거부) | |
72101 | 72101 | Common Info Error | 공통 메시지 정보가 부정확하거나 누락된 필수 항목이 있습니다. | ||
72102 | Legacy Info Error | Legacy 메시지 정보가 부정확하거나 누락된 필수 항목이 있습니다. | |||
72103 | 72103 | Rcs Info Error | RCS 메시지 정보가 부정확하거나 누락된 필수 항목이 있습니다. | ||
72104 | 72104 | Message TPS Exceeded | RCS 메시지 TPS가 초과되었습니다. | ||
72106 | 72106 | Message Media Not Found | 미디어 파일을 찾을수 없습니다. | ||
72107 | 72107 | Invalid Media File Type | 요청을 처리할 수 없는 파일 유형입니다. | ||
72108 | 3 | Invalid Message Type | 메시지 형식오류(메시지 규격에 맞지 않을 경우) | ||
72109 | 2101, 2152 |
Invalid Content Type | 올바른 콘텐츠가 아님 | ||
72110 | 90 | Exceeded number of contents | 동보 개수 초과 (Agent 내부) | ||
72111 | 91 | Data Type Error | 데이터 형식 오류 (Agent 내부) | ||
72112 | 92 | Attached File Error | 첨부파일 오류 (Agent 내부) | ||
72113 | 93 | File Upload Error | 파일 업로드 실패 | ||
72114 | 94 | Convert Timeout | Convert 타입 아웃 | ||
72115 | 95 | Attached file size Error | 첨부파일 용량 오류 | ||
72116 | 96 | Webfile Download Error | 웹파일 다운로드 오류 | ||
72117 | 72117 | 208 | Exceeded message content size | 메시지가 Overflow 되어 받지 못함 | |
72118 | 72118 | 214 | Sub Type Error | Sub Type 오류 (전송 실패) | |
72119 | 222 | Invalied Data Type | 잘못된 Data Type인 경우 | ||
72120 | 2100 | Message Format Error | 메시지 포맷 오류 | ||
72121 | 2104 | Exceed Content Size | 콘텐츠 크기가 커서 처리할 수 없음 | ||
72122 | 72122 | Invalid Chatbot Permission | 계약관계가 없거나 해당 챗봇이 존재하지 않음 | ||
72123 | 72123 | Invalid Service Type | 올바른 메시지 서비스 타입이 아님 | ||
72124 | 72124 | Invalid Service Permission | 해당 메시지 서비스 타입에 권한이 없어 전송 불가 | ||
72125 | 72125 | Invalid Expiry Option | 올바른 메시지 Expiry Option이 아님 | ||
72126 | 72126 | Invalid Header | 올바른 메시지 Header가 아님 | ||
72127 | 72127 | Invalid Footer | 올바른 메시지 Footer가 아님 | ||
72128 | 72128 | MessageSMSQuotaExceeded | SMS 발송 수량 초과 | ||
72129 | 72129 | MessageLMSQuotaExceeded | LMS 발송 수량 초과 | ||
72130 | 72130 | MessageMMSQuotaExceeded | MMS 발송 수량 초과 | ||
72131 | 72131 | MessageTMPLTQuotaExceeded | TMPLT 발송 수량 초과 | ||
72132 | Message CHAT Quota Exceeded | CHAT 발송 수량 초과 | |||
72133 | Chiplist Not Allowed | 칩리스트를 사용할 수 없습니다. | |||
72134 | Invalid Chatbot Chat Permission | 양방향 챗봇에 대한 권한이 없습니다. | |||
72135 | Not Found Corp Chat | 양방향 기업 데이터가 존재하지 않습니다. | |||
72136 | Invalid Chat Message Permission | 양방향 서비스에 대한 권한이 없습니다. | |||
72137 | Not Found ReplyId | Reply ID가 존재하지 않습니다. | |||
72138 | Expired ReplyId | Reply ID 유효시간이 만료되었습니다. | |||
Service | 73001 | 73001 | 27 | Unavailable Service | 가입되지 않은 상품 발송 |
73002 | UnsubscribedLegacyService | Legacyinfo가 있지만 청약 정보 내 크로샷 ID가 없는 경우 | |||
Spam | 74001 | 101 | Message Content Spam | 메시지 내용 스팸 | |
74002 | 102 | Sender Number Spam | 발신자 스팸 | ||
74003 | 103, 4404 |
Receipient Number Spam | 착신자 스팸 | ||
74004 | 104 | Callback Number Spam | 회신 번호 스팸 | ||
74005 | 108 | Same Message Limit | 동일 메시지 제한 | ||
74006 | 111 | Same Receipient Number Limit | 동일 착신번호 제한 | ||
74007 | 114 | Number Theft Block | 번호도용/변작방지 차단 | ||
74008 | 115 | Callback Number Block | 미등록 회신번호 차단 | ||
74009 | 116 | Number Rule Violation Block | 번호세칙 위반 차단 | ||
NPDB | 75001 | 209 | NPDB user (send fail) | 번호 이동된 가입자 (전송 실패) | |
75002 | 212, 404, 202 |
There is no subscriber | 가입자 없음 | ||
75003 | 213 | CAPRI & NPDB Error | NPDB 오류 | ||
75004 | 9, 10, 203 |
There is no end user | End-User(사용자) 존재하지 않음, 해지, 정지 | ||
75005 | 227, 228, 2107, 216 |
Receipient's number Error | 착신번호 에러 (자리수 에러, 없는 번호) | ||
75006 | 2106 | Sender number Error | 발신번호 오류 | ||
75007 | No Rcs Capability | 자사 고객이지만, RCS 메시지를 수신할 수 있는 가입자가 아닙니다. | |||
75008 | 75008 | Invalid User Contact | 잘못된 규격의 착신번호 | ||
Schedule Manager | 76001 | Capri interface Error | CAPRI 연동 실패 | ||
76002 | Schedule Manager Internal Error | Schedule Manager 내부 에러 | |||
Xroshot Sender | 76003 | Not Found Rcs Subscriber | RCS 가입 정보 없음 | ||
76004 | Xroshot Sender Internal Error | Xroshot Sender 내부 에러 | |||
Xroshot Manager | 76005 | Xroshot Manager Internal Error | Xroshot Manager 내부 에러 | ||
webhook | 77001 | 16, 112, 211, 487 |
Expired message received time | Legacy : 리포트 수신 시간 만료 (메시지 전송 후, 24시간 리포트 못받는 경우)RCS 3일 | |
77002 | 221 | Invalied Message Sequence | Message Sequence Number가 틀린 경우 | ||
77003 | Non Existing Webhook Message | Webhook 발송 메시지가 존재하지 않습니다. | |||
77004 | Invalid Webhook Message | 잘못된 Webhook 발송 메시지입니다. | |||
77005 | Non Existing Webhook Corporation | Webhook 회사 정보가 존재하지 않습니다. | |||
77006 | Webhook Msg Log Writing Failure | Webhook 메시지 전송 이력 정보 작성을 실패했습니다. | |||
77007 | Disabled Send Webhook Msg | 해당 RCS ID의 webhook 발송 설정이 꺼져있습니다. | |||
77008 | Webhook Failure Status | Webhook 상태 코드 실패 수신 | |||
77009 | Invalid Webhook Message | Webhook 메시지가 유효하지 않습니다. | |||
77010 | Invalid Webhook EventType | Webhook EventType이 유효하지 않습니다. | |||
77011 | Invalid Webhook Message Status | Webhook Message Status type이 유효하지 않습니다. | |||
77012 | Not Found Agency | 대행사 정보가 존재하지 않습니다. | |||
77013 | Non Existing MO Message | MO 메시지가 존재하지 않습니다. | |||
78001 | 2103 | Unsupport Error | 미지원 단말 | ||
78002 | 200 | Calling | 통화중 | ||
78003 | 201, 486 |
Device No response | 무응답 (단말기 무응답) | ||
78004 | 204 | Device Power Off | 단말기 전원 꺼짐 | ||
78005 | 205 | Shaded Area | 음영 지역 | ||
78006 | 206 | Device Message Full | 단말 메시지 Full | ||
78007 | 210 | SMS Forward Exceed | SMS 착신전환 회수 초과 | ||
78008 | 215 | Invalid Subscriber Name | 한글/영문 외 가입자 일 경우 | ||
78009 | 226 | No CallbackUrl User | CallbackURL 사용자 아님 | ||
78010 | 4305 | Invalid Device Error | 비가용폰 오류 | ||
Retry Manager | 79001 | Retry Count Exceeded | 재시도 횟수를 초과하였습니다. | ||
Querymsgstatus API | 79002 | Concurrent Max Request Exceeded | 최대 동시 접속 수 초과 | ||
79003 | RCS ID Mismatched | RCS ID 불일치 오류 | |||
79004 | Invalid Query Request | 잘못된 메시지 결과 요청 | |||
79005 | Exceed Query Limit Count | 메시지 조회 횟수 한도 초과 | |||
79006 | Request Query Execution Failure | 요청 수행 실패 | |||
79007 | Duplicated Query Id | 요청 ID 중복 오류 | |||
79008 | InvaildRequestError | 유효하지 않는 서버로의 요청 | |||
79009 | Reserved | Reserved | |||
79010 | Invalid Result Policy | 결과 메시지 조회 정책 미유효 | |||
79011 | NonExistQueryId | 요청 ID 미존재 오류 | |||
MaaP-FE Fail | 79994 | KT MaaP-FE Fail | KT 통신사 장애로 실패 | ||
79995 | SKT MaaP-FE Fail | SKT 통신사 장애로 실패 | |||
79996 | LGU MaaP-FE Fail | LGU 통신사 장애로 실패 | |||
79997 | TimeOut | 전송 실패 (expiryOption TimeOut 등) | |||
79998 | Etc TimeOut | 전송 성공 불확실함 (expiryOption TimeOut 등) | |||
Unknown | 79999 | 207, 5300 | Unknown Error | Unknown Error | |
내부 임시 실패 코드 | 77701 | Non Existing Webhook Message | 전달된 Webhook 메시지에 대한 메시지가 존재하지 않습니다. | ||
77702 | Invalid Webhook Message | 잘못된 Webhook 발송 메시지입니다. | |||
77703 | Non Existing Webhook GW Vendor | Webhook 발송 중계사 정보가 존재하지 않습니다. | |||
77704 | Invalid Webhook GW Vendor | 잘못된 Webhook 발송 중계사입니다. | |||
77705 | Webhook CDR Log Writing Failure | Webhook 메시지 전송 과금 이력 작성을 실패했습니다. | |||
77706 | Webhook Msg Log Writing Failure | Webhook 메시지 전송 이력 정보 작성을 실패했습니다. | |||
77707 | Failure in updating Webhook Message | 전달된 Webhook 메시지에 대한 상태 변경 작업을 실패했습니다. | |||
77708 | Invalid Webhook Request Parameter | 잘못된 Webhook 중계사 요청 파라미터입니다. | |||
77709 | Webhook Host Connect Error | 발송 중계 시스템 연결 오류 | |||
77710 | Webhook Host Server Request Failure | 발송 Webhook 전송 요청을 실패했습니다. | |||
77711 | Webhook Response Receive Failure | 발송 Webhook 처리 응답 수신 오류가 발생했습니다. | |||
77712 | Invalid Webhook Url | 잘못된 Webhook URL 입니다. | |||
77713 | Expired Webhook Message | 만료된 메시지입니다. | |||
77714 | Exceed Retry Count to Send Message | 재시도 횟수 초과로 인해 메시지 전송을 실패했습니다. | |||
77715 | Failure in Sending Message to MaaP Core FE | MaaP Core로의 메시지 전송을 실패했습니다. | |||
77716 | Failure in Linkage to BrandPortal Api Server | 브랜드 포탈 연동 수행을 실패했습니다. | |||
77717 | Non Allowed Ip | 접근 허용된 IP가 아닙니다. | |||
77718 | Corp/agency webhook Receive Failure | 기업/대행사 웹훅 수신 오류 | |||
77719 | NonExistingResultMsgRcsMapping | 결과 메시지 RCS 매핑 미존재 오류 | |||
77720 | NonExistingResultMsg | 결과 조회 메시지 미존재 오류 | |||
77721 | ResultMsgRegisterFailuer | 결과 조회 메시지 등록 실패 | |||
77800 | Non CDR Target Message | 과금 생성 대상 메시지가 존재하지 않습니다 | |||
77801 | Invalid Notification Param Error | 알림 요청 Parameter 오류입니다. | |||
77802 | Brand Portal Auth Token Error | 브랜드포탈 인증 토큰 오류가 발생했습니다. | |||
77803 | Brand Portal Host Connection Failure | 브랜드 포탈 Host 연결 실패 오류가 발생했습니다. | |||
77804 | Brand Portal Auth Token Request Failure | 브랜드 포탈 인증 토큰 요청 중 오류가 발생했습니다. | |||
77805 | Brand Portal Auth Token Response Failure | 브랜드 포탈 인증 토큰 응답 수신 중 오류가 발생했습니다. | |||
77806 | Brand Portal Api Request Format Error | 브랜드 포탈 API 연동 요청 포맷 오류가 발생했습니다. | |||
77807 | Brand Portal UnAuthorized Token Error | 브랜드 포탈 API 연동 인증 토큰 오류가 발생했습니다. | |||
77808 | Brand Portal Api Request Error | 브랜드 포탈 API 연동 요청 오류가 발생했습니다. | |||
77809 | Brand Portal Api Response Error | 브랜드 포탈 API 연동 응답 오류가 발생했습니다. | |||
77810 | Brand Portal Api Processing Error | 브랜드 포탈 API 연동 수행 오류가 발생했습니다. | |||
77811 | Brand Portal Api No Data | 브랜드 포탈 API 응답 결과 값이 없습니다. | |||
77812 | Notification Internal Error | Notification 내부 작업 수행 중 오류가 발생하였습니다. | |||
77813 | Failure Notification Hist Insert | Notification Hist 등록 작업 중 오류가 발생하였습니다. | |||
77814 | Invalid Notification Method | 잘못된 Notification Method입니다. | |||
77815 | Invalid Notificiation Type | 잘못된 Notification Type입니다. | |||
71816 | Whloesale Simulater Fail | 홀세일 시뮬레이터 연동 오류 |
주의
CMA에서 에러 발생 시, Error Description은 CMA Hostname+Description 형태로 전송됩니다.