MMS

한글기준 650자(1300byte) 내외, 미디어 파일 1MB 이내의 장문 메시지를 AOS 기기로 다양한 템플릿으로 전송하는 메세징 API

서비스를 이용하시려면 API PLEX 에서 [서비스 콘솔 / 발신번호]에서 발신번호 등록을 수행해야 합니다.

RCS biz center 에서 브랜드를 등록한 후, [대화방] > [대화방 등록] 메뉴를 통하여 사용할 발신번호와 브랜드를 연동 해야 합니다.

RCS biz center 에서 [내 브랜드 관리] > [브랜드 운영 관리] > [대행사 운영권한 부여] 버튼을 통하여 'CJ올리브네트웍스'에 대행사 운영권한을 부여 해 주셔야 합니다.

해당 API는 메세지 발송 결과(WebHook)으로 결과를 전달할 수 있습니다.

MMS API

사용 전 체크 사항

캐릭터 인코딩은 UTF-8 을 기본으로 합니다.

Path variable

Path variable(각 URI 내 중괄호({}) 로 묶인 경로 변수)는 아래 내용을 참고하여 호출 시 누락되지 않도록 해주세요.

code

설명

service_id

서비스 유형 id

rcs-mms-standard : 스탠다드 RCS MMS
rcs-mms-bulk : 대량 RCS MMS
rcs-mms-finance : 금융 RCS MMS

RCS MMS API

POST https://cium0wvo4a.apigw.ntruss.com/rcs/v2/submit/{service_id}

RCS MMS 발송용 API

Headers

Name

Value

Content-Type

application/json; charset=utf8

Authorization

사용자ID;secret_key

Body

Response

{
    "results": [
        {
            "code": "C100",
            "msg_key": "user_key_1",
            "desc": "success"
        },
        {
            "code": "C341",
            "msg_key": "4b68ca16-7aa8-4a17-b74c-2b8e4adb13f8",
            "desc": "success"
        }
    ]
}

{
  "code": "G120",
  "desc": "유효한 사용자가 존재하지 않습니다."
}

메세지 타입별 Msg Body

템플릿 타입

키

타입

필수

설명

MMS_Standalone

title

string

카드 제목 (최대 30자) * 카드 최대 1 개 가능

* title, description, media 중에 한 개 항목 필수 입력

* 값이 없는 key 값은 전송하지 않음 (null 허용하지 않음)

description

string

카드 본문 (최대 1300자)

media

string

카드 이미지 MaaP URL

ex) “media" : "maapfile://sample_1.jpg"

버튼 설정 방법

Key 1 : suggestions

첨부된 메시지의 개수만큼 반복한다 . 만약 버튼이 없는 메시지가 포함되어 있다면 ‘{}’ 의 형태로 기입한다.

예를들어 3개의 캐로셀 중 첫번째, 세번째 메시지만 버튼이 있는 경우

"buttons": [
    {
        "suggestions": {……..
        }
    },
    {},
    {
        "suggestions": {……..
        }
    }
]

Key 2 : action

버튼 클릭 시 수행할 액션. 버튼의 개수만큼 해당 오브젝트를 작성 한다.

"buttons": [
    {
        "actions":{
            "urlAction":{ //URL 연결
                "openUrl":{ //버튼 클릭 시 연결할 URL
                    "url": "string" //상세 URL
                }        
            },
            "dialerAction":{ //전화 걸기
                "dialPhoneNumber":{ //버튼 클릭 시 연결할 전화번호
                    "phoneNumber": "string" //상세 전화번호
                }
            },
            "composeAction":{ //메시지 전송
                "composeTextMessage":{  //버튼 클릭 시 메시지 전송
                    "phoneNumber": "string", //수신자 전화번호
                    "text": "string" //메시지 본문내용
                }
            },
            "mapAction":{ //지도 보여주기, 현재 위치 공유
                "showLocation":{ //버튼 클릭 시 지도 표기 할 지역
                    "location":{ //버튼 클릭 시 지도 표기 할 지역
                        "query": "string", //맵 검색 키워드 (쿼리 방식 시)
                        "latitude": "double", //위도 (좌표 방식 시)
                        "longitude": "double", //경도 (좌표 방식 시)
                        "label": "string" //표기 라벨 (좌표 방식 시)
                    }
                }
            },
            "calendarAction":{ //캘린더 등록
                "createCalendarEvent":{ //버튼 클릭 시 캘린더에 등록할 내용
                    "startTime": "string", //시작 시간
                    "endTime": "string", //종료 시간
                    "title": "string", //제목
                    "description": "string" //상세 설명
                }
            },
            "clipboardAction":{ //복사하기
                "copyToClipboard":{ //버튼 클릭 시 클립보드에 복사
                    "text": "string" //복사할 내용
                }
            },
            "displayText": "string" //버튼에 표기될 text 
            "postback":{ //현재 미사용
                "data": "" //현재 미사용 빈 문자열로 요청
            }
        }
    }
]

타입별 버튼 구성 예시

MMS_Standalone : 버튼 최대 2개까지 사용가능

"buttons": [
    {
        "suggestions": [
            {
                "action": {
                    "calendarAction": {
                        "createCalendarEvent": {
                            "startTime": "2020-10-22T02:30:00Z",
                            "endTime": "2020-10-22T03:30:00Z",
                            "title": "점심",
                            "description": "빕스"
                        }
                    },
                    "displayText": "캘린더 등록",
                    "postback": {
                        "data": ""
                    }
                }
            },
            {
                "action": {
                    "clipboardAction": {
                        "copyToClipboard": {
                            "text": "[email protected]"
                        }
                    },
                    "displayText": "복사하기",
                    "postback": {
                        "data": ""
                    }
                }
            }
        ]
    }
]

MMS_Standalone Horizontal : 버튼 최대 2개까지 사용가능

Request Body 예시

{
  "msg_type": "RMM",
  "msg_data": [
    {
      "msg_key": "RCS MMS",
      "sender_number": "{{send_no_rcs}}",
      "receiver_number": "{{receive_no}}",
      "msg_base_id": "SMwThT00",
      "header": "1",
      "footer": "{{footer}}",
      "copy_allowed": true,
      "msg": {
        "body": {
          "title": "[title]",
          "description": "mms Standalone Media Top tall",
          "media": "maapfile://{{나머지url}}"
        }
      },
      "buttons": [
        {
          "suggestions": [
            {
              "action": {
                "displayText": "연결 버튼",
                "urlAction": {
                  "openUrl": {
                    "url": "https://apiplex.net"
                  }
                }
              }
            }
          ]
        }
      ],
      "brand_key": "{{brand_key_rcs}}",
      "brand_id": "{{brand_id_rcs}}"
    }
  ]
}

Response Body

키

타입

설명

results

array

메시지 수신 데이터

msg_key

string

메시지고유 키

code

string

접수 결과 코드

desc

string

접수 결과 코드 상세

{
    "results": [
        {
            "code": "string",
            "msg_key": "string",
            "desc": "string"
        }
    ]
}

Last updated 5 months ago

Was this helpful?