1 of 3

【 레이아웃 】

이통사에서 사전 정의한 컴포넌트를 기반으로 삼성 채팅+ 전용 Biz RCS 메시지 유형이 추가될 수 있습니다.

기본정보

Name

Value

header *

"0" - 비 광고 "1" - (광고) 표기

footer

"header" : "1" 인 경우 필수, "000-000-000"의 무료수신거부 전화번호 입력

zoomAllowed

"true" - pinch zoom 동작 "false" - pinch zoom 미동작

Body

Name

contentType

note

하위 페이지 참고

Buttons [ ]

각 카드 별 최대 2개의 버튼 사용 가능
버튼명 최대 13 자

Request Body Example

"body": {
        “mTitle” : “메인 타이틀 17자”,
        "mTitleMedia" : "maapfile://",

    },
 "buttons": [
    
  ]

레이아웃 조합 규칙

각 상품별 조합 가능한 최대 컴포넌트 수가 다릅니다.

SMS

LMS

MMS

사용 가능 컴포넌트 수

최대 버튼 수 (2개 세트)

메인타이틀은 최 상단에만 위치할 수 있습니다. 버튼 컴포넌트는 최 상단에 위치할 수 없습니다.

컴포넌트

contentType이 description인 항목의 글자수 합이 상품 글자수 (productCode의 maxDescription) 이하여야 합니다.

bold로 표기한 파라미터에 값이 없으면 같은 색상(컴포넌트)의 파라미터도 실제 수신시 보이지 않습니다.

타이틀

메인 타이틀

- id : CP-MainTitle - type : MainTitleComponent - place : header

· 메시지 최상단에만 위치할 수 있습니다.

· 상품별 지정된 글자수 합산에 포함되지 않습니다.

Request Body Parameters

Name

contentType

note

mTitle

title

최대 17자

mTitleMedia

maapfile

Request Body Example

{
    “body” : {
        “mTitle” : “메인 타이틀 17자”,
        "mTitleMedia" : "maapfile://"
    },
    “buttons” : [
        ]
}

미디어

- id : CP-ImageHorizontal - type : ImageComponent - place : header/body

Request Body Parameters

Name

contentType

note

media *

maapfile

900px * 600px

900px * 900px

900px * 1200px

메시지내 총 미디어 용량 합 1MB 내

mediaUrl

url

이미지 클릭 시, 이동되는 웹 경로

Request Body Example

{
    “body” : {
        “media” : “maapfile://”,
        "mediaUrl" : "http://rcsbizcenter.com"
    },
    “buttons” : [
        ]
}

Case. 위치에 따른 자동 마진 처리

디스크립션

- id : CP-Description - type : DescriptionComponent - place : body

· LMS의 경우, 최대 3개의 디스크립션 컴포넌트를 사용할 수 있습니다.

Request Body Parameters

Name

contentType

note

description

description

title

description

최대 30자

Request Body Example

{
    “body” : {
        "title" : "타이틀 30자",
        "description" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요."
    },
    “buttons” : [
        ]
}

Case - 디스크립션을 3개 사용하는 경우

{
    “body” : {
        "title1" : "타이틀 30자",
        "description1" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요.",
        "title2" : "타이틀 30자",
        "description2" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요.",
        "title3" : "타이틀 30자",
        "description3" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요."
    }
}

Case - 디스크립션을 3개 중 2개만 사용하는 경우

두번째 디스크립션 컴포넌트의 디스크립션을 입력하지 않아 타이틀 값이 있으나 발송된 메시지에서는 표시되지 않는다.

{
    “body” : {
        "title1" : "타이틀 30자",
        "description1" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요.",
        "title2" : "타이틀 30자",
        
        "title3" : "타이틀 30자",
        "description3" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요."
    }
}

서브 이미지 & 서브 디스크립션

- id : CP-ThumbDesc - type : ThumbDescComponent - place : body

Request Body Parameters

