공통 포맷(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 - 슬라이드)
MMS (Carousel Small - 슬라이드형)
MESSAGE
MESSAGE(신규 MMS 제외)
MESSAGE (신규 MMS, 이미지 템플릿 발송 규격 – 이미지 & 타이틀 강조형 )
MESSAGE (신규 MMS, 이미지 템플릿 발송 규격 – 이미지 강조형, SNS형 )
MESSAGE (신규 MMS, 이미지 템플릿 발송 규격 – 썸네일형 (세로) )
MESSAGE (신규 MMS, 이미지 템플릿 발송 규격 - 썸네일형 (가로) )
신규 RCS 포맷
"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
포맷
https://www.youtube.com/watch?v=[videoId],maapfile://{썸네일용 fileId_1}
https://youtu.be/[VideoId],maapfile://{썸네일용 fileId_2}
https://m.youtube.com/watch?v=[videoId],maapfile://{썸네일용 fileId_3}
예시
"media1" : "https://www.youtube.com/watch?v=KCbtF9I0qvI,maapfile://BR.i6dOpSm8N8.20200302150000.001"
BUTTON
SUGGESTIONS
ACTION
RCS Examples
RCS : 공통 포맷 SMwThT00 (MMS Standalone Tall) 사용 첨부파일 1개, 버튼 1개
{
"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개
{
"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 (이미지 & 타이틀 강조형)
{
"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형
{
"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": "네이버"
}
}
]
}
]
}
썸네일형 (세로)
{
"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": "네이버"
}
}
]
}
]
}
썸네일형 (가로)
{
"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": "네이버"
}
}
]
}
]
}
