RCS 문자 발송

API 목록

No
Method
API
Description

1

POST

/v1/openapi/rcs/send

RCS 문자 발송 API

1. 문자 발송

POST https://api.megabird.co.kr/v1/openapi/rcs/send

지원 RCS 메시지 타입 및 Message Base ID

  • RCS Message Type
    Message Base ID
    Description

    RCS

    SS000000

    RCS SMS

    RCL

    SL000000

    RCS LMS

    RCM

    SMwThT00

    RCS MMS 세로형 (Tall)

    RCM

    SMwThM00

    RCS MMS 세로형 (Medium)

    RCC

    CMwMhM0300

    RCS MMS Carousel Medium 3장

    RCC

    CMwMhM0400

    RCS MMS Carousel Medium 4장

    RCC

    CMwMhM0500

    RCS MMS Carousel Medium 5장

    RCC

    CMwMhM0600

    RCS MMS Carousel Medium 6장

    RCC

    CMwShS0300

    RCS MMS Carousel Small 3장

    RCC

    CMwShS0400

    RCS MMS Carousel Small 4장

    RCC

    CMwShS0500

    RCS MMS Carousel Small 5장

    RCC

    CMwShS0600

    RCS MMS Carousel Small 6장

1.1 Headers

Name
Type
Description

Authorization*

String

발급받은 API Key

Content-Type*

String

application/json

1.2 Request Body Parameters

Name
Type
Required
Description
Example

messageBaseId*

String

필수

[RCS Message Base ID]

SMwThT00

brandId*

String

필수

[RCS 브랜드 ID] RCS 비즈센터에서 발급된 브랜드 ID

BR.rlbLu12345

rcsMsgType*

String

필수

[RCS Message Type]

"RCS", "RCL", "RCM", "RCC"

RCM

msgData*

List<Object>

필수

[RCS Message 데이터] 1개 이상 필수 1.2.2 Schema 참고

snPhnum*

String

필수

[발신전화번호]

01012345678

addrNmList

String

[수신 주소록 그룹명] 메가버드 웹사이트 에서 등록가능

메가버드 그룹1

messageReceiverList

List<Object>

[수신전화번호 리스트]

최대 500개 1.2.1 Schema 참고

messageReceiverList 상세 JSON

fileId

String

[수신자 목록 업로드한 파일 ID]

수신자 엑셀 업로드 API

rsvDtt

String

[예약일시]

2025-08-26 17:45

adIncluYn*

String

필수

[광고문자 여부]

"Y"

copyYn

String

[복사가능 여부] default 값 : "N" "Y" or "N"

"Y"

expiryOpt*

String

필수

[메시지 Timeout option]

"1": 24h, "2": 40sec, "3": 3min, "4": 1h

"1"

useDefault080

Boolean

자체 080 수신거부 번호 사용시 'false' 필수

[메가버드 제공 080 수신거부 번호 사용 여부] Default 값 : true

true/false

blockedPhnum

String

useDefault080의 값이 'false' 일 경우 필수

[자체 080수신거부 번호]

08012341234

blockedDstKey

String

자체 080 수신거부 번호에 인증코드가 필요한 경우 필수

[080 수신거부 인증코드]

1234567

1.2.1 messageReceiverList

Name
Type
Required
Description
Example

mbnum*

String

필수

[수신전화번호]

01056785678

1.2.2 msgData

Name
Type
Required
Description
Example

title

String

메시지 제목

제목입니다

description

String

메시지 내용

내용입니다

fileKey

String

첨부할 이미지의 파일 키

83e41bb420ce4a66b713d5c98286e181

buttons

List<Object>

메시지 내 버튼 1.2.3 Schema 참고

1.2.3 button

Name
Type
Required
Description
Example

type*

String

필수

버튼 타입 URL, DIAL, MAP_LOC, MAP_QRY, CALENDAR, COPY, COM_T, COM_V

URL

buttonName*

String

필수

버튼 명

버튼

url

String

URL 타입인 경우 입력 버튼 클릭 시 이동할 URL

https://megabird.com/

phoneNumber

String

DIAL, COM_T, COM_V 타입인 경우 입력 해당 버튼 클릭 시 전화(문자)할 번호

01023451234

locationLabel

String

MAP_LOC 타입인 경우 입력 지도 데이터의 Label 명

Googleplex

latitude

String

MAP_LOC 타입인 경우 입력 지도 데이터의 Latitude

37.4220041

longitude

String

MAP_LOC 타입인 경우 입력 지도 데이터의 Longitude

-122.0862515

fallbackUrl

String

MAP_LOC, MAP_QRY 타입인 경우 입력 지도 조회 실패할 경우 URL

