1 of 72

Biz RCS 메시지 발송 규격

Update note

2024.12.18

params.notice 글자수 변경 (500자 -> 상품 글자수 내 자유 기입 가능)

관련 메시지 : CLL00005 명세서B형, CLL00006 명세서C형

2024.10.21

신규 템플릿 유형 추가 : CLL00005 명세서B형, CLL00006 명세서C형

2024.07.30

params.itemDesc 글자수 변경 (14자 -> 20자)

관련 메시지 : OM00000003 - 아이템 상세형 🅝

2023.12.01

이미지 템플릿 슬라이드형 추가

2023.09.01

신규 메시지 유형 추가 : OL00000001, OL00000002, OL00000003, OM00000001, OM00000002, OM00000003, CLI00001, CLT00001, CLT00002, CLL00001, CLL00002, CLL00003, CLL00004

2022.10.28

- 슬라이드형(carousel medium, small) 2장 상품 추가 ㄴ 포맷ID : CMwMhM0200, CMwShS0200 - 이미지 템플릿 규격 추가 - 타이틀 자유형 규격 추가 - 일부 용어변경 ㄴ (기존) 템플릿 -> (변경) 타이틀 자유형 / 타이틀 선택형

2022.10.26

양방향 정책 현행화

2022.10.13

이미지 템플릿 메인 이미지 클릭 시 랜딩URL파라미터 추가 by 박지범

2022.06.14

이미지 템플릿 신규 ㄴ 포맷ID : OMHITV0001, OMHITS0001, OMHIMV0001, OMHIMS0001, OMTBNV0001, OMTBNH0001, OMSNSS0001, OMSNSH0001

2021.09.08

- carousel 제외한 전상품 zoomAllowed 허용 정책에 따른 일부 조정 - 메시지포맷별 zoomAllowed 설정값 추가 - 스타일(cell) 템플릿 글자수 valid 조정 (고정부 + 변수부 총 90자)

2021.03.10

- 가로형(horizontal) 상품 잠정 폐쇄

2020년

Biz RCS 상용화 맞춰 내용 현행화

삼성 Biz RCS

【 공통 포맷 】

모든 브랜드가 함께 사용 가능한 범용적인 메시지 유형으로 RCS SMS, LMS, MMS 상품으로 구성되어 있습니다.

SMS

productCode : "sms"인 메시지 유형입니다.

SS000000

productCode : "sms"인 메시지 유형입니다.

기본정보

Name

Value

groupId

RBC 메시지 발송 통계용. 동일 messagebase ID/동일 group ID/동일 날짜 기준으로 집계

header *

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

footer

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

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

description *

description

최대 100자

Buttons [ ]

최대 1개의 버튼 사용 가능
버튼명 최대 17 자

Request Sample Code

"clientMsgId": "client_id_1",
"chatbotId": "15440000",
"messagebaseId": "SS000000",
"productCode": "sms",
"userContact": "01000000000",
"agencyId": "agency01",
"agencyKey": "AK.Ti53fRiKmBV9OPu",
"brandKey": "BK.Ti53fRiKmBV9OPu",
"expiryOption": 1,
"groupId": "groupdId_0001",
"header": "0",
"footer": "080-0000-0000",
"copyAllowed": false,
"body": {
    "description": "description"
    },
 "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]

LMS

productCode : "lms"인 메시지 유형입니다.

OL00000001 - 기본형 🅝

productCode : "lms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

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

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 17 자

Request Sample Code

OL00000002 - 타이틀 강조형 🅝

productCode : "lms"인 메시지 유형입니다.

기본정보

Name

Value

groupId

RBC 메시지 발송 통계용. 동일 messagebase ID/동일 group ID/동일 날짜 기준으로 집계

header *

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

footer

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

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

mTitle

title

최대 17자

mTitleMedia

maapfile

title

description

최대 30자

description

description

최대 1300자

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

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

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 17 자