Name

contentType

note

subImgTitle

description

최대 30자

subImgMedia1

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

subImgMediaUrl1

url

이미지 클릭 시, 이동되는 웹 경로

subImgDesc1

description

최대 33자

subImgMedia2~5

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

subImgMediaUrl2~5

url

이미지 클릭 시, 이동되는 웹 경로

subImgDesc2~5

description

최대 33자

Request Body Example

{
    “body” : {
        "subImgTitle" : "타이틀 30자",
        "subImgMedia1" : "maapfile://",
        "subImgDesc1" : "서브이미지 디스크립션 33자 입력 가능",
         "subImgMedia2" : "maapfile://",
         "subImgDesc2" : "서브이미지 디스크립션 33자 입력 가능",
    }
}

Case - subImgMedia를 넣지 않는 경우

{
    “body” : {
        "subImgTitle" : "타이틀 30자",
        "subImgDesc1" : "서브이미지 디스크립션 33자 입력 가능",
        "subImgMedia2" : "maapfile://~~",
        "subImgDesc2" : "서브이미지 디스크립션 33자 입력 가능"
    }
}

테이블

- id : CP-Table - type : tableComponent - place : body

· 하나의 메시지에서 테이블과 서브디스크립션을 함께 사용할 수 없습니다.

· LMS의 경우, 최대 2개의 테이블 컴포넌트를 함께 사용할 수 있습니다.

Request Body Parameters

Name

contentType

note

cellTitle

description

최대 30자

cellLeft1

description

cellRight1

description

cellLeft2~10

description

cellRight2~10

description

Request Body Example

{
    “body” : {
        "cellTitle" : "셀 타이틀 30자",
        "cellLeft1" : "글자수",
          "cellRight1" : "상품 글자수에 따라 상이",
        "cellLeft2" : "최대 행",
        "cellRight2" : "5행 / 10행 선택 가능",
        "cellLeft3" : "스타일",
        "cellRight3" : "좌/우 일괄 정렬 및 BOLD 처리"

    }
}

Case - 테이블 컴포넌트를 2개 사용한 메시지

{
    “body” : {
        "title" : "OO 고객님, 안녕하세요.",
        "description" : "이용해주셔서 감사합니다.",
        "cellTitle1" : "이용 내역",
        "cellLeft1" : "이용 기간",
        "cellRight1" : "2023.01.01~01.31",
        "cellLeft2" : "이용 금액",
         "cellRight2" : "1,000,000 원",
        "cellTitle2" : "결제 정보",
        "cellLeft11" : "결제 방식",
         "cellRight11" : "RBC 카드",
        "cellLeft12" : "결제 예정일",
         "cellRight12" : "2023.02.20"
           }
}

서브 디스크립션

- id : CP-TitleDesc - type : tableComponent - place : body

· 하나의 메시지에서 테이블과 서브디스크립션을 함께 사용할 수 없습니다.

Request Body Parameters

Name

contentType

note

subMainTitle

description

최대 30자

subTitle1

description

최대 4자

subDesc1

description

최대 33자

subTitle2~5

description

최대 4자

subDesc2~5

description

최대 33자

Request Body Example

{
    “body” : {
        "subMainTitle" : "서브메인 타이틀 30자",
        "subTitle1" : "서브",
         "subDesc1" : "서브디스크립션1 33자 입력 가능",
        "subTitle2" : "타이틀",
         "subDesc2" : "서브디스크립션2 33자 입력 가능"
    }
}

Case - subTitle을 입력하지 않은 경우

· 디스크립션처럼 서브 디스크립션이 표시됩니다.

{
    “body” : {
        "subMainTitle" : "서브메인 타이틀 30자",
        "subTitle1" : "서브",
        "subDesc1" : "서브디스크립션1 33자 입력 가능",
        "subDesc2" : "서브디스크립션1 33자 입력 가능"
    }
}

썸네일