https://www.google.com/maps/@37.4219162,-122.078063,15z

query

String

MAP_QRY 타입인 경우 입력 지도 조회할 스트링

restaurants

startTime

ZonedDateTime

CALENDAR 타입인 경우 입력 일정 시작 시간

2017-03-14T00:00:00Z

endTime

ZonedDateTime

CALENDAR 타입인 경우 입력 일정 종료 시간

2017-03-14T23:59:59Z

calendarTitle

String

CALENDAR 타입인 경우 입력 일정 제목

Meeting

calendarDescription

String

CALENDAR 타입인 경우 입력 일정 내용

GSG review meeting

copyText

String

COPY 타입인 경우 입력 버튼 클릭 시 복사할 Text

복사

chatText

String

COM_T 타입인 경우 입력 대화방 입장 시 입력될 Text

안녕하세요

1.3 Message Spec

Message Base ID: SS000000

Field
Spec

Image

-

Title

-

Text*

최대 100자

Card size (msgData size)

1

Button size

1

Button name

최대 17자

1.4 Request Example

{
    "rcsMsgType": "RCS",
    "messageBaseId": "SS000000",
    "msgData": [
        {
            "description": "Hello, This is a test message.",
            "buttons": [
                {
                    "type": "CALENDAR",
                    "buttonName": "CALENDAR",
                    "startTime": "2025-06-28T00:00:00Z",
                    "endTime": "2025-06-28T00:00:00Z",
                    "calendarTitle": "토요일",
                    "calendarDescription": "토요일이다"
                }
            ]
        }
    ],
    "brandId": "BR.rlbLu12345",
    "adIncluYn": "N",
    "snPhnum": "1234-1234",
    "messageReceiverList": [
        {
            "mbnum": "010-1234-3456"
        }
    ],
    "expiryOpt": "1",
    "copyYn": "N"
}

1.4.1 Button Example

{
  "type": "URL",
  "buttonName": "URL",
  "url": "www.megabird.com"
}

1.5 Response Body

파라미터명
타입
설명

success

boolean

성공여부

code

String

결과 코드

message

String

결과 메시지

data

Json

결과 데이터

msgGrpNo

Long

메시지그룹번호

timestamp

LocalDateTime

현재 시간

1.6 Response Example

{
  "success": true,
  "code": "200",
  "message": "성공",
  "data": {
    "msgGrpNo": 123456
  },
  "timestamp": "2024-01-01T15:12:10.902849"
}

2. Error Code