Request Sample Code

"body": {
    "mTitle":"mTitle",
    "mTitleMedia":"maapfile://123456",
    "title":"title",
    "description": "description"
    },
 "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName1",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        },
       {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName2",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]

OL00000003 - 문단형 🅝

productCode : "lms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

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

Buttons [ ]

최대 2개씩 3세트의 버튼 사용 가능
버튼명 최대 6자
각 디스크립션 하단에 2개씩 위치

Request Sample Code

SL000000

productCode : "lms"인 메시지 유형입니다.

기본정보

Name

Value

groupId

RBC 메시지 발송 통계용. 동일 messagebase ID/동일 group ID/동일 날짜 기준으로 집계

header *

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

footer

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

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

title

title

최대 30자

description *

description

최대 1300자

Buttons [ ]

최대 3개의 버튼 사용 가능
버튼명 최대 17 자

Request Sample Code

"body": {
    "title":"title",
    "description": "description"
    },
 "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName1",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        },
       {},
       {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName3",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]

MMS

productCode : "mms"인 메시지 유형입니다.

OM00000001 - 기본형 🅝

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

groupId

RBC 메시지 발송 통계용. 동일 messagebase ID/동일 group ID/동일 날짜 기준으로 집계

header *

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

footer

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

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

mTitle

title

최대 17자

mTitleMedia

maapfile

media *

maapfile

900 x 900 px의 jpg, png, gif (1MB 이하)

mediaUrl

url

media 클릭 시, 이동되는 웹 경로

title

description

최대 30자

description

description

최대 1300자

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

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

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 17 자

OM00000003 - 아이템 상세형 🅝

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

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

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 7자

슬라이드형 (medium)

productCode : "mms"인 메시지 유형입니다. Carousel 타입의 메시지입니다.

대상유형

CMwMhM0200, CMwMhM0300, CMwMhM0400, CMwMhM0500, CMwMhM0600

기본정보

Name

Value

groupId

RBC 메시지 발송 통계용. 동일 messagebase ID/동일 group ID/동일 날짜 기준으로 집계

header *

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

footer

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

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

media1

maapfile

696 x 504 px 권장

jpg, png, gif (1MB 이하)

title1

title

최대 30자

description1

description

media2

maapfile

696 x 504 px 권장

jpg, png, gif (1MB 이하)

title2

title

최대 30자

description2

description

media3~6

maapfile

696 x 504 px 권장

jpg, png, gif (1MB 이하)

title3~6

title

최대 30자

description3~6

description

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

카드 2장~6장에 따라 messagebaseId가 달라지며, 그 수만큼 변수, 버튼 묶음도 바뀝니다.

Buttons [ ]

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

Request Sample Code

"body": {
    "title1":"title",
    "description1": "description",
    "title2":"",
    "description2": "",
    "title3":"title",
    "description3": "description"
    },
 "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName1",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        },
       {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName2",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    },
    {},
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName5",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        },
       {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName6",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]

슬라이드형 (small)

productCode : "mms"인 메시지 유형입니다. Carousel 타입의 메시지입니다.

대상유형

CMwShS0200, CMwShS0300, CMwShS0400, CMwShS0500, CMwShS0600

기본정보

Name

Value

groupId

RBC 메시지 발송 통계용. 동일 messagebase ID/동일 group ID/동일 날짜 기준으로 집계

header *

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

footer

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

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

media1

maapfile

360 x 336 px 권장

jpg, png, gif (1MB 이하)

title1

title

최대 30자

description1

description

media2

maapfile

360 x 336 px 권장

jpg, png, gif (1MB 이하)

title2

title

최대 30자

description2

description

media3~6

maapfile

360 x 336 px 권장

jpg, png, gif (1MB 이하)

title3~6

title

최대 30자

description3~6

description

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

Buttons [ ]

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

Request Sample Code

"body": {
    "title1":"title",
    "description1": "description",
    "title2":"",
    "description2": "",
    "title3":"title",
    "description3": "description"
    },
 "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName1",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        },
       {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName2",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    },
    {},
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName5",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        },
       {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName6",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]

SMwThT00 - 세로형 (tall)

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 17 자

Request Sample Code

SMwThM00 - 세로형 (medium)

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 17 자

Request Body Example

OMTBNV0001 - 썸네일형 (세로)

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

contentType이 maapfile인 항목의 파일 용량 합이 1MB 이하여야 합니다.

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 16 자

Request Body Example

OMTBNH0001 - 썸네일형 (가로)

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

contentType이 maapfile인 항목의 파일 용량 합이 1MB 이하여야 합니다.

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 16 자

Request Body Example

OMHIMV0001 - 이미지 강조형 (3:4)

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 16 자

Request Body Example

OMHIMS0001 - 이미지 강조형 (1:1)

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

Buttons [ ]

최대 2개의 버튼 사용 가능
버튼명 최대 16 자

Request Body Example

Chat

productCode : "chat"인 메시지 유형입니다. 양방향 설정이 된 대화방에서만 이용 가능합니다.

SCS00000 (말풍선)

productCode : "chat"인 메시지 유형입니다.

기본정보

Name

Value

header *

"0" - 비 광고

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

description *

description

최대 1300자

Chip List [ ]

최대 10개의 chip 사용 가능
버튼명 최대 17 자
reply 또는 suggested Action 사용 가능

Request Sample Code

"body": {
    "text": "description"
    },
 
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ],
  "replyId": "string",
  "chipList": [
    {
      "reply": {
        "displayText": "Yes",
        "postback": {
          "data": "returned as postbackData on webhook"
        }
      }
    },
    {
      "action": {
        "urlAction": {
          "openUrl": {
            "url": "https://www.google.com"
          }
        },
        "displayText": "Open website or deep link",
        "postback": {
          "data": "dummy_data"
        }
      }
    }

SCL00000

productCode : "chat"인 메시지 유형입니다.

기본정보

Name

Value

Body

Name

contentType

note

Buttons [ ]

최대 4개의 버튼 사용 가능
버튼명 최대 17 자

Chip List [ ]

최대 10개의 chip 사용 가능
버튼명 최대 17 자
reply 또는 suggested Action 사용 가능

Request Sample Code

SCwThT00

productCode : "mms"인 메시지 유형입니다.

기본정보

Name

Value

header *

"0" - 비 광고

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

media *

maapfile

568 x 528 px의 jpg, png, gif (1MB 이하)

title

title

최대 30자

description

description

최대 1300자

Buttons [ ]

최대 4개의 버튼 사용 가능
버튼명 최대 17 자

Chip List [ ]

최대 10개의 chip 사용 가능
버튼명 최대 17 자
reply 또는 suggested Action 사용 가능

Request Sample Code

"body": {
    "media":"maapfile://123456",
    "title":"title",
    "description": "description"
    },
 "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName1",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        },
       {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName2",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ],
  "replyId": "string",
  "chipList": [
    {
      "reply": {
        "displayText": "Yes",
        "postback": {
          "data": "returned as postbackData on webhook"
        }
      }
    },
    {
      "action": {
        "urlAction": {
          "openUrl": {
            "url": "https://www.google.com"
          }
        },
        "displayText": "Open website or deep link",
        "postback": {
          "data": "dummy_data"
        }
      }
    }

SCwThM00

productCode : "chat"인 메시지 유형입니다.

기본정보

Name

Value

header *

"0" - 비 광고

copyAllowed

"true" - 수신자가 글자 복사 가능하도록 허용 "false" - 수신자가 글자 복사할 수 없음

Body

Name

contentType

note

media *

maapfile

568 x 336 px의 jpg, png, gif (1MB 이하)

title

title

최대 30자

description

description

최대 1300자

Buttons [ ]

최대 4개의 버튼 사용 가능
버튼명 최대 17 자

Chip List [ ]

최대 10개의 chip 사용 가능
버튼명 최대 17 자
reply 또는 suggested Action 사용 가능

Request Sample Code

"body": {
    "media":"maapfile://123456",
    "title":"title",
    "description": "description"
    },
 "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName1",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        },
       {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.google.com"
              }
            },
            "displayText": "buttonName2",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ],
  "replyId": "string",
  "chipList": [
    {
      "reply": {
        "displayText": "Yes",
        "postback": {
          "data": "returned as postbackData on webhook"
        }
      }
    },
    {
      "action": {
        "urlAction": {
          "openUrl": {
            "url": "https://www.google.com"
          }
        },
        "displayText": "Open website or deep link",
        "postback": {
          "data": "dummy_data"
        }
      }
    }

슬라이드형 (medium)

productCode : "chat"인 메시지 유형입니다.

대상유형

CCwMhM0200, CCwMhM0300, CCwMhM0400, CCwMhM0500, CCwMhM0600

기본정보

Name

Value

Body

Name

contentType

note

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

카드 2장~6장에 따라 messagebaseId가 달라지며, 그 수만큼 변수, 버튼 묶음도 바뀝니다.

Buttons [ ]

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

Chip List [ ]

최대 10개의 chip 사용 가능
버튼명 최대 17 자
reply 또는 suggested Action 사용 가능

Request Sample Code

슬라이드형 (small)

productCode : "chat"인 메시지 유형입니다.

대상유형

CCwShS0200, CCwShS0300, CCwShS0400, CCwShS0500, CCwShS0600

기본정보

Name

Value

Body

Name

contentType

note

contentType이 description인 항목의 글자수 합이 1300자 이하여야 합니다.

카드 2장~6장에 따라 messagebaseId가 달라지며, 그 수만큼 변수, 버튼 묶음도 바뀝니다.

Buttons [ ]

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

Chip List [ ]

최대 10개의 chip 사용 가능
버튼명 최대 17 자
reply 또는 suggested Action 사용 가능

Request Sample Code

【 추가정보 】

【 참고 사이트】

컴포넌트

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"
        }
}

