RCS
RCS 메시지 발송 규격입니다.
Last updated
RCS 메시지 발송 규격입니다.
Last updated
RCS 옵션필드를 간편하게 발송 할 수 있는 심플 방식이 있습니다.
RCS 옵션필드를 이통사 규격을 사용할 수 있는 전문가 방식이 있습니다.
미디어메시지 종류에 따라 3가지(standalone, carousel, template)로 전송 요청 할 수 있습니다.
요청할 메시지 종류에 맞는 입력이 필요합니다.
상세 Response 내용은 를 참조해주시기 바랍니다.
요청전문 샘플은 를 참조해주시기 바랍니다.
POST
/v1/send/rcs
Header
Authorization
String
발급받은 schema + “ “ + 발급받은 accessToken
Content-Type
String
application/json
Accept
String
application/json
Body
Object
NO
Object
NO
Object Array
NO
RCS 버튼-이통사 규격 (body 필드 사용 시 사용 가능)
from
String
YES
발신번호 (형식, 01012345678)
to
String
YES
수신번호 (형식, 01012345678)
String
YES
RCS 메시지 formatID
brandKey
String
YES
RCS 브랜드 키
brandId
String
NO
RCS 브랜드 ID
expiryOption
String(1)
NO
전송 time out설정 (Default: 1) (1: 24시간, 2: 40초, 3: 3분 10초, 4: 1시간)
header
String(1)
NO
메시지 상단 ‘광고’ 표출 여부 (Default: 0)
(0:미표출, 1:표출) 1인경우 footer 입력 필요
footer
String(100)
NO
메시지 하단 수신거부 번호
ref
String(200)
NO
Object
NO
실패 시 전송될 Fallback 메시지 정보
Header
Content-Type
String
application/json
Body
code
String(4)
API 호출 결과 코드
result
String
API 호출 결과 설명
msgKey
String
메시지 키
ref
String(200)
참조필드(요청 시 입력한 데이터)
3개 필드 중 1개 필수(standalone, carousel, template)입니다.
standalone
Object
carousel
Object Array
template
Object
subTitle
String
서브 소제목
subDesc
String
서브 소본문
subMedia
String
서브 이미지
subMediaUrl
String
서브 이미지 URL
{key}
String/Object
RCS 표준 규격 전송 필드 ex) descrption, media 등
suggestions
Object
RCS 표준 규격 버튼 필드
RCS SMS
SS000000
Standalone
Image: none Title: none Text: 최대 100자 Card: 1장 Button: 1개
RCS LMS
SL000000
Standalone
Image: none Title: 최대 30자 Text: 최대 1,300자 Card: 1장 Button: 3개(최대 17자)Image: Tall(568*528) Title: 최대 30자 Text: 최대 1,300자 Card: 1장 Button: 3개(최대 17자)
RCS MMS
SMwThT00
Standalone Media Top
Image: Tall(568*528) Title: 최대 30자 Text: 최대 1,300자 Card: 1장 Button: 2개(최대 17자)
RCS MMS
SMwThM00
Standalone Media Top
Image: Medium(568*336) Title: 최대 30자 Text: 최대 1,300자 Card: 1장 Button: 2개(최대 17자)
RCS MMS CAROUSEL
CMwMhM0200
Carousel Medium
Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 2장 Button: 카드 별 2개(최대 13자)
RCS MMS CAROUSEL
CMwMhM0300
Carousel Medium
Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 3장 Button: 카드 별 2개(최대 13자)
RCS MMS CAROUSEL
CMwMhM0400
Carousel Medium
Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 4장 Button: 카드 별 2개(최대 13자)
RCS MMS CAROUSEL
CMwMhM0500
Carousel Medium
Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 5장 Button: 카드 별 2개(최대 13자)
RCS MMS CAROUSEL
CMwMhM0600
Carousel Medium
Image: Medium(696*504) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 6장 Button: 카드 별 2개(최대 13자)
RCS MMS CAROUSEL
CMwShS0200
Carousel Small
Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 2장 Button: 카드 별 2개(최대 5자)
RCS MMS CAROUSEL
CMwShS0300
Carousel Small
Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 3장 Button: 카드 별 2개(최대 5자)
RCS MMS CAROUSEL
CMwShS0400
Carousel Small
Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 4장 Button: 카드 별 2개(최대 5자)
RCS MMS CAROUSEL
CMwShS0500
Carousel Small
Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 5장 Button: 카드 별 2개(최대 5자)
RCS MMS CAROUSEL
CMwShS0600
Carousel Small
Image: Small(360*336) 총합 1MB Title: 카드 별 최대 30자 Text: 총합 1,300자 Card: 6장 Button: 카드 별 2개(최대 5자)
RCS MMS 이미지&타이틀 강조형
OMHITV0001
이미지&타이틀 강조형 3:4 Long
Image: 900*1200 Title: 최대 30자 Text: N/A Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: 최대 1개
RCS MMS 이미지&타이틀 강조형
OMHITS0001
이미지&타이틀 강조형 1:1 Square
Image: 900*900 Title: 최대 30자 Text: N/A Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: 최대 1개
RCS MMS 이미지 강조형
OMHIMV0001
이미지 강조형 3:4 Long
Image: 900*1200 Title: 최대 30자 Text: N/A Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: N/A
RCS MMS 이미지 강조형
OMHIMS0001
이미지강조형 1:1 Square
Image: 900*900 Title: 최대 30자 Text: N/A Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: N/A
RCS MMS 썸네일형
OMTBNV0001
썸네일형 세로
Image: 900*560 Title: 최대 30자 Text: 150자 Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: 최대 2개
RCS MMS 썸네일형
OMTBNH0001
썸네일형 가로
Image: 900*560 Title: 최대 30자 Text: 150자 Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: 최대 3개
RCS MMS SNS형
OMSNSS0001
SNS형
Image: 900*900 Title: 최대 30자 Text: 150자 Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: N/A
RCS MMS SNS형
OMSNSH0001
SNS형 중간버튼
Image: 900*900 Title: 최대 30자 Text: 150자 Card: 1장 Button: 카드 별 2개(최대 16자) sub정보: N/A
FREE TEMPLATE (타이틀 자유형/선택형)
발급 된 Template ID
Free
Image: none Title: none Text: 최대 90자 Card: 1장 Button: 1개
DESCRIPTION TEMPLATE (타이틀 자유형/선택형)
발급 된 Template ID
Description
Image: none Title: 최대 8자 Text: 최대 90자 Card: 1장 Button: 2개
CELL TEMPLATE (타이틀 자유형/선택형)
발급 된 Template ID
Cell
Image: none Title: 최대 8자 Text: 최대 90자 Card: 1장 Button: 0~2개
IMAGE TEMPLATE (이미지&타이틀 강조형, 이미지 강조형, 썸네일형, SNS형)
발급 된 Template ID
Image
Image: 900*1200 또는900*900 또는 900*560, 상세Image: 300*300 Title: 최대 30자 Text: 최대 150자 상세Text: 최대 33자 Card: 1장 Button: 2개
9가지 형태의 버튼을 제공하며 각 버튼에 맞는 옵션 값 입력이 필요합니다.
URL 연결
Web page 또는 App으로 이동할 수 있습니다.
지도 보여주기
지정된 좌표로
설정된 지도 App을 실행합니다.
지도 검색
검색어를 통해
조회된 지도 App을 실행합니다.
위치 전송
휴대폰의 현재
위치 정보를 전송합니다.
일정 등록
정해진 일자와
내용으로 일정을 등록합니다.
복사하기
지정된 내용을
클립보드로 복사합니다.
대화방 열기 (문자)
메시지 App을
실행합니다.
대화방 열기 (음성, 영상)
메시지 App을
실행합니다.
전화 연결
특정 전화번호로 전화를 걸 수 있습니다.
type
String(3)
YES
Fallback 종류(SMS, MMS)
text
String(2000)
YES
Fallback 메시지 내용(최대 2,000byte)
title
String(40)
NO
Fallback 메시지 제목(최대 40byte)
fileKey
String Array
NO
Fallback 파일키(최대 3개)
originCID
String(9)
NO
(content/body 중 하나는 필수 입력)
(content/body 중 하나는 필수 입력)
type
String
버튼 종류(URL)
name
String
버튼 명
url
String
웹브라우저로 연결할 URL주소
type
String
버튼 종류(MAP_LOC)
name
String
버튼 명
label
String
지도 App에 표시될 라벨명
latitude
String
위도 값(예)37.4001971
longitude
String
경도 값
(예)127.1071718
fallbackUrl
String
지도 App동작이 안 될 경우 대처할 URL
type
String
버튼 종류(MAP_QRY)
name
String
버튼 명
query
String
지도 App에서 검색할 구문
fallbackUrl
String
지도 App동작이 안 될 경우 대처할 URL
type
String
버튼 종류(MAP_SEND)
name
String
버튼 명
type
String
버튼 종류(CALENDAR)
name
String
버튼 명
startTime
String
시작 일정(yyyy-MM-dd’T’HH:mm:ssXXX)
endTime
String
종료 일정(yyyy-MM-dd’T’HH:mm:ssXXX)
title
String
일정 제목
description
String
일정 내용
type
String
버튼 종류(COPY)
name
String
버튼 명
text
String
클립보드로 복사될 내용
type
String
버튼 종류(COM_T)
name
String
버튼 명
phoneNumber
String
대화방의 수신자 번호
text
String
내용
type
String
버튼 종류(COM_V)
name
String
버튼 명
phoneNumber
String
대화방의 수신자 번호
type
String
버튼 종류(DIAL)
name
String
버튼 명
phoneNumber
String
전화 연결 할 수신자 번호
text
String
RCS 내용
title
String
RCS 제목
media
String
미디어(maapfile://)
mediaUrl
String
클릭 시 랜딩 URL
(값이 '\' 경우 이미지 전체보기)
Object Array
버튼 정보
Object Array
서브 컨텐트 정보
text
String
RCS 내용
title
String
RCS 제목
media
String
미디어(maapfile://)
mediaUrl
String
클릭 시 랜딩 URL
(값이 '\' 경우 이미지 전체보기)
Object Array
버튼 정보
title
String
템플릿 제목
description
String
{key}
String
사전에 등록된 key, value(JSON)
Object Array
서브 컨텐트 정보