RCS

RCS 메시지 발송 규격입니다.

  • 미디어메시지 종류에 따라 3가지(standalone, carousel, template)로 전송 요청 할 수 있습니다.

  • 요청할 메시지 종류에 맞는 format ID(RCS messagebaseId)입력이 필요합니다.

  • 상세 Response 내용은 코드표를 참조해주시기 바랍니다.

RCS메시지 전송

curl -X POST https://omni.ibapi.kr/v1/send/rcs \
-H "content-type: application/json" \
-H "Accept: application/json" \
-H "Authorization:Bearer 발급받은 토큰" \
-d '{"from": "발신번호", "to": "수신번호", "content": {"standalone": {"text": "메시지 내용"}},"formatId": "RCS 포맷ID", "ref": "참조필드", "brandKey":"RCS브랜드키"}' 

Request

Header

NameTypeDescription

Authorization

String

발급받은 schema + “ “ + 발급받은 accessToken

Content-Type

String

application/json

Accept

String

application/json

Body

NameTypeRequiredDescription

Object

YES

RCS Message Json Object

from

String

YES

발신번호

to

String

YES

수신번호

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 메시지 정보

Response

Header

NameTypeDescription

Content-Type

String

application/json

Body

NameTypeDescription

code

String(4)

API호출 결과 코드

result

String

API호출 결과 설명

msgKey

String

메시지 키

ref

String(200)

참조필드(요청 시 입력한 데이터)

Schema

content

3개 필드 중 1개 필수(standalone, carousel, template)입니다.

NameType

standalone

Object

carousel

Object Array

template

Object

subContent

NameTypeDescription

subTitle

String

서브 소제목

subDesc

String

서브 소본문

subMedia

String

서브 이미지

subMediaUrl

String

서브 이미지 URL

RCS formatId(messagebaseId)

ServiceCodeTypeSpecifications

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개

RCS button

9가지 형태의 버튼을 제공하며 각 버튼에 맞는 옵션 값 입력이 필요합니다.

ButtonTypeDescription

URL 연결

Web page 또는 App으로 이동할 수 있습니다.

지도 보여주기

지정된 좌표로 설정된 지도 App을 실행합니다.

지도 검색

검색어를 통해 조회된 지도 App을 실행합니다.

위치 전송

휴대폰의 현재 위치 정보를 전송합니다.

일정 등록

정해진 일자와 내용으로 일정을 등록합니다.

복사하기

지정된 내용을 클립보드로 복사합니다.

대화방 열기 (문자)

메시지 App을 실행합니다.

대화방 열기 (음성, 영상)

메시지 App을 실행합니다.

전화 연결

특정 전화번호로 전화를 걸 수 있습니다.

fallback

NameTypeRequiredDescription

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

Fallback 최초 발신사업자 식별코드