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 형태로 전송됩니다.