- id : CP-Thumbnail - type : ThumbnailComponent - place : body

· 썸네일은 3개의 작은 이미지로 구성되며, 3개를 모두 사용해야 발송됩니다.

Request Body Parameters

Name

contentType

note

thumbMedia1 *

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

thumbMediaUrl1

url

이미지 클릭 시, 이동되는 웹 경로

thumbMedia2 *

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

thumbMediaUrl2

url

이미지 클릭 시, 이동되는 웹 경로

thumbMedia3 *

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

thumbMediaUrl3

url

이미지 클릭 시, 이동되는 웹 경로

Request Body Example

{
    “body” : {
         "thumbMedia1" : "maapfile://~",
         "thumbMediaUrl1" : "https://rcsbizcenter.com",
        "thumbMedia2" : "maapfile://~",
        "thumbMediaUrl2" : "https://rcsbizcenter.com",
        "thumbMedia3" : "maapfile://~",
         "thumbMediaUrl3" : "https://rcsbizcenter.com"
    }
}

아이템

- id : CP-ItemB / ItemA - type : ItemComponent - place : body

Request Body Parameters

Name

contentType

note

itemMedia

maapfile

900px * 600px

900px * 900px

900px * 1200px

메시지내 총 미디어 용량 합 1MB 내

itemMediaUrl

url

이미지 클릭 시, 이동되는 웹 경로

itemTitle

desctipion

최대 20자

itemDesc

desctipion

최대 18자

Request Body Example

{
    “body” : {
        "itemTitle" : "아이템 타이틀",
        "itemDesc" : "아이템 디스크립션",
        "itemMedia" : "maapfile://",
        "itemMediaUrl" : "https://rcsbizcenter.com"
        }
}

노티스

- id : CP-notice - type : NoticeComponent - place : body

Request Body Parameters

Name

contentType

note

notice

description

Request Body Example

{
    “body” : {
        "notice" : "노티스입니다. 부연설명을 입력할 수 있는 컴포넌트입니다."
    }
}

배너

- id : CP-banner - type : BannerComponent - place : body

Request Body Parameters

Name

contentType

note

bannerMedia

maapfile

900px * 225px, 메시지내 총 미디어 용량 합 1MB 내

bannerMediaUrl

url

이미지 클릭 시, 이동되는 웹 경로

Request Body Example

{
    “body” : {
        "bannerMedia" : "maapfile://~",
        "bannerMediaUrl" : "https://rcsbizcenter.com"
        }
}

컴포넌트

contentType이 description인 항목의 글자수 합이 상품 글자수 (productCode의 maxDescription) 이하여야 합니다.

bold로 표기한 파라미터에 값이 없으면 같은 색상(컴포넌트)의 파라미터도 실제 수신시 보이지 않습니다.

타이틀

메인 타이틀

- id : CP-MainTitle - type : MainTitleComponent - place : header

· 메시지 최상단에만 위치할 수 있습니다.

· 상품별 지정된 글자수 합산에 포함되지 않습니다.

Request Body Parameters

Name

contentType

note

mTitle

title

최대 17자

mTitleMedia

maapfile

Request Body Example

{
    “body” : {
        “mTitle” : “메인 타이틀 17자”,
        "mTitleMedia" : "maapfile://"
    },
    “buttons” : [
        ]
}

미디어

- id : CP-ImageHorizontal - type : ImageComponent - place : header/body

Request Body Parameters

Name

contentType

note

media *

maapfile

900px * 600px

900px * 900px

900px * 1200px

메시지내 총 미디어 용량 합 1MB 내

mediaUrl

url

이미지 클릭 시, 이동되는 웹 경로

Request Body Example

{
    “body” : {
        “media” : “maapfile://”,
        "mediaUrl" : "http://rcsbizcenter.com"
    },
    “buttons” : [
        ]
}

Case. 위치에 따른 자동 마진 처리

디스크립션

