# RCS
**공통 포맷(MESSAGEBASE ID)**
> **RCS MMS 슬라이드형(Carousel Medium, Small)은 1,300자까지 발송 가능하나 실제 단말에서 수신 가능한 글자 수가 적어 메시지 내용이 잘려 발송될 수 있습니다.** > > **아래 글자/라인수 정의 확인하시어 발송하시기 바랍니다.** > **RCS MMS 슬라이드형 글자/ 라인수 정의** > > 글자 수 : 1줄 당 정상적으로 표현가능한 글자 수, 한글 **'**가' 기준 측정 > > 라인 수 : 수신 가능한 디스크립션(본문) 줄 수 **LMS (Standalone No Media)** \[글자 수]
\[줄 수(접혀있는 경우)]
**MMS (Standalone Media Top - 세로형)** \[글자 수]
\[줄 수(Media Tall인 경우, 접혀있는 경우)]
\[줄 수(Media Medium인 경우, 접혀있는 경우)]
**MMS (Carousel Medium - 슬라이드)** ![](/files/ubnkcePoFfkZ3svXkw2P) ![](/files/Lw3Uh0mC4aJoNeIqZM8U) **MMS (Carousel Small - 슬라이드형)** ![](/files/T2AIgdoZXN4DrOjZ2qnr) ![](/files/oI6EJoRX7ZX7fPUkjLoM) ### MESSAGE ![](/files/zBYqPWbFUtjqP0vLwqTI) **MESSAGE(신규 MMS 제외)**
**MESSAGE (신규 MMS, 이미지 템플릿 발송 규격 – 이미지 & 타이틀 강조형 )**
**MESSAGE (신규 MMS, 이미지 템플릿 발송 규격 – 이미지 강조형, SNS형 )**
**MESSAGE (신규 MMS, 이미지 템플릿 발송 규격 – 썸네일형 (세로) )**
**MESSAGE (신규 MMS, 이미지 템플릿 발송 규격 - 썸네일형 (가로) )**
**신규 RCS 포맷** ```json5 "body": { "title1": "제목", "description1": "본문 텍스트", "media1": "maapfile://{fileId_1}", "title2": "제목 2번째 카드", "description2": "본문 텍스트", "media2": "maapfile://{fileId_2}", "title3": "제목 3번째 카드", "description3": "본문 텍스트", "media3": "maapfile://{fileId_3}", "media": "maapfile://{fileId_main} > (신규포맷 mms 전용) 상단 main 이미지", "title": "제목 텍스트 > (신규포맷 mms 전용) 상단 main 제목", "description": "본문 텍스트 > (신규포맷 mms 전용) 상단 main 본문", "subMedia1": "maapfile://{fileId_sub1} > (신규포맷 mms 전용) 선택 옵션 서브 이미지 1", "subMediaUrl1": "URL > (신규포맷 mms 전용) 선택 옵션 서브 이미지 1 클릭 시 랜딩 URL", "subTitle1": "제목 텍스트 > (신규포맷 mms 전용) 선택 옵션 소제목 1", "subDesc1": "본문 텍스트 > (신규포맷 mms 전용) 선택 옵션 소본문 1", "subMedia2": "maapfile://{fileId_sub2} > (신규포맷 mms 전용) 선택 옵션 서브 이미지 2", "subMediaUrl2": "URL > (신규포맷 mms 전용) 선택 옵션 서브 이미지 2 클릭 시 랜딩 URL", "subTitle2": "제목 텍스트 > (신규포맷 mms 전용) 선택 옵션 소제목 2", "subDesc2": "본문 텍스트 > (신규포맷 mms 전용) 선택 옵션 소본문 2", "subMedia3": "maapfile://{fileId_sub3} > (신규포맷 mms 전용) 선택 옵션 서브 이미지 3", "subMediaUrl3": "URL > (신규포맷 mms 전용) 선택 옵션 서브 이미지 3 클릭 시 랜딩 URL", "subTitle3": "제목 텍스트 > (신규포맷 mms 전용) 선택 옵션 소제목 3", "subDesc3": "본문 텍스트 > (신규포맷 mms 전용) 선택 옵션 소본문 3" } ``` ### Media 종류 **이미지** 비즈뿌리오 사이트의 \[메시지관리] – \[RCS 관리] – \[RCS 이미지 관리] 메뉴에서 이미지를 등록하여 사용합니다. 이미지는 등록일로부터 365일간 발송 가능합니다. (이후 자동 삭제) > **이미지 URL** > > **포맷** > > maapfile://{fileId} > > > > **예시** > > "media" : "maapfile://BR.i6dOpSm8N8.20200302150000.001" **동영상 스트리밍** * 3가지 형태의 YouTube URL 주소 지원 \ (정확한 형식을 준수해야 하며, 일부만 일치하는 경우 실패) * 동영상 썸네일은 등록된 이미지만 사용 가능하며 YouTube URL 뒤에 콤마(,)와 함께 입력\ (콤마(,) 외 공백을 포함하는 경우 실패) * 동영상 발송 시 Footer에 '동영상 재생 시 데이터 요금제가 적용됩니다.' 라는 문구 자동 삽입 > **동영상 스트리밍 URL** > > **포맷** > > fileId\_1} > > fileId\_2} > > fileId\_3} > > > > **예시** > > "media1" : "" ### BUTTON ![](/files/F4uxRC8asGwklxf1jhkd) ### SUGGESTIONS ![](/files/Y9RasGBmPsYjMnrrkisZ) ### ACTION ![](/files/qvbkryQfazdzINh1vQn7) ### RCS Examples RCS : 공통 포맷 SMwThT00 (**MMS Standalone Tall**) 사용 **첨부파일 1개, 버튼 1개** ```json5 { "account": "test", "refkey": "test1234", "type": "rcs", "from": "07000000000", "to": "01000000000", "content": { "rcs": { "messagebaseid": "SMwThT00", "chatbotid": "15880000", "header": "1", "footer": "무료 수신 거부 080-1234-5678", "copyallowed": "Y", "message": { "description": "안녕하세요! MMS-StandaloneTall(SMwThT00)", "media": " maapfile://BR.05NGK0A6dA.20200326140000.001" }, "button": [ { "suggestions": [ { "action": { "urlAction": { "openUrl": { "url": "https://www.google.com" } }, "displayText": "구글로 이동" } } ] } ] } } } ``` RCS : 공통 포맷 : CMwMhM0300 (**MMS Carousel Medium 3장**) 사용 **첨부파일 3개, 버튼 카드 별 2개** ```json5 { "account": "test", "refkey": "test1234", "type": "rcs", "from": "07000000000", "to": "01000000000", "content": { "rcs": { "messagebaseid": "CMwMhM0300", "chatbotid": "15880000", "header": "0", "copyallowed": "Y", "message": { "title1": "첫번째", "description1": "1번", "media1": "maapfile://BR.05NGK0A6dA.20200326140000.001", "title2": "두번째", "description2": "2번", "media2": "maapfile://BR.05NGK0A6dA.20200326140000.002", "title3": "세번째", "description3": "3번", "media3": "maapfile://BR.05NGK0A6dA.20200326140000.003" }, "button": [ { "suggestions": [ { "action": { "urlAction": { "openUrl": { "url": "https://www.google.com" } }, "displayText": "URL 연결하기" } }, { "action": { "dialerAction": { "dialPhoneNumber": { "phoneNumber": "+1650253000" } }, "displayText": "전화 걸기" } } ] }, { "suggestions": [ { "action": { "composeAction": { "composeTextMessage": { "phoneNumber": "+1650253000", "text": "Draft to go into the send message text field." } }, "displayText": "메시지 전송" } }, { "action": { "clipboardAction": { "copyToClipboard": { "text": "COUPONE-1234-1234" } }, "displayText": "복사하기" } } ] }, { "suggestions": [ { "action": { "calendarAction": { "createCalendarEvent": { "startTime": "2017-03-16T17:40:00.214+09:00", "endTime": "2017-03-18T17:40:00.216+09:00", "title": "Meeting", "description": "GSG review meeting" } }, "displayText": "캘린더 등록" } }, { "action": { "mapAction": { "showLocation": { "location": { "latitude": 37.4220041, "longitude": -122.0862515, "label": "Googleplex" }, "fallbackUrl": "https://www.google.com/maps/@37.4219162,-22.078063,15z" } }, "displayText": "지도 보여주기" } } ] } ] } } } ``` **New RCS examples** Highlighted image n title (이미지 & 타이틀 강조형) ```json5 { "body": { "media": "maapfile://fileId123", (필수) "title": "제목", "subTitle1": "소제목1",(필수) "subDesc1": "소본문1",(필수) "subTitle2": "소제목2", "subDesc2": "소본문2" }, "buttons": [ { "suggestions": [ { "action": { "urlAction": { "openUrl": { "url": "https://www.google.com" } }, "displayText": "구글" } }, { "action": { "urlAction": { "openUrl": { "url": "https://www.naver.com" } }, "displayText": "네이버" } } ] } ] } ``` 이미지 강조형, SNS형 ```json5 { "body": { "media": "maapfile://fileId123",(필수) "title": "제목", "description": "본문"(필수) }, "buttons": [ { "suggestions": [ { "action": { "urlAction": { "openUrl": { "url": "https://www.google.com" } }, "displayText": "구글" } }, { "action": { "urlAction": { "openUrl": { "url": "https://www.naver.com" } }, "displayText": "네이버" } } ] } ] } ``` 썸네일형 (세로) ```json5 { "body": { "media": "maapfile://fileId123",(필수) "title": "제목", "description": "본문", "subMedia1": "maapfile://fileid456",(필수) "subMediaUrl1": "http://www.naver.com", "subDesc1": "소본문1 이미지클릭가능",(필수) "subMedia2": "maapfile://fileid789",(필수) "subDesc2": "소본문2 이미지클릭불가"(필수) }, "buttons": [ { "suggestions": [ { "action": { "urlAction": { "openUrl": { "url": "https://www.google.com" } }, "displayText": "구글" } }, { "action": { "urlAction": { "openUrl": { "url": "https://www.naver.com" } }, "displayText": "네이버" } } ] } ] } ``` 썸네일형 (가로) ```json5 { "body": { "media": "maapfile://fileId123",(필수) "title": "제목", "description": "본문",(필수) "subMedia1": "maapfile://fileid456",(필수) "subMediaUrl1": "http://www.naver.com", "subMedia2": "maapfile://fileid789",(필수) "subMedia3": "maapfile://fileid000"(필수) }, "buttons": [ { "suggestions": [ { "action": { "urlAction": { "openUrl": { "url": "https://www.google.com" } }, "displayText": "구글" } }, { "action": { "urlAction": { "openUrl": { "url": "https://www.naver.com" } }, "displayText": "네이버" } } ] } ] } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://biztech.gitbook.io/webapi/api/dispatch/rcs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.