200 , "성공"
1001, "시스템 에러가 발생하였습니다."
2001, "엑셀파일 확장자는 xls, xlxs만 허용됩니다.."
2002, "업로드 허용사이즈는 최대 100,000건입니다."
2003, "전체 컬럼의 데이터 총 개수가 일치하지 않습니다."
2004, "엑셀 업로드 파일 사이즈는 최대 50Mb입니다."
2100, "회원 아이디는 최대 10글자입니다."
3100, "유효성 검사에 실패하였습니다."
3101, "유효성 검사에 실패하였습니다."
3102, "입력 파라미터 포맷에 오류가 있습니다."
4101, "회원정보가 존재하지 않거나 등록상태가 유효하지 않습니다."
4102, "등록된 발신번호가 존재하지 않습니다."
5001, "그룹을 추가할 수 없습니다. 그룹은 최대 100개까지 등록 가능합니다."
5002, "중복된 그룹명이 존재합니다. 중복된 그룹명은 사용하실 수 없습니다."
5003, "존재하지 않는 그룹번호 입니다."
5004, "한 그룹 내 최대 번호 저장 건수인 10만건을 초과했습니다. 번호를 추가할 수 없습니다."
5005, "주소그룹번호 혹은 주소그룹명은 필수 입력 항목입니다."
5006, "삭제할 수 없는 그룹입니다."
6001, "존재하지 않는 KEY 입니다." 
6002, "정지된 KEY 입니다." 
6003, "허용되지 않은 IP 입니다." 
6004, "등록되지 않은 파일아이디입니다." 
6005, "파일업로드 데이터를 가져오는 중 오류가 발생했습니다." 
6100, "승인되지 않은 템플릿 아이디 입니다." 
6101, "허용되지 않은 채널명 입니다." 
6102, "등록되지 않은 템플릿 아이디 입니다." 
6103, "서비스구분코드는 필수 값입니다." 
6104, "서비스구분코드는 SMS, LMS, MMS만 가능합니다." 
6105, "서비스구분코드는 MMS만 가능합니다." 
6106, "메시지내용은 필수 값입니다." 
6107, "단가 정보를 불러오지 못했습니다." 
6108, "수신전화번호는 최소 1개 이상 필수 값입니다." 
6109, "발신전화번호는 숫자만 가능합니다." 
6110, "SMS는 최대 90Byte까지 입력 가능합니다." 
6111, "메시지내용은 최대 2,000byte까지 입력 가능합니다." 
6112, "1일 최대 발송한도를 초과했습니다." 
6113, "발송시간이 심야 시간(21:00 ~ 익일 08:00)에 해당합니다. 야간 발송제한시간에는 광고문자를 발송할 수 없습니다." 
6114, "광고포함여부는 필수 값입니다." 
6115, "광고성 정보 메시지의 경우 서비스(업체)명은 필수 값입니다." 
6116, "이미지 파일은 500KB 이하의 jpg, jpeg 파일만 가능합니다." 
6117, "이미지 파일은 500KB 이하의 jpg, png 파일만 가능합니다." 
6118, "png 이미지 파일은 대체문자 전송이 불가능합니다." 
6131, "이미지는 파일은 최대 3개까지 가능합니다." 
6140, "이미지 파일은 필수입니다." 
6141, "MMS 이미지 파일은 1500x1440 px 미만이여야 합니다." 
6136, "이미지 파일의 총 크기는 500KB를 초과할 수 없습니다." 
6119, "대체문자의 메시지내용은 필수 값입니다." 
6120, "대체문자의 메시지구분코드는 필수 값입니다." 
6121, "대체문자의 발신전화번호는 필수 값입니다." 
6122, "대체문자의 발신전화번호는 숫자만 가능합니다." 
6123, "알림톡 대체문자의 메시지구분코드는 SMS, LMS만 가능합니다." 
6124, "친구톡(텍스트) 대체문자의 메시지구분코드는 SMS, LMS 가능합니다." 
6125, "친구톡(포토) 대체문자의 메시지구분코드는 MMS 가능합니다." 
6126, "등록된 발신번호가 아닙니다. \n발신번호를 먼저 등록해주시기 바랍니다." 
6127, "해당 발신번호는 스팸차단 되었습니다. \n고객센터로 문의하시기 바랍니다." 
6128, "해당 메시지 내용중에 스팸차단된 문구를 포함하고 있으므로 \n발송하실 수 없습니다." 
6135, "LMS/MMS의 제목은 최대 60Byte까지 입력 가능합니다." 
6150, "SMS의 경우 제목을 입력할 수 없습니다." 
6137, "존재하지 않는 템플릿 아이디 입니다." 
6138, "다른 계정의 템플릿에 접근할 수 없습니다." 
6139, "메시지 메타데이터는 1KB 를 초과할 수 없습니다." 
6151, "각 태그의 길이는 50자를 초과할 수 없습니다." 
6142, "부가정보형 템플릿의 경우 부가정보 내용은 필수입니다." 
6129,"MMS일 경우 이미지 파일이 포함되어야 합니다. 이미지 파일이 없으시면 LMS를 이용하시기 바랍니다." 
6130, "알림톡(포토) 대체문자의 메시지구분코드는 MMS 가능합니다." 
6132, "지원하지않는 해외문자 국가 입니다." 
6133, "지원하지않는 해외문자 단가 입니다." 
6134, "서비스구분코드는 GLOBALSMS만 가능합니다." 
6200, "메시지 제목에 이모지는 사용하실 수 없습니다." 
6201, "메시지 본문에 이모지는 사용하실 수 없습니다." 
6202, "서비스(업체)명에 이모지는 사용하실 수 없습니다." 
6203, "자체 080 수신거부번호를 입력하시기 바랍니다." 
6300, "예약시간을 다시 설정해주세요.\n현재로부터 10분 이후의 시점부터 예약할 수 있습니다." 
6301, "예약시간을 다시 설정해주세요.\n현재로부터 30일 이내의 시점까지 예약할 수 있습니다." 
6302, "예약하신 시간이 심야 시간(21:00 ~ 익일 08:00)에 해당합니다.\n야간 발송제한시간에는 광고문자를 발송할 수 없습니다." 
6303, "발송시간이 심야 시간(21:00 ~ 익일 08:00)에 해당합니다.\n야간 발송제한시간에는 광고문자를 발송할 수 없습니다." 
6304, "예약 발송건이 아닙니다." 
6305, "예약을 취소 및 수정 할 수 없습니다.\n발송 예정 일시 10분 전에는 예약을 취소 및 수정 할 수 없습니다." 
6306, "예약을 취소 및 수정 할 수 없습니다.\n발송 등록 후 5분 이내에는 예약을 취소 및 수정 할 수 없습니다."
PreviousRCS 브랜드 동기화NextRCS 이미지 업로드

Last updated