- id : CP-Description - type : DescriptionComponent - place : body

· LMS의 경우, 최대 3개의 디스크립션 컴포넌트를 사용할 수 있습니다.

Request Body Parameters

Name

contentType

note

description

description

title

description

최대 30자

Request Body Example

{
    “body” : {
        "title" : "타이틀 30자",
        "description" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요."
    },
    “buttons” : [
        ]
}

Case - 디스크립션을 3개 사용하는 경우

{
    “body” : {
        "title1" : "타이틀 30자",
        "description1" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요.",
        "title2" : "타이틀 30자",
        "description2" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요.",
        "title3" : "타이틀 30자",
        "description3" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요."
    }
}

Case - 디스크립션을 3개 중 2개만 사용하는 경우

두번째 디스크립션 컴포넌트의 디스크립션을 입력하지 않아 타이틀 값이 있으나 발송된 메시지에서는 표시되지 않는다.

{
    “body” : {
        "title1" : "타이틀 30자",
        "description1" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요.",
        "title2" : "타이틀 30자",
        
        "title3" : "타이틀 30자",
        "description3" : "디스크립션 RCS Biz Center에서 다양한 메시지를 만들어보세요."
    }
}

서브 이미지 & 서브 디스크립션

- id : CP-ThumbDesc - type : ThumbDescComponent - place : body

Request Body Parameters

Name

contentType

note

subImgTitle

description

최대 30자

subImgMedia1

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

subImgMediaUrl1

url

이미지 클릭 시, 이동되는 웹 경로

subImgDesc1

description

최대 33자

subImgMedia2~5

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

subImgMediaUrl2~5

url

이미지 클릭 시, 이동되는 웹 경로

subImgDesc2~5

description

최대 33자

Request Body Example

{
    “body” : {
        "subImgTitle" : "타이틀 30자",
        "subImgMedia1" : "maapfile://",
        "subImgDesc1" : "서브이미지 디스크립션 33자 입력 가능",
         "subImgMedia2" : "maapfile://",
         "subImgDesc2" : "서브이미지 디스크립션 33자 입력 가능",
    }
}

Case - subImgMedia를 넣지 않는 경우

{
    “body” : {
        "subImgTitle" : "타이틀 30자",
        "subImgDesc1" : "서브이미지 디스크립션 33자 입력 가능",
        "subImgMedia2" : "maapfile://~~",
        "subImgDesc2" : "서브이미지 디스크립션 33자 입력 가능"
    }
}

테이블

- id : CP-Table - type : tableComponent - place : body

· 하나의 메시지에서 테이블과 서브디스크립션을 함께 사용할 수 없습니다.

· LMS의 경우, 최대 2개의 테이블 컴포넌트를 함께 사용할 수 있습니다.

Request Body Parameters

Name

contentType

note

cellTitle

description

최대 30자

cellLeft1

description

cellRight1

description

cellLeft2~10

description

cellRight2~10

description

Request Body Example

{
    “body” : {
        "cellTitle" : "셀 타이틀 30자",
        "cellLeft1" : "글자수",
          "cellRight1" : "상품 글자수에 따라 상이",
        "cellLeft2" : "최대 행",
        "cellRight2" : "5행 / 10행 선택 가능",
        "cellLeft3" : "스타일",
        "cellRight3" : "좌/우 일괄 정렬 및 BOLD 처리"

    }
}

Case - 테이블 컴포넌트를 2개 사용한 메시지

{
    “body” : {
        "title" : "OO 고객님, 안녕하세요.",
        "description" : "이용해주셔서 감사합니다.",
        "cellTitle1" : "이용 내역",
        "cellLeft1" : "이용 기간",
        "cellRight1" : "2023.01.01~01.31",
        "cellLeft2" : "이용 금액",
         "cellRight2" : "1,000,000 원",
        "cellTitle2" : "결제 정보",
        "cellLeft11" : "결제 방식",
         "cellRight11" : "RBC 카드",
        "cellLeft12" : "결제 예정일",
         "cellRight12" : "2023.02.20"
           }
}

