Kakao i Connect Message::BizMessage(KOR)::Agent 설치 방식::RCS 발송

페이지 이동경로

RCS 발송

RCS(Rich Communication Suite)는 메시지 내에 버튼 및 여러 장의 메시지 카드(Carousel)를 하나의 메시지로 발송할 수 있는 차세대 서비스입니다. RCS 서비스를 발송하기 위해서는 RCS Biz Center에서 브랜드 개설 및 메시지 템플릿을 사전 등록해야 합니다.

RCS 발송하기

RCS 서비스로 다양한 형태의 메시지 유형에 따라 메시지를 발송할 수 있는 코드 예제를 제공합니다.

안내

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 형태로 전송됩니다.
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 contact.dkt@kakaocorp.com 으로 제보해주세요.