Biz RCS 메시지 발송 규격

Update note

2024.12.18

2024.10.21

2024.07.30

2023.12.01

2023.09.01

2022.10.28

2022.10.26

2022.10.13

2022.06.14

2021.09.08

2021.03.10

2020년

삼성 Biz RCS

【 공통 포맷 】

SMS

SS000000

기본정보

Body

Buttons [ ]

Request Sample Code

LMS

OL00000001 - 기본형 🅝

기본정보

Body

Buttons [ ]

Request Sample Code

OL00000002 - 타이틀 강조형 🅝

기본정보

Body

Buttons [ ]

Request Sample Code

OL00000003 - 문단형 🅝

기본정보

Body

Buttons [ ]

Request Sample Code

SL000000

기본정보

Body

Buttons [ ]

Request Sample Code

MMS

OM00000001 - 기본형 🅝

기본정보

Body

Buttons [ ]

OM00000003 - 아이템 상세형 🅝

기본정보

Body

Buttons [ ]

슬라이드형 (medium)

대상유형

기본정보

Body

Buttons [ ]

Request Sample Code

슬라이드형 (small)

대상유형

기본정보

Body

Buttons [ ]

Request Sample Code

SMwThT00 - 세로형 (tall)

기본정보

Body

Buttons [ ]

Request Sample Code

SMwThM00 - 세로형 (medium)

기본정보

Body

Buttons [ ]

Request Body Example

OMTBNV0001 - 썸네일형 (세로)

기본정보

Body

Buttons [ ]

Request Body Example

OMTBNH0001 - 썸네일형 (가로)

Update note

SL000000

SCS00000 (말풍선)

SCS00000 (말풍선)