서브 디스크립션

- id : CP-TitleDesc - type : tableComponent - place : body

· 하나의 메시지에서 테이블과 서브디스크립션을 함께 사용할 수 없습니다.

Request Body Parameters

Name

contentType

note

subMainTitle

description

최대 30자

subTitle1

description

최대 4자

subDesc1

description

최대 33자

subTitle2~5

description

최대 4자

subDesc2~5

description

최대 33자

Request Body Example

{
    “body” : {
        "subMainTitle" : "서브메인 타이틀 30자",
        "subTitle1" : "서브",
         "subDesc1" : "서브디스크립션1 33자 입력 가능",
        "subTitle2" : "타이틀",
         "subDesc2" : "서브디스크립션2 33자 입력 가능"
    }
}

Case - subTitle을 입력하지 않은 경우

· 디스크립션처럼 서브 디스크립션이 표시됩니다.

{
    “body” : {
        "subMainTitle" : "서브메인 타이틀 30자",
        "subTitle1" : "서브",
        "subDesc1" : "서브디스크립션1 33자 입력 가능",
        "subDesc2" : "서브디스크립션1 33자 입력 가능"
    }
}

썸네일

- id : CP-Thumbnail - type : ThumbnailComponent - place : body

· 썸네일은 3개의 작은 이미지로 구성되며, 3개를 모두 사용해야 발송됩니다.

Request Body Parameters

Name

contentType

note

thumbMedia1 *

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

thumbMediaUrl1

url

이미지 클릭 시, 이동되는 웹 경로

thumbMedia2 *

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

thumbMediaUrl2

url

이미지 클릭 시, 이동되는 웹 경로

thumbMedia3 *

maapfile

300px * 300px, 메시지내 총 미디어 용량 합 1MB 내

thumbMediaUrl3

url

이미지 클릭 시, 이동되는 웹 경로

Request Body Example

{
    “body” : {
         "thumbMedia1" : "maapfile://~",
         "thumbMediaUrl1" : "https://rcsbizcenter.com",
        "thumbMedia2" : "maapfile://~",
        "thumbMediaUrl2" : "https://rcsbizcenter.com",
        "thumbMedia3" : "maapfile://~",
         "thumbMediaUrl3" : "https://rcsbizcenter.com"
    }
}

아이템

- id : CP-ItemB / ItemA - type : ItemComponent - place : body

Request Body Parameters

Name

contentType

note

itemMedia

maapfile

900px * 600px

900px * 900px

900px * 1200px

메시지내 총 미디어 용량 합 1MB 내

itemMediaUrl

url

이미지 클릭 시, 이동되는 웹 경로

itemTitle

desctipion

최대 20자

itemDesc

desctipion

최대 18자

Request Body Example

{
    “body” : {
        "itemTitle" : "아이템 타이틀",
        "itemDesc" : "아이템 디스크립션",
        "itemMedia" : "maapfile://",
        "itemMediaUrl" : "https://rcsbizcenter.com"
        }
}

노티스

- id : CP-notice - type : NoticeComponent - place : body

Request Body Parameters

Name

contentType

note

notice

description

Request Body Example

{
    “body” : {
        "notice" : "노티스입니다. 부연설명을 입력할 수 있는 컴포넌트입니다."
    }
}

배너

- id : CP-banner - type : BannerComponent - place : body

Request Body Parameters

Name

contentType

note

bannerMedia

maapfile

900px * 225px, 메시지내 총 미디어 용량 합 1MB 내

bannerMediaUrl

url

이미지 클릭 시, 이동되는 웹 경로

Request Body Example

{
    “body” : {
        "bannerMedia" : "maapfile://~",
        "bannerMediaUrl" : "https://rcsbizcenter.com"
        }
}