# 【기술지원】

#### **API 기술지원**

* RCS 서비스를 이용하는 기업과 대행사에게는 RCS 서비스 운영에 필요한 기능을 Open API로 제공하고 있습니다.
* 제공된  Open API를 이용하여 **브랜드** / **발신번호** / **양방향 대화방** / **템플릿** / **자동응답 정보 조회**는 물론 **발신번호**, **템플릿에 대한 승인 요청** 기능 등을 사용자가 원하는 형태로 구현하실 수 있습니다.

## API 목록

### RCS Biz Center Open API

<table data-header-hidden><thead><tr><th width="191"></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>토큰</strong></td><td>Access Token 발급 요청</td><td></td></tr><tr><td><strong>브랜드</strong></td><td>브랜드 정보 관리(조회/등록/수정/삭제)</td><td></td></tr><tr><td><strong>대화방</strong></td><td>브랜드 내 등록된 대화방 정보 관리(조회/등록/수정/삭제)</td><td></td></tr><tr><td><strong>공통포맷</strong></td><td>이통사 제공 공통 메시지 정보 조회</td><td></td></tr><tr><td><strong>템플릿</strong></td><td>템플릿 양식 정보 조회, 브랜드 내 템플릿 정보 관리(조회/등록/수정/삭제)</td><td></td></tr><tr><td><strong>양방향 대화방</strong></td><td>브랜드 내 양방향 대화방, 대화방 메뉴 정보 관리(조회/등록/수정/삭제)</td><td></td></tr><tr><td><strong>자동응답 메시지</strong></td><td>브랜드 내 자동응답 메시지 정보 관리(조회/등록/수정/삭제)</td><td></td></tr><tr><td><strong>고객반응 통계</strong></td><td>RCS 메시지 수신, 대화방 메뉴 고객 반응 통계 정보 조회</td><td></td></tr><tr><td><strong>레이아웃</strong></td><td>메시지 포맷 레이아웃 정보 관리(조회/등록/수정/삭제)</td><td></td></tr><tr><td><strong>로고</strong></td><td>브랜드 로고 정보 관리(조회/등록/수정/삭제)</td><td></td></tr><tr><td><strong>대행사</strong></td><td>대행사 운영 브랜드 정보 관리(등록/수정/삭제) 및 연동 정보 관리</td><td></td></tr><tr><td><strong>양방향 중계사</strong></td><td>양방향 서비스 중계사 전용 연동 정보 관리</td><td></td></tr></tbody></table>

### 브랜드 소식 Open API

<table data-header-hidden><thead><tr><th width="180"></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>브랜드 소식</strong></td><td>브랜드 소식 정보 관리(조회/등록/수정/삭제)</td><td></td></tr><tr><td><strong>브랜드 소식 통계</strong></td><td>브랜드 소식 통계 정보 조회</td><td></td></tr></tbody></table>

{% hint style="info" %}
\- Open API 사용을 위한 API 인증Key는 가입신청 승인 시 발급됩니다. (기업관리자/대행사 계정인 경우)

\- API Key는 [개인정보 관리](https://www.rcsbizcenter.com/utility/my-info)에서 확인 및 재발급 가능합니다. 직접 재발급이 어려운 경우 관리자에게 [문의](https://www.rcsbizcenter.com/OnlineInquire)해주세요.

\- Open API 변경 사항은 [공지사항](https://www.rcsbizcenter.com/notice)에서 확인하실 수 있습니다.
{% endhint %}

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="https://apidocs.rcsbizcenter.com/rbc-api"><mark style="color:blue;"><strong>RCS Biz Center Open API</strong></mark>       </a></td><td><a href="broken://spaces/qC8XwXtgo1Efg3nBnZYo">Broken link</a></td></tr><tr><td><a href="https://apidocs.rcsbizcenter.com/feed-api"><mark style="color:blue;"><strong>RCS Biz Center 브랜드 소식 Open API</strong></mark></a></td><td><a href="https://biz-rcs-1.gitbook.io/open-api">https://biz-rcs-1.gitbook.io/open-api</a></td></tr></tbody></table>


# RBC Open API

## **RCS Biz Center API Version 1.1.17**

본 문서는 기업과 대행사에 제공되는 RCS Biz Center Open API의 규격을 기술합니다.

Open API의 사용을 위해서는 사전에 RCS Biz Center에 기업/대행사 등록이 필요합니다.

추가적인 **보안을 위해 API를 연동하는 Client의 IP 를 RCS Biz Center에 사전 등록**하여야 합니다.\
**RCS Biz Center 홈페이지 "내 계정관리"**&#xC5D0;서 등록하실 수 있습니다.

**Open API를 연동하고자 하는 경우 사전 개발 단계에서는** [**검수(STG)**](https://www-qa.rcsbizcenter.com/) **환경에 별도 가입 및 승인 후 이용할 수 있습니다.**

검수(STG) 환경에서 개발/테스트가 완료된 이후 상용(PRD) 연동하는 것을 권고합니다.

1. 검수(STG) - <https://api-qa.rcsbizcenter.com/api/1.1>
2. 상용(PRD) - <https://api.rcsbizcenter.com/api/1.1>

RCS Biz Center Open API는 이통 3사가 정의한 정책에 의거하여 정보를 제공합니다. \
따라서 일부 정보 제공상의 제약이 있을 수 있습니다.

#### **Open API 문의처 : <tech@rcsbizcenter.com>**


# 토큰

## Request

인증용 토큰 발급/갱신 API 목록입니다. 마스터, 매니저, 대행사의 계정 ID와 API KEY로 인증 발급됩니다. 발급된 token은 모든 API의 header에 삽입되어야 합니다.

## Access 토큰을 발급 요청합니다.<br>

> Access 토큰을 발급 요청합니다.  \
> \
> RCS Biz Center 웹에서 가입 시 등록한 ID(마스터 또는 매니저, 대행사)와 계정 가입 시 자동 생성되는 API\
> Key(RCS Biz Center 내 계정관리에서 확인)를 이용하여 토큰 발급을 요청합니다.  \
> \
> response로 전달되는 expiresIn 시간이 초과하면 토큰을 새로 발급 받아야 합니다.          \
> \
> &#x20; \+ \*\*API 사용 Client의 IP는 RCS Biz Center에서 등록하여야 합니다. Client IP 등록은 내 계정관리에서 ID별 최대 10개까지 등록할 수 있습니다.\*\*          \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}}},"paths":{"/token":{"post":{"summary":"Access 토큰을 발급 요청합니다.\n","description":"Access 토큰을 발급 요청합니다.  \n\nRCS Biz Center 웹에서 가입 시 등록한 ID(마스터 또는 매니저, 대행사)와 계정 가입 시 자동 생성되는 API\nKey(RCS Biz Center 내 계정관리에서 확인)를 이용하여 토큰 발급을 요청합니다.  \n\nresponse로 전달되는 expiresIn 시간이 초과하면 토큰을 새로 발급 받아야 합니다.          \n\n  + **API 사용 Client의 IP는 RCS Biz Center에서 등록하여야 합니다. Client IP 등록은 내 계정관리에서 ID별 최대 10개까지 등록할 수 있습니다.**          \n  + **계정 권한 : 마스터, 매니저, 대행사**\n","requestBody":{"description":"required: true\n","content":{"application/json":{"schema":{"type":"object","properties":{"clientId":{"type":"string","description":"RCS Biz Center에 계정 가입시 등록한 ID 입니다.\n","maxLength":20},"clientSecret":{"type":"string","description":"RCS Biz Center 내 계정관리 > 서비스 정보 : API Key 에서 확인 가능합니다.\n","maxLength":18}},"required":["clientId","clientSecret"]}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="토큰발급요청" %}

```
{
  "clientId": "myMemberId",
  "clientSecret": "SK.atIs4g04r6PJepf"
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="185">필드명</th><th width="154">타입</th><th width="85" align="center">길이</th><th width="113" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><code>accessToken</code></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>엑세스토큰</td></tr><tr><td><code>expiresIn</code></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>유효기간</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "expiresIn": "1717138601944",
    "accessToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWJBZ25jeUlkIjoiIiwiaXNTdWJBZ2VuY3kiOiJuIiwiZXhwaXJlRGF0ZSI6IjIwMjQtMDUtMzEgMTU6NTY6NDEiLCJ1c2VySWQiOiJzd2plb25nMzExNyIsImFsbG93SXAiOiIyMTEuMTY5LjE1My4xNzAiLCJjcmVhdGVEYXRlIjoiMjAyNC0wNS0zMSAxNDo1Njo0MSJ9.TPpsOjjA51Snw5p5r6kabWeYH73Gr2PXFENBIVR6ovI"
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61006",
        "message": "Invalid secret key"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드

이 문서는 브랜드에 대한 API 정보를 안내합니다.


# 브랜드 카테고리 목록 조회

## Request

## 브랜드 등록 시 사용 가능한 카테고리 목록을 조회합니다. <br>

> RCS Biz Center에서 브랜드를 등록할 때 필수 요구되는 카테고리(categoryId, categoryName), 하위\
> 카테고리(subCategoryId, subCategoryName)에 해당하는 카테고리 목록을 조회합니다.  \
> \
> 조회된 카테고리, 하위 카테고리 를 이용하여 브랜드 등록 시 지정합니다.  \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*\
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}}},"paths":{"/corp/brand/categories":{"get":{"summary":"브랜드 등록 시 사용 가능한 카테고리 목록을 조회합니다. \n","description":"RCS Biz Center에서 브랜드를 등록할 때 필수 요구되는 카테고리(categoryId, categoryName), 하위\n카테고리(subCategoryId, subCategoryName)에 해당하는 카테고리 목록을 조회합니다.  \n\n조회된 카테고리, 하위 카테고리 를 이용하여 브랜드 등록 시 지정합니다.  \n  + **계정 권한 : 마스터, 매니저**\n  + **브랜드 권한 : 브랜드 대표운영자**\n","responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## **Response**

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 카테고리 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="227">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>categoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 ID 입니다.</td></tr><tr><td><strong><code>categoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 명 입니다.</td></tr><tr><td><a href="#subcategories-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>subCategories</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>하위 카테고리 목록 입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 - 카테고리 수정 일시 입니다.</td></tr></tbody></table>

### <mark style="color:blue;">subCategories</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="205">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="87">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>subCategoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 ID 입니다.</td></tr><tr><td><strong><code>subCategoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 명 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "updateDate": "2019-11-14T10:28:38.000+09",
            "categoryName": "IT",
            "categoryId": "ITE",
            "subCategories": [
                {
                    "subCategoryId": "ITE001",
                    "subCategoryName": "인터넷/컴퓨터"
                },
                {
                    "subCategoryId": "ITE002",
                    "subCategoryName": "정보통신/SW"
                },
                {
                    "subCategoryId": "ITE003",
                    "subCategoryName": "IT 정보"
                },
                {
                    "subCategoryId": "ITE004",
                    "subCategoryName": "전자/영상/음향"
                },
                {
                    "subCategoryId": "ITE005",
                    "subCategoryName": "IT 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:31.000+09",
            "categoryName": "교육",
            "categoryId": "EDU",
            "subCategories": [
                {
                    "subCategoryId": "EDU001",
                    "subCategoryName": "어린이집/유치원"
                },
                {
                    "subCategoryId": "EDU002",
                    "subCategoryName": "초중고등학교"
                },
                {
                    "subCategoryId": "EDU003",
                    "subCategoryName": "대학교/대학원"
                },
                {
                    "subCategoryId": "EDU004",
                    "subCategoryName": "학원"
                },
                {
                    "subCategoryId": "EDU005",
                    "subCategoryName": "온라인교육"
                },
                {
                    "subCategoryId": "EDU006",
                    "subCategoryName": "교육정보"
                },
                {
                    "subCategoryId": "EDU007",
                    "subCategoryName": "유학/연수"
                },
                {
                    "subCategoryId": "EDU008",
                    "subCategoryName": "시험/자격증"
                },
                {
                    "subCategoryId": "EDU009",
                    "subCategoryName": "교육 시설"
                },
                {
                    "subCategoryId": "EDU010",
                    "subCategoryName": "교육 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:31.000+09",
            "categoryName": "식품",
            "categoryId": "FOD",
            "subCategories": [
                {
                    "subCategoryId": "FOD001",
                    "subCategoryName": "음식점"
                },
                {
                    "subCategoryId": "FOD002",
                    "subCategoryName": "주류/음료"
                },
                {
                    "subCategoryId": "FOD003",
                    "subCategoryName": "농축수산물"
                },
                {
                    "subCategoryId": "FOD004",
                    "subCategoryName": "주점"
                },
                {
                    "subCategoryId": "FOD005",
                    "subCategoryName": "카페"
                },
                {
                    "subCategoryId": "FOD006",
                    "subCategoryName": "떡/제과"
                },
                {
                    "subCategoryId": "FOD007",
                    "subCategoryName": "외식/식음료 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:32.000+09",
            "categoryName": "병원",
            "categoryId": "HOS",
            "subCategories": [
                {
                    "subCategoryId": "HOS001",
                    "subCategoryName": "종합병원"
                },
                {
                    "subCategoryId": "HOS002",
                    "subCategoryName": "성형외과"
                },
                {
                    "subCategoryId": "HOS003",
                    "subCategoryName": "안과"
                },
                {
                    "subCategoryId": "HOS004",
                    "subCategoryName": "피부과"
                },
                {
                    "subCategoryId": "HOS005",
                    "subCategoryName": "치과"
                },
                {
                    "subCategoryId": "HOS006",
                    "subCategoryName": "산부인과"
                },
                {
                    "subCategoryId": "HOS007",
                    "subCategoryName": "한의원"
                },
                {
                    "subCategoryId": "HOS008",
                    "subCategoryName": "보건소"
                },
                {
                    "subCategoryId": "HOS009",
                    "subCategoryName": "내과"
                },
                {
                    "subCategoryId": "HOS010",
                    "subCategoryName": "외과"
                },
                {
                    "subCategoryId": "HOS011",
                    "subCategoryName": "이비인후과"
                },
                {
                    "subCategoryId": "HOS012",
                    "subCategoryName": "정형외과"
                },
                {
                    "subCategoryId": "HOS013",
                    "subCategoryName": "소아청소년과"
                },
                {
                    "subCategoryId": "HOS014",
                    "subCategoryName": "영상의학과 "
                },
                {
                    "subCategoryId": "HOS015",
                    "subCategoryName": "정신건강의학과"
                },
                {
                    "subCategoryId": "HOS016",
                    "subCategoryName": "마취통증의학과"
                },
                {
                    "subCategoryId": "HOS017",
                    "subCategoryName": "재활의학과"
                },
                {
                    "subCategoryId": "HOS018",
                    "subCategoryName": "한방병원"
                },
                {
                    "subCategoryId": "HOS019",
                    "subCategoryName": "흉부외과"
                },
                {
                    "subCategoryId": "HOS020",
                    "subCategoryName": "항문외과"
                },
                {
                    "subCategoryId": "HOS021",
                    "subCategoryName": "신경외과"
                },
                {
                    "subCategoryId": "HOS022",
                    "subCategoryName": "영상의학과 "
                },
                {
                    "subCategoryId": "HOS023",
                    "subCategoryName": "약국"
                },
                {
                    "subCategoryId": "HOS024",
                    "subCategoryName": "의료기구"
                },
                {
                    "subCategoryId": "HOS025",
                    "subCategoryName": "신경과"
                },
                {
                    "subCategoryId": "HOS026",
                    "subCategoryName": "검진센터"
                },
                {
                    "subCategoryId": "HOS027",
                    "subCategoryName": "병원 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:32.000+09",
            "categoryName": "쇼핑",
            "categoryId": "SHO",
            "subCategories": [
                {
                    "subCategoryId": "SHO001",
                    "subCategoryName": "의류"
                },
                {
                    "subCategoryId": "SHO002",
                    "subCategoryName": "가전/가구"
                },
                {
                    "subCategoryId": "SHO003",
                    "subCategoryName": "생활용품"
                },
                {
                    "subCategoryId": "SHO004",
                    "subCategoryName": "유아동"
                },
                {
                    "subCategoryId": "SHO005",
                    "subCategoryName": "자동차용품"
                },
                {
                    "subCategoryId": "SHO006",
                    "subCategoryName": "종합몰/마트/백화점"
                },
                {
                    "subCategoryId": "SHO007",
                    "subCategoryName": "오프라인 쇼핑"
                },
                {
                    "subCategoryId": "SHO008",
                    "subCategoryName": "해외쇼핑"
                },
                {
                    "subCategoryId": "SHO009",
                    "subCategoryName": "공동구매"
                },
                {
                    "subCategoryId": "SHO010",
                    "subCategoryName": "주문/배달/방문"
                },
                {
                    "subCategoryId": "SHO011",
                    "subCategoryName": "중고거래"
                },
                {
                    "subCategoryId": "SHO012",
                    "subCategoryName": "패션잡화"
                },
                {
                    "subCategoryId": "SHO013",
                    "subCategoryName": "스포츠용품"
                },
                {
                    "subCategoryId": "SHO014",
                    "subCategoryName": "핸드폰/주변기기"
                },
                {
                    "subCategoryId": "SHO015",
                    "subCategoryName": "대여"
                },
                {
                    "subCategoryId": "SHO016",
                    "subCategoryName": "슈퍼마켓"
                },
                {
                    "subCategoryId": "SHO017",
                    "subCategoryName": "쇼핑 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:33.000+09",
            "categoryName": "뷰티",
            "categoryId": "BEU",
            "subCategories": [
                {
                    "subCategoryId": "BEU001",
                    "subCategoryName": "화장품"
                },
                {
                    "subCategoryId": "BEU002",
                    "subCategoryName": "헤어"
                },
                {
                    "subCategoryId": "BEU003",
                    "subCategoryName": "스킨"
                },
                {
                    "subCategoryId": "BEU004",
                    "subCategoryName": "네일"
                },
                {
                    "subCategoryId": "BEU005",
                    "subCategoryName": "뷰티정보"
                },
                {
                    "subCategoryId": "BEU006",
                    "subCategoryName": "다이어트/체형관리"
                },
                {
                    "subCategoryId": "BEU007",
                    "subCategoryName": "뷰티 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:33.000+09",
            "categoryName": "여행/레저/스포츠",
            "categoryId": "TRI",
            "subCategories": [
                {
                    "subCategoryId": "TRI001",
                    "subCategoryName": "놀이/레저"
                },
                {
                    "subCategoryId": "TRI002",
                    "subCategoryName": "유아놀이시설"
                },
                {
                    "subCategoryId": "TRI003",
                    "subCategoryName": "여행사"
                },
                {
                    "subCategoryId": "TRI004",
                    "subCategoryName": "숙박시설"
                },
                {
                    "subCategoryId": "TRI005",
                    "subCategoryName": "여행정보"
                },
                {
                    "subCategoryId": "TRI006",
                    "subCategoryName": "운동시설"
                },
                {
                    "subCategoryId": "TRI007",
                    "subCategoryName": "여행/레저/스포츠 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:33.000+09",
            "categoryName": "엔터테인먼트",
            "categoryId": "MED",
            "subCategories": [
                {
                    "subCategoryId": "MED001",
                    "subCategoryName": "게임 "
                },
                {
                    "subCategoryId": "MED002",
                    "subCategoryName": "공연/전시/축제"
                },
                {
                    "subCategoryId": "MED003",
                    "subCategoryName": "만화/애니"
                },
                {
                    "subCategoryId": "MED004",
                    "subCategoryName": "미술/디자인 "
                },
                {
                    "subCategoryId": "MED005",
                    "subCategoryName": "방송"
                },
                {
                    "subCategoryId": "MED006",
                    "subCategoryName": "뉴스"
                },
                {
                    "subCategoryId": "MED007",
                    "subCategoryName": "책/잡지"
                },
                {
                    "subCategoryId": "MED008",
                    "subCategoryName": "영화"
                },
                {
                    "subCategoryId": "MED009",
                    "subCategoryName": "음악"
                },
                {
                    "subCategoryId": "MED010",
                    "subCategoryName": "문화시설"
                },
                {
                    "subCategoryId": "MED011",
                    "subCategoryName": "노래방"
                },
                {
                    "subCategoryId": "MED012",
                    "subCategoryName": "영화관"
                },
                {
                    "subCategoryId": "MED013",
                    "subCategoryName": "소속사/연예인"
                },
                {
                    "subCategoryId": "MED014",
                    "subCategoryName": "미디어/엔터테인먼트 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:33.000+09",
            "categoryName": "자동차/교통",
            "categoryId": "CAR",
            "subCategories": [
                {
                    "subCategoryId": "CAR001",
                    "subCategoryName": "자동차"
                },
                {
                    "subCategoryId": "CAR002",
                    "subCategoryName": "교통"
                },
                {
                    "subCategoryId": "CAR003",
                    "subCategoryName": "중고판매"
                },
                {
                    "subCategoryId": "CAR004",
                    "subCategoryName": "대리운전"
                },
                {
                    "subCategoryId": "CAR005",
                    "subCategoryName": "수리/튜닝"
                },
                {
                    "subCategoryId": "CAR006",
                    "subCategoryName": "렌트/리스"
                },
                {
                    "subCategoryId": "CAR007",
                    "subCategoryName": "자동차/교통 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:34.000+09",
            "categoryName": "기관/단체",
            "categoryId": "ORG",
            "subCategories": [
                {
                    "subCategoryId": "ORG001",
                    "subCategoryName": "공공/행정"
                },
                {
                    "subCategoryId": "ORG002",
                    "subCategoryName": "비영리"
                },
                {
                    "subCategoryId": "ORG003",
                    "subCategoryName": "정치/사회"
                },
                {
                    "subCategoryId": "ORG004",
                    "subCategoryName": "복지"
                },
                {
                    "subCategoryId": "ORG005",
                    "subCategoryName": "종교"
                },
                {
                    "subCategoryId": "ORG006",
                    "subCategoryName": "모임"
                },
                {
                    "subCategoryId": "ORG007",
                    "subCategoryName": "기관/단체 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:34.000+09",
            "categoryName": "금융",
            "categoryId": "FIN",
            "subCategories": [
                {
                    "subCategoryId": "FIN001",
                    "subCategoryName": "은행"
                },
                {
                    "subCategoryId": "FIN002",
                    "subCategoryName": "저축은행"
                },
                {
                    "subCategoryId": "FIN003",
                    "subCategoryName": "카드"
                },
                {
                    "subCategoryId": "FIN004",
                    "subCategoryName": "증권"
                },
                {
                    "subCategoryId": "FIN005",
                    "subCategoryName": "보험"
                },
                {
                    "subCategoryId": "FIN006",
                    "subCategoryName": "부동산"
                },
                {
                    "subCategoryId": "FIN007",
                    "subCategoryName": "금융 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:34.000+09",
            "categoryName": "서비스",
            "categoryId": "SRV",
            "subCategories": [
                {
                    "subCategoryId": "SRV001",
                    "subCategoryName": "광고/마케팅 "
                },
                {
                    "subCategoryId": "SRV002",
                    "subCategoryName": "생활"
                },
                {
                    "subCategoryId": "SRV003",
                    "subCategoryName": "비즈니스"
                },
                {
                    "subCategoryId": "SRV004",
                    "subCategoryName": "건축/기술/과학"
                },
                {
                    "subCategoryId": "SRV005",
                    "subCategoryName": "법률/회계/세무"
                },
                {
                    "subCategoryId": "SRV006",
                    "subCategoryName": "취업/창업"
                },
                {
                    "subCategoryId": "SRV007",
                    "subCategoryName": "서비스 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:34.000+09",
            "categoryName": "제조",
            "categoryId": "MAN",
            "subCategories": [
                {
                    "subCategoryId": "MAN001",
                    "subCategoryName": "전자"
                }
            ]
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 목록 조회

## Request

## 마스터 또는 매니저 계정으로 운영 권한이 있는 브랜드 목록을 조회합니다.<br>

> 마스터 또는 매니저 계정으로 운영 권한이 있는 브랜드 목록을 조회합니다.  \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*\
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/corp/{personId}/brand":{"get":{"summary":"마스터 또는 매니저 계정으로 운영 권한이 있는 브랜드 목록을 조회합니다.\n","description":"마스터 또는 매니저 계정으로 운영 권한이 있는 브랜드 목록을 조회합니다.  \n  + **계정 권한 : 마스터, 매니저**\n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## **Response**

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 기본 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="197">필드명</th><th width="144">타입</th><th width="86" align="center">길이</th><th width="108" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>name</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>브랜드 이름 - 브랜드 등록 시 지정합니다.</td></tr><tr><td><strong><code>brandKey</code></strong></td><td>string</td><td align="center">18</td><td align="center"></td><td></td><td>브랜드 Key - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 - 브랜드 등록 일시입니다.</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인일시 - 브랜드가 검수에서 승인된 일시입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 - 브랜드의 정보가 수정된 일시입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td></td><td align="center"></td><td align="center"></td><td></td><td><p>브랜드의 상태 입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 브랜드 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.</li><li>검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다.<br>브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.</li></ul></td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>chatbotDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.</td></tr><tr><td><strong><code>messagebaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.</td></tr><tr><td><strong><code>logoDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 로고이미지 중 가장 최근에 변경된 로고이미지의 일시 정보 입니다.</td></tr><tr><td><strong><code>autoreplymsgDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 자동응답메시지 중 가장 최근에 변경된 자동응답메시지의 일시 정보 입니다.</td></tr></tbody></table>

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="142">필드명</th><th width="89">타입</th><th width="91" align="center">길이</th><th width="104" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>typeName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미지</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "승인",
            "chatbotDate": null,
            "messagebaseDate": "2024-05-17T17:48:07.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-05-17T17:49:24.000+09",
            "approvalDate": "2024-05-17T17:49:24.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "background"
                },
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ]
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 상세 조회

## Request

## 브랜드 상세 정보를 조회합니다.<br>

> 관리 중인 브랜드의 상세 정보를 조회합니다.  \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/corp/{personId}/brand/{brandId}":{"get":{"summary":"브랜드 상세 정보를 조회합니다.\n","description":"관리 중인 브랜드의 상세 정보를 조회합니다.  \n  + **계정 권한 : 마스터, 매니저**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## **Response**

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 상세 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="190">필드명</th><th width="144">타입</th><th width="86" align="center">길이</th><th width="108" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>name</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>브랜드 이름 - 브랜드 등록 시 지정합니다.</td></tr><tr><td><strong><code>brandKey</code></strong></td><td>string</td><td align="center">18</td><td align="center"></td><td></td><td>브랜드 Key - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 - 브랜드 등록 일시입니다.</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인일시 - 브랜드가 검수에서 승인된 일시입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 - 브랜드의 정보가 수정된 일시입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td></td><td align="center"></td><td align="center"></td><td></td><td><p>브랜드의 상태 입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 브랜드 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.</li><li>검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다.<br>브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.</li></ul></td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>chatbotDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.</td></tr><tr><td><strong><code>logoDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 로고이미지 중 가장 최근에 변경된 로고이미지의 일시 정보 입니다.</td></tr><tr><td><strong><code>autoreplymsgDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 자동응답메시지 중 가장 최근에 변경된 자동응답메시지의 일시 정보 입니다.</td></tr><tr><td><strong><code>messagebaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.</td></tr><tr><td><strong><code>description</code></strong></td><td>string</td><td align="center">150</td><td align="center"></td><td></td><td>브랜드 설명에 등록된 내용입니다.</td></tr><tr><td><strong><code>tel</code></strong></td><td>string</td><td align="center">12</td><td align="center"></td><td></td><td>브랜드홈에 노출될 전화번호(대표발신번호와 별개) 입니다.<br><strong><code>2025년 6월 24일부터 단말의 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 tel에 설정된 값은 사용되지 않습니다.</code></strong></td></tr><tr><td><a href="#menu-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>menus</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center">3</td><td align="center"></td><td></td><td>브랜드 홈에는 최대 4개까지 표시됩니다. chat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.</td></tr><tr><td><strong><code>categoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 ID 입니다.</td></tr><tr><td><strong><code>categoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 명 입니다.</td></tr><tr><td><strong><code>subCategoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 하위 카테고리 ID 입니다.</td></tr><tr><td><strong><code>subCategoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 하위 카테고리 명 입니다.</td></tr><tr><td><strong><code>categoryOpt</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>검색용 키워드 임의 등록 할 수 있습니다.</td></tr><tr><td><strong><code>zipCode</code></strong></td><td>string</td><td align="center">5</td><td align="center"></td><td></td><td>브랜드 홈에 표시될 우편번호(5자리) 입니다.</td></tr><tr><td><strong><code>roadAddress</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 도로명주소 입니다.</td></tr><tr><td><strong><code>detailAddress</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 상세주소 입니다.</td></tr><tr><td><strong><code>email</code></strong></td><td>string</td><td align="center">100</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 이메일주소 입니다.</td></tr><tr><td><strong><code>webSiteUrl</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 홈페이지 주소 입니다.</td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>검수 시 반려 사유가 제공됩니다.</td></tr><tr><td><strong><code>brandFeedUrl</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 소식 URL 입니다. 브랜드 소식을 최초 등록하거나 브랜드 홈 기본 탭을 소식탭(FEED)로 설정하면 자동 생성됩니다.</td></tr><tr><td><strong><code>initTab</code></strong></td><td>string</td><td align="center">5</td><td align="center"></td><td>FEED</td><td><p>단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다. 미지정 시 기본값은 FEED 입니다.</p><ul><li>FEED: 소식탭을 기본 탭으로 지정합니다.</li><li>INFO: 정보탭을 기본 탭으로 지정합니다. 브랜드 최초 승인 시에만 선택이 가능하며 승인 이후에는 수정이 불가합니다.</li></ul></td></tr><tr><td><strong><code>initFeedItems</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td><p>initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다. menus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다. menus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.<br></p><p>Allowed values</p><ul><li>"call"</li><li>"web"</li><li>"store"</li><li>"order"</li><li>"buy"</li><li>"tickets"</li><li>"moreinfo"</li><li>"portalsearch"</li></ul><p>Example["call", "web", "moreinfo", "portalsearch"]</p></td></tr><tr><td><strong><code>templateColor</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.</td></tr><tr><td><strong><code>bizInfoYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>N</td><td>브랜드 소식탭에 운영정보 사용 여부를 설정합니다.</td></tr><tr><td><strong><code>bizInfoTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.</td></tr><tr><td><strong><code>bizInfoContent</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>N</td><td><p></p><p>안심마크 지정 기업 여부를 표시합니다.</p><ul><li>Y : 안심마크 지정</li><li>N : 안심마크 미지정</li></ul></td></tr></tbody></table>

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="142">필드명</th><th width="89">타입</th><th width="91" align="center">길이</th><th width="104" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>typeName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미지</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">menus</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="142">필드명</th><th width="89">타입</th><th width="91" align="center">길이</th><th width="104" align="center">필수여부</th><th width="81">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonType</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>applink</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>weblink</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미지</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "승인",
            "approvalReason": "승인완료(비승인)",
            "chatbotDate": null,
            "messagebaseDate": "2024-05-17T17:48:07.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-06-03T15:16:31.000+09",
            "approvalDate": "2024-06-03T15:14:19.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ],
            "menus": [
                {
                    "buttonType": "tickets",
                    "weblink": "https://si-www-qa.rcsbizcenter.com",
                    "feedinfoYn": "N"
                }
            ],
            "description": "테스트브랜드입니다.",
            "tel": "30000800",
            "categoryId": "EDU",
            "categoryName": "교육",
            "subCategoryId": "EDU007",
            "subCategoryName": "유학/연수",
            "categoryOpt": null,
            "zipCode": "55110",
            "roadAddress": "서울특별시",
            "detailAddress": "109-5",
            "email": "hong@google.com",
            "webSiteUrl": "https://si-www-qa.rcsbizcenter.com",
            "brandFeedUrl": null,
            "initTab": "INFO",
            "initFeedItems": [],
            "templateColor": null,
            "bizInfoYn": "N",
            "bizInfoTitle": null,
            "bizInfoContent": null,
            "saftyStatusYn": "N"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 등록 승인 요청

## Request

## 마스터, 매니저 계정을 이용하여 신규 브랜드 등록 승인을 요청합니다.<br>

> 마스터, 매니저 계정을 이용하여 신규 브랜드 등록 승인을 요청합니다. \
> &#x20; \+ 매니저 계정도 브랜드 등록이 가능하도록 권한 변경되었습니다. 단, 마스터로 승인을 받아야만 등록한 브랜드를 승인 받을 수 있습니다.  \
> &#x20; \+ 필수 항목이었던 발신번호는 옵션으로 변경되었습니다.\
> &#x20; \+ 발신번호를 함께 등록하는 경우에만 발신번호에 대한 '통신서비스 이용증명원'을 함께 등록하면 됩니다.    \
> 브랜드를 등록한 계정은 브랜드의 대표운영자로 설정되며, 매니저 권한으로 등록한 브랜드는 마스터 권한 승급을 받아야 승인을 받을 수\
> 있습니다.    \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"schemas":{"RegBrandInfo":{"description":"브랜드 등록 정보 객체입니다.  \nObject 세부구성은 [RegBrandInfo](#/RegBrandInfo)를 참고하시기 바랍니다.  \n","type":"object","properties":{"regBrand":{"type":"object","required":["name","description","categoryId","subCategoryId"],"properties":{"name":{"type":"string","maxLength":20,"description":"maxLength: 20 - 브랜드 홈에 표시되는 브랜드 이름 입니다.\n"},"description":{"type":"string","maxLength":150,"description":"maxLength: 150 - 브랜드 홈에 표시되는 브랜드 설명 입니다.\n"},"tel":{"type":"string","maxLength":12,"description":"maxLength: 12 - 브랜드 홈에 노출될 전화번호(대표발신번호와 별개) 입니다.\n\n**2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 값 설정 시 무시됩니다.**\n","deprecated":true},"menus":{"description":"maximum: 3 - 브랜드 홈에는 최대 4개까지 표시됩니다.  \n\nchat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.  \n\n  + **2020년 12월 3일 기준 브랜드 menus 중 app 은 이통사 정책에 의거 한시적으로 등록이 불가하며 app 등록 시 error 리턴됩니다.**\n","type":"array","items":{"$ref":"#/components/schemas/MenuItemInfo"},"maximum":3},"categoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 카테고리 ID 입니다.\n"},"subCategoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 하위 카테고리 ID 입니다.\n"},"categoryOpt":{"type":"string","maxLength":20,"description":"maxLength: 20 - 검색용 키워드 임의 등록 할 수 있습니다.\n"},"zipCode":{"type":"string","maxLength":5,"description":"maxLength: 5 - 브랜드 홈에 표시될 우편번호(5자리) 입니다.\n"},"roadAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 도로명주소 입니다.\n"},"detailAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 상세주소 입니다.\n"},"email":{"type":"string","maxLength":100,"format":"email","description":"maxLength: 100 - 브랜드 홈에 표시되는 이메일주소 입니다.\n"},"webSiteUrl":{"type":"string","maxLength":128,"description":"maxLength: 128 - 브랜드 홈에 표시되는 홈페이지 주소 입니다.\n"},"initTab":{"type":"string","maxLength":5,"description":"maxLength: 5 - 단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다.  \n미지정 시 기본값은 FEED 입니다.  \n\n  + FEED: 소식탭을 기본 탭으로 지정합니다.   \n  + INFO: 정보탭을 기본 탭으로 지정합니다.  \n","enum":["FEED","INFO"],"default":"FEED"},"initFeedItem":{"type":"string","maxLength":6,"description":"maxLength: 6 - 하위 호환성을 위해 필드는 유지되지만, 동일한 용도의 initFeedItems 사용을 권고합니다.   \n\n  + TEL: 소식탭에 전화걸기(= 퀵버튼 call) 버튼이 표시됩니다. **2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**   \n  + HOME: 소식탭에 Web 연결(= 퀵버튼 web) 버튼이 표시됩니다.   \n  + SEARCH: 소식탭에 포털검색(= portalsearch) 버튼이 표시되며, 소식탭 전용 퀵버튼입니다.  \n","enum":["TEL","HOME","SEARCH"],"deprecated":true},"initFeedItems":{"description":"initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다.  \n\nmenus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다.  \n\nmenus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시 가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.  \n\n**call은 2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**\n","type":"array","items":{"type":"string","enum":["call","web","store","order","buy","tickets","moreinfo","portalsearch"]}},"templateColor":{"description":"maxLength: 10 - 브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.\n","type":"string","maxLength":10},"bizInfoYn":{"description":"브랜드 소식탭에 운영정보 사용 여부를 설정합니다.  \n","type":"string","enum":["Y","N"],"default":"N"},"bizInfoTitle":{"description":"maxLength: 20 - bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.  \n","type":"string","maxLength":20},"bizInfoContent":{"description":"maxLength: 200 - bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.\n","type":"string","maxLength":200}}}}},"MenuItemInfo":{"type":"object","description":"브랜드 홈에 표시 가능한 버튼 정보 객체입니다. AppLink와 WebLink가 모두 설정된 경우 단말에 app 이 설치되어 있으면 app을 실행하고 설치되지 않은 경우 weblink로 연결됩니다.\n","properties":{"buttonType":{"type":"string","maxLength":20,"description":"maxLength: 20 - 버튼 유형\n","enum":["call","web","app","store","order","buy","tickets","moreinfo"]},"applink":{"$ref":"#/components/schemas/AppLinkItemInfo"},"weblink":{"type":"string","maxLength":128,"description":"maxLength: 128 - buttonType call 을 제외한 모든 버튼은 Web URL을 입력해야 합니다. URL은 http:// 또는 https:// 로 시작하여야 합니다.\n"}},"required":["buttonType"]},"AppLinkItemInfo":{"type":"object","description":"APP Link의 패키지 Name, Action, URL 정보 객체입니다.\n","properties":{"packageName":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 package name 을 지정합니다.\n"},"action":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 Action 을 지정합니다.\n"},"uri":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 URI 지정합니다.\n"}},"required":["packageName","action","uri"]},"RegChatbotInfo":{"description":"대화방(발신번호) 등록 정보 객체입니다.  \nObject 구성은 [RegChatbotInfo](#/RegChatbotInfo)를 참고하시기 바랍니다.\n","type":"object","properties":{"mdn":{"type":"string","maxLength":40,"description":"maxLength: 40 - 등록할 발신번호입니다. 국가번호는 제외하고 등록하며, 현재 정책적으로 휴대전화번호는 등록이 불가합니다.\n"},"subNum":{"type":"string","maxLength":40,"description":"maxLength: 40 - 회신번호 입니다. 발신번호(mdn)와 회신번호가 동일해야 합니다. 발신번호와 동일하게 설정됩니다.\n"},"subTitle":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대화방명입니다.\n"},"rcsReply":{"type":"string","enum":["0","1"],"description":"SMS MO 수신 0, RCS Postback 수신 1","default":"1"},"display":{"type":"string","enum":["11","10","01","00"],"default":"01","description":"대화방 전시 설정값 입니다. 설정하지 않을 경우 기본 '01'로 설정됩니다.  \n\n  + '11' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 전시  \n  + '10' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 비전시  \n  + '01' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 전시  \n  + '00' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 비전시  \n"},"inputField":{"type":"integer","description":"단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.  \n\n  + 0 : 비활성화  \n  + 1 : 활성화\n","enum":[0,1],"default":1},"subDescr":{"type":"string","description":"maxLength: 50 - 대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.  \n","maxLength":50},"saftyStatusYn":{"description":"안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.  \n\n  + Y : 안심마크 표시\n  + N : 안심마크 미표시\n","type":"string","enum":["Y","N"],"default":"Y"}},"required":["mdn","subTitle","rcsReply"]}}},"paths":{"/corp/brand":{"post":{"summary":"마스터, 매니저 계정을 이용하여 신규 브랜드 등록 승인을 요청합니다.\n","description":"마스터, 매니저 계정을 이용하여 신규 브랜드 등록 승인을 요청합니다. \n  + 매니저 계정도 브랜드 등록이 가능하도록 권한 변경되었습니다. 단, 마스터로 승인을 받아야만 등록한 브랜드를 승인 받을 수 있습니다.  \n  + 필수 항목이었던 발신번호는 옵션으로 변경되었습니다.\n  + 발신번호를 함께 등록하는 경우에만 발신번호에 대한 '통신서비스 이용증명원'을 함께 등록하면 됩니다.    \n브랜드를 등록한 계정은 브랜드의 대표운영자로 설정되며, 매니저 권한으로 등록한 브랜드는 마스터 권한 승급을 받아야 승인을 받을 수\n있습니다.    \n\n  + **계정 권한 : 마스터, 매니저**  \n","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","required":["regBrand","brandProfile"],"properties":{"regBrand":{"$ref":"#/components/schemas/RegBrandInfo"},"brandProfile":{"description":"브랜드 프로필 이미지를 업로드합니다.  \n\n**최소사이즈: 388X388px / 최대사이즈: 1080X1080px / 1:1 비율 / 파일형식 png (최대1MB)**\n","type":"object","format":"binary"},"brandBackground":{"description":"브랜드 백그라운드 이미지를 업로드합니다.  \n\n**최소사이즈: 388X388px / 최대사이즈: 1080X1080px / 1:1 비율 / 파일형식 jpg, png (최대1MB)**\n","type":"object","format":"binary"},"mainMdn":{"description":"maxLength: 40 - 대표발신번호 개념 제거되어 더 이상 유효하지 않습니다.\n","type":"string","maxLength":40,"deprecated":true},"chatbots":{"description":"등록할 대화방(발신번호) 정보를 최대 1000개까지 등록합니다.  \n","type":"object","properties":{"chatbots":{"type":"array","items":{"$ref":"#/components/schemas/RegChatbotInfo"},"maxItems":1000,"minItems":1}}},"subNumCertificate":{"description":"통신서비스 이용증명원을 업로드합니다.  \n\n대화방(발신번호) 등록을 위해 chatbots 지정한 경우 필수로 함께 업로드해야 합니다.  \n\n**파일형식 : jpg, png, pdf, tiff, zip (최대20MB)**  \n","type":"object","format":"binary"},"seasonDocFile":{"description":"시즌 내 신청 생성된 가상기업에 등록되는 브랜드의 경우 별도 요구되는 서류를 파일로 등록합니다.\n\n**파일형식 jpg, jpeg, png, pdf, tiff, zip (최대 5MB)**\n","type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ Request body form data sample

{% tabs %}
{% tab title="regBrand" %}

```
'regBrand="{
    \"regBrand\": {
        \"name\": \"테스트브랜드\",
        \"description\": \"신규브랜드등록승인요청\",
        \"tel\": \"09046123177\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"03924\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"17층\",
        \"menus\": [ {\"buttonType\": \"call\"}, {\"buttonType\": \"chat\"} ]
    }
}"' \
```

{% endtab %}

{% tab title="chatbots" %}

```
'chatbots="{
    \"chatbots\": [{
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호1\"
        }, {
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호2\"
        }
    ]
}"' \
```

{% endtab %}
{% endtabs %}

## **Response**

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 브랜드ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="82">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>등록된 브랜드ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64329",
        "message": "Missing profile image"
    },
    "status": 400
}

{
    "error": {
        "code": "64332",
        "message": "brand profile file is only png"
    },
    "status": 400
}

{
    "error": {
        "code": "64305",
        "message": "Missing Certification document"
    },
    "status": 400
}

{
    "error": {
        "code": "64341",
        "message": "Duplicate MDN 09046120000 in chatbots"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63002",
        "message": "No Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 등록 승인 요청 취소

## Request

## 신규 개설한 승인대기 중인 브랜드의 승인요청을 취소합니다.  <br>

> 신규 개설한 승인대기 중인 브랜드의 승인요청을 취소합니다.  \
> \
> 검수가 시작된 브랜드는 승인취소가 불가 합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*  \
> &#x20; \+ \*\*가능 상태 : 승인대기\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/corp/brand/{brandId}/cancel":{"put":{"summary":"신규 개설한 승인대기 중인 브랜드의 승인요청을 취소합니다.  \n","description":"신규 개설한 승인대기 중인 브랜드의 승인요청을 취소합니다.  \n\n검수가 시작된 브랜드는 승인취소가 불가 합니다.  \n\n  + **계정 권한 : 마스터, 매니저**  \n  + **가능 상태 : 승인대기**  \n","parameters":[{"$ref":"#/components/parameters/BrandId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## **Response**

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>승인취소 된 브랜드 ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="87">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>승인취소 된 브랜드 ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 반려 브랜드 등록 재승인 요청

## Request

## RBC 웹에서 임시저장으로 등록한 브랜드 또는 신규 브랜드 등록 검수 시 반려된 경우 브랜드 수정 후 승인요청 시 사용합니다.<br>

> RBC 웹에서 임시저장으로 등록한 브랜드 또는 신규 브랜드 등록 검수 시 반려된 경우 브랜드 수정 후 승인요청 시 사용합니다.  \
> \
> 브랜드 등록 POST API를 통해 \*\*승인\*\* 요청하였으나 검수 시 \*\*반려\*\*되어 재승인 요청 또는  \
> \*\*RBC 홈페이지\*\*에서 \*\*임시저장\*\*한 브랜드 정보를 수정하여 승인 요청하는 경우 사용합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*\
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자(브랜드를 등록한 마스터 또는 매니저)\*\*  \
> &#x20; \+ \*\*수정 대상 브랜드 상태 : 반려, 저장\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegBrandInfo":{"description":"브랜드 등록 정보 객체입니다.  \nObject 세부구성은 [RegBrandInfo](#/RegBrandInfo)를 참고하시기 바랍니다.  \n","type":"object","properties":{"regBrand":{"type":"object","required":["name","description","categoryId","subCategoryId"],"properties":{"name":{"type":"string","maxLength":20,"description":"maxLength: 20 - 브랜드 홈에 표시되는 브랜드 이름 입니다.\n"},"description":{"type":"string","maxLength":150,"description":"maxLength: 150 - 브랜드 홈에 표시되는 브랜드 설명 입니다.\n"},"tel":{"type":"string","maxLength":12,"description":"maxLength: 12 - 브랜드 홈에 노출될 전화번호(대표발신번호와 별개) 입니다.\n\n**2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 값 설정 시 무시됩니다.**\n","deprecated":true},"menus":{"description":"maximum: 3 - 브랜드 홈에는 최대 4개까지 표시됩니다.  \n\nchat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.  \n\n  + **2020년 12월 3일 기준 브랜드 menus 중 app 은 이통사 정책에 의거 한시적으로 등록이 불가하며 app 등록 시 error 리턴됩니다.**\n","type":"array","items":{"$ref":"#/components/schemas/MenuItemInfo"},"maximum":3},"categoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 카테고리 ID 입니다.\n"},"subCategoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 하위 카테고리 ID 입니다.\n"},"categoryOpt":{"type":"string","maxLength":20,"description":"maxLength: 20 - 검색용 키워드 임의 등록 할 수 있습니다.\n"},"zipCode":{"type":"string","maxLength":5,"description":"maxLength: 5 - 브랜드 홈에 표시될 우편번호(5자리) 입니다.\n"},"roadAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 도로명주소 입니다.\n"},"detailAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 상세주소 입니다.\n"},"email":{"type":"string","maxLength":100,"format":"email","description":"maxLength: 100 - 브랜드 홈에 표시되는 이메일주소 입니다.\n"},"webSiteUrl":{"type":"string","maxLength":128,"description":"maxLength: 128 - 브랜드 홈에 표시되는 홈페이지 주소 입니다.\n"},"initTab":{"type":"string","maxLength":5,"description":"maxLength: 5 - 단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다.  \n미지정 시 기본값은 FEED 입니다.  \n\n  + FEED: 소식탭을 기본 탭으로 지정합니다.   \n  + INFO: 정보탭을 기본 탭으로 지정합니다.  \n","enum":["FEED","INFO"],"default":"FEED"},"initFeedItem":{"type":"string","maxLength":6,"description":"maxLength: 6 - 하위 호환성을 위해 필드는 유지되지만, 동일한 용도의 initFeedItems 사용을 권고합니다.   \n\n  + TEL: 소식탭에 전화걸기(= 퀵버튼 call) 버튼이 표시됩니다. **2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**   \n  + HOME: 소식탭에 Web 연결(= 퀵버튼 web) 버튼이 표시됩니다.   \n  + SEARCH: 소식탭에 포털검색(= portalsearch) 버튼이 표시되며, 소식탭 전용 퀵버튼입니다.  \n","enum":["TEL","HOME","SEARCH"],"deprecated":true},"initFeedItems":{"description":"initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다.  \n\nmenus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다.  \n\nmenus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시 가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.  \n\n**call은 2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**\n","type":"array","items":{"type":"string","enum":["call","web","store","order","buy","tickets","moreinfo","portalsearch"]}},"templateColor":{"description":"maxLength: 10 - 브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.\n","type":"string","maxLength":10},"bizInfoYn":{"description":"브랜드 소식탭에 운영정보 사용 여부를 설정합니다.  \n","type":"string","enum":["Y","N"],"default":"N"},"bizInfoTitle":{"description":"maxLength: 20 - bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.  \n","type":"string","maxLength":20},"bizInfoContent":{"description":"maxLength: 200 - bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.\n","type":"string","maxLength":200}}}}},"MenuItemInfo":{"type":"object","description":"브랜드 홈에 표시 가능한 버튼 정보 객체입니다. AppLink와 WebLink가 모두 설정된 경우 단말에 app 이 설치되어 있으면 app을 실행하고 설치되지 않은 경우 weblink로 연결됩니다.\n","properties":{"buttonType":{"type":"string","maxLength":20,"description":"maxLength: 20 - 버튼 유형\n","enum":["call","web","app","store","order","buy","tickets","moreinfo"]},"applink":{"$ref":"#/components/schemas/AppLinkItemInfo"},"weblink":{"type":"string","maxLength":128,"description":"maxLength: 128 - buttonType call 을 제외한 모든 버튼은 Web URL을 입력해야 합니다. URL은 http:// 또는 https:// 로 시작하여야 합니다.\n"}},"required":["buttonType"]},"AppLinkItemInfo":{"type":"object","description":"APP Link의 패키지 Name, Action, URL 정보 객체입니다.\n","properties":{"packageName":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 package name 을 지정합니다.\n"},"action":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 Action 을 지정합니다.\n"},"uri":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 URI 지정합니다.\n"}},"required":["packageName","action","uri"]},"RegChatbotInfo":{"description":"대화방(발신번호) 등록 정보 객체입니다.  \nObject 구성은 [RegChatbotInfo](#/RegChatbotInfo)를 참고하시기 바랍니다.\n","type":"object","properties":{"mdn":{"type":"string","maxLength":40,"description":"maxLength: 40 - 등록할 발신번호입니다. 국가번호는 제외하고 등록하며, 현재 정책적으로 휴대전화번호는 등록이 불가합니다.\n"},"subNum":{"type":"string","maxLength":40,"description":"maxLength: 40 - 회신번호 입니다. 발신번호(mdn)와 회신번호가 동일해야 합니다. 발신번호와 동일하게 설정됩니다.\n"},"subTitle":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대화방명입니다.\n"},"rcsReply":{"type":"string","enum":["0","1"],"description":"SMS MO 수신 0, RCS Postback 수신 1","default":"1"},"display":{"type":"string","enum":["11","10","01","00"],"default":"01","description":"대화방 전시 설정값 입니다. 설정하지 않을 경우 기본 '01'로 설정됩니다.  \n\n  + '11' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 전시  \n  + '10' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 비전시  \n  + '01' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 전시  \n  + '00' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 비전시  \n"},"inputField":{"type":"integer","description":"단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.  \n\n  + 0 : 비활성화  \n  + 1 : 활성화\n","enum":[0,1],"default":1},"subDescr":{"type":"string","description":"maxLength: 50 - 대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.  \n","maxLength":50},"saftyStatusYn":{"description":"안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.  \n\n  + Y : 안심마크 표시\n  + N : 안심마크 미표시\n","type":"string","enum":["Y","N"],"default":"Y"}},"required":["mdn","subTitle","rcsReply"]}}},"paths":{"/corp/brand/{brandId}":{"put":{"summary":"RBC 웹에서 임시저장으로 등록한 브랜드 또는 신규 브랜드 등록 검수 시 반려된 경우 브랜드 수정 후 승인요청 시 사용합니다.\n","description":"RBC 웹에서 임시저장으로 등록한 브랜드 또는 신규 브랜드 등록 검수 시 반려된 경우 브랜드 수정 후 승인요청 시 사용합니다.  \n\n브랜드 등록 POST API를 통해 **승인** 요청하였으나 검수 시 **반려**되어 재승인 요청 또는  \n**RBC 홈페이지**에서 **임시저장**한 브랜드 정보를 수정하여 승인 요청하는 경우 사용합니다.  \n\n  + **계정 권한 : 마스터, 매니저**\n  + **브랜드 권한 : 브랜드 대표운영자(브랜드를 등록한 마스터 또는 매니저)**  \n  + **수정 대상 브랜드 상태 : 반려, 저장**\n","parameters":[{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","required":["regBrand","brandProfile"],"properties":{"regBrand":{"$ref":"#/components/schemas/RegBrandInfo"},"brandProfile":{"description":"브랜드 프로필 이미지를 업로드합니다.  \n\n**최소사이즈: 388X388px / 최대사이즈: 1080X1080px / 1:1 비율 / 파일형식 png (최대1MB)**\n","type":"object","format":"binary"},"brandBackground":{"description":"브랜드 백그라운드 이미지를 업로드합니다.  \n\n**최소사이즈: 388X388px / 최대사이즈: 1080X1080px / 1:1 비율 / 파일형식 jpg, png (최대1MB)**\n","type":"object","format":"binary"},"mainMdn":{"description":"maxLength: 40 - 대표발신번호 개념 제거되어 더 이상 유효하지 않습니다.\n","type":"string","maxLength":40,"deprecated":true},"chatbots":{"description":"등록할 대화방(발신번호) 정보를 최대 1000개까지 등록합니다.  \n","type":"object","properties":{"chatbots":{"type":"array","items":{"$ref":"#/components/schemas/RegChatbotInfo"},"maxItems":1000,"minItems":1}}},"subNumCertificate":{"description":"통신서비스 이용증명원을 업로드합니다.  \n\n대화방(발신번호) 등록을 위해 chatbots 지정한 경우 필수로 함께 업로드해야 합니다.  \n\n**파일형식 : jpg, png, pdf, tiff, zip (최대20MB)**  \n","type":"object","format":"binary"},"seasonDocFile":{"description":"시즌 내 신청 생성된 가상기업에 등록되는 브랜드의 경우 별도 요구되는 서류를 파일로 등록합니다.\n\n**파일형식 jpg, jpeg, png, pdf, tiff, zip (최대 5MB)**\n","type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body form data sample

{% tabs %}
{% tab title="regBrand" %}

```
'regBrand="{
    \"regBrand\": {
        \"name\": \"테스트브랜드\",
        \"description\": \"반려브랜드등록재승인요청\",
        \"tel\": \"09046123177\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"03924\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"17층\",
        \"menus\": [ {\"buttonType\": \"call\"}, {\"buttonType\": \"chat\"} ]
    }
}"' \
```

{% endtab %}

{% tab title="chatbots" %}

<pre><code><strong>'chatbots="{
</strong>    \"chatbots\": [{
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호1\"
        }, {
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호2\"
        }
    ]
}"' \
</code></pre>

{% endtab %}
{% endtabs %}

## **Response**

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 브랜드ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="82">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>등록된 브랜드ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64329",
        "message": "Missing profile image"
    },
    "status": 400
}

{
    "error": {
        "code": "64332",
        "message": "brand profile file is only png"
    },
    "status": 400
}

{
    "error": {
        "code": "64305",
        "message": "Missing Certification document"
    },
    "status": 400
}

{
    "error": {
        "code": "64341",
        "message": "Duplicate MDN 09046120000 in chatbots"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 수정 승인 요청

## Request

## 현재 운영 중인 브랜드 정보를 수정 합니다. 브랜드명, 프로필/백그라운드 이미지가 수정되면 다시 승인을 받아야 합니다.<br>

> 현재 운영 중인 브랜드 정보를 수정 합니다.   \
> \
> 브랜드 대표운영자 또는 운영자 권한이 있어야 수정이 가능합니다.  \
> \
> \*\*브랜드명\*\* 또는 \*\*프로필/백그라운드 이미지\*\*가 수정되면 다시 승인을 받아야 합니다.  \
> \
> 이외 정보 수정은 별도의 승인 과정 없이 업데이트 됩니다.  \
> \
> 수정된 데이터가 이통 3사로 전송되는 과정에서 전송이 지연되거나 장애로 인해 이통 3사 모두 전송이 완료되지 못한 경우,  \
> 브랜드 정보 조회 데이터와 단말에서 표시되는 브랜드 홈 정보가 상이할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 대표운영자, 운영자\*\*  \
> &#x20; \+ \*\*수정 가능 상태 : 승인, 반려(수정승인)\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegBrandInfo":{"description":"브랜드 등록 정보 객체입니다.  \nObject 세부구성은 [RegBrandInfo](#/RegBrandInfo)를 참고하시기 바랍니다.  \n","type":"object","properties":{"regBrand":{"type":"object","required":["name","description","categoryId","subCategoryId"],"properties":{"name":{"type":"string","maxLength":20,"description":"maxLength: 20 - 브랜드 홈에 표시되는 브랜드 이름 입니다.\n"},"description":{"type":"string","maxLength":150,"description":"maxLength: 150 - 브랜드 홈에 표시되는 브랜드 설명 입니다.\n"},"tel":{"type":"string","maxLength":12,"description":"maxLength: 12 - 브랜드 홈에 노출될 전화번호(대표발신번호와 별개) 입니다.\n\n**2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 값 설정 시 무시됩니다.**\n","deprecated":true},"menus":{"description":"maximum: 3 - 브랜드 홈에는 최대 4개까지 표시됩니다.  \n\nchat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.  \n\n  + **2020년 12월 3일 기준 브랜드 menus 중 app 은 이통사 정책에 의거 한시적으로 등록이 불가하며 app 등록 시 error 리턴됩니다.**\n","type":"array","items":{"$ref":"#/components/schemas/MenuItemInfo"},"maximum":3},"categoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 카테고리 ID 입니다.\n"},"subCategoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 하위 카테고리 ID 입니다.\n"},"categoryOpt":{"type":"string","maxLength":20,"description":"maxLength: 20 - 검색용 키워드 임의 등록 할 수 있습니다.\n"},"zipCode":{"type":"string","maxLength":5,"description":"maxLength: 5 - 브랜드 홈에 표시될 우편번호(5자리) 입니다.\n"},"roadAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 도로명주소 입니다.\n"},"detailAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 상세주소 입니다.\n"},"email":{"type":"string","maxLength":100,"format":"email","description":"maxLength: 100 - 브랜드 홈에 표시되는 이메일주소 입니다.\n"},"webSiteUrl":{"type":"string","maxLength":128,"description":"maxLength: 128 - 브랜드 홈에 표시되는 홈페이지 주소 입니다.\n"},"initTab":{"type":"string","maxLength":5,"description":"maxLength: 5 - 단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다.  \n미지정 시 기본값은 FEED 입니다.  \n\n  + FEED: 소식탭을 기본 탭으로 지정합니다.   \n  + INFO: 정보탭을 기본 탭으로 지정합니다.  \n","enum":["FEED","INFO"],"default":"FEED"},"initFeedItem":{"type":"string","maxLength":6,"description":"maxLength: 6 - 하위 호환성을 위해 필드는 유지되지만, 동일한 용도의 initFeedItems 사용을 권고합니다.   \n\n  + TEL: 소식탭에 전화걸기(= 퀵버튼 call) 버튼이 표시됩니다. **2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**   \n  + HOME: 소식탭에 Web 연결(= 퀵버튼 web) 버튼이 표시됩니다.   \n  + SEARCH: 소식탭에 포털검색(= portalsearch) 버튼이 표시되며, 소식탭 전용 퀵버튼입니다.  \n","enum":["TEL","HOME","SEARCH"],"deprecated":true},"initFeedItems":{"description":"initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다.  \n\nmenus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다.  \n\nmenus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시 가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.  \n\n**call은 2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**\n","type":"array","items":{"type":"string","enum":["call","web","store","order","buy","tickets","moreinfo","portalsearch"]}},"templateColor":{"description":"maxLength: 10 - 브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.\n","type":"string","maxLength":10},"bizInfoYn":{"description":"브랜드 소식탭에 운영정보 사용 여부를 설정합니다.  \n","type":"string","enum":["Y","N"],"default":"N"},"bizInfoTitle":{"description":"maxLength: 20 - bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.  \n","type":"string","maxLength":20},"bizInfoContent":{"description":"maxLength: 200 - bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.\n","type":"string","maxLength":200}}}}},"MenuItemInfo":{"type":"object","description":"브랜드 홈에 표시 가능한 버튼 정보 객체입니다. AppLink와 WebLink가 모두 설정된 경우 단말에 app 이 설치되어 있으면 app을 실행하고 설치되지 않은 경우 weblink로 연결됩니다.\n","properties":{"buttonType":{"type":"string","maxLength":20,"description":"maxLength: 20 - 버튼 유형\n","enum":["call","web","app","store","order","buy","tickets","moreinfo"]},"applink":{"$ref":"#/components/schemas/AppLinkItemInfo"},"weblink":{"type":"string","maxLength":128,"description":"maxLength: 128 - buttonType call 을 제외한 모든 버튼은 Web URL을 입력해야 합니다. URL은 http:// 또는 https:// 로 시작하여야 합니다.\n"}},"required":["buttonType"]},"AppLinkItemInfo":{"type":"object","description":"APP Link의 패키지 Name, Action, URL 정보 객체입니다.\n","properties":{"packageName":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 package name 을 지정합니다.\n"},"action":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 Action 을 지정합니다.\n"},"uri":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 URI 지정합니다.\n"}},"required":["packageName","action","uri"]}}},"paths":{"/corp/{personId}/brand/{brandId}":{"put":{"summary":"현재 운영 중인 브랜드 정보를 수정 합니다. 브랜드명, 프로필/백그라운드 이미지가 수정되면 다시 승인을 받아야 합니다.\n","description":"현재 운영 중인 브랜드 정보를 수정 합니다.   \n\n브랜드 대표운영자 또는 운영자 권한이 있어야 수정이 가능합니다.  \n\n**브랜드명** 또는 **프로필/백그라운드 이미지**가 수정되면 다시 승인을 받아야 합니다.  \n\n이외 정보 수정은 별도의 승인 과정 없이 업데이트 됩니다.  \n\n수정된 데이터가 이통 3사로 전송되는 과정에서 전송이 지연되거나 장애로 인해 이통 3사 모두 전송이 완료되지 못한 경우,  \n브랜드 정보 조회 데이터와 단말에서 표시되는 브랜드 홈 정보가 상이할 수 있습니다.  \n\n  + **계정 권한 : 마스터, 매니저**  \n  + **브랜드 권한 : 대표운영자, 운영자**  \n  + **수정 가능 상태 : 승인, 반려(수정승인)**  \n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"regBrand":{"$ref":"#/components/schemas/RegBrandInfo"},"brandProfile":{"description":"브랜드 프로필 이미지를 업로드합니다.  \n\n**최소사이즈: 388X388px / 최대사이즈: 1080X1080px / 1:1 비율 권장 / 파일형식 png (최대1MB)**\n","type":"string","format":"binary"},"brandBackground":{"description":"브랜드 백그라운드 이미지를 업로드합니다.  \n\n등록되어 있는 브랜드 백그라운드 이미지를 제거하기 위해서는 파일 없이 brandBackground form key만 전송하면 됩니다.\n**최소사이즈: 388X388px / 최대사이즈: 1080X1080px / 1:1 비율 권장 / 파일형식 jpg, png (최대1MB)**\n","type":"string","format":"binary"},"seasonDocFile":{"description":"시즌 내 신청 생성된 가상기업에 등록되는 브랜드의 경우 별도 요구되는 서류를 파일로 등록합니다.\n\n**파일형식 jpg, jpeg, png, pdf, tiff, zip (최대 5MB)**\n","type":"string","format":"binary"},"mainMdn":{"description":"maxLength: 40 - 대표발신번호 개념 제거되어 더 이상 유효하지 않습니다.\n","type":"string","maxLength":40,"deprecated":true}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body form data sample

{% tabs %}
{% tab title="regBrand" %}

```
'regBrand="{
    \"regBrand\": {
        \"name\": \"테스트브랜드\",
        \"description\": \"테스트브랜드\",
        \"tel\": \"30000800\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"55110\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"109-5\",
        \"webSiteUrl\": \"http://www.google.com\",
        \"email\": \"lng0415@naver.com\",
        \"initTab\": \"INFO\",
        \"initFeedItem\": \"HOME\",
        \"menus\": [
            {
                \"buttonType\": \"tickets\",
                \"weblink\": \"http://www.google.com\"
            }
        ]
    }
}"' \
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 상세 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="190">필드명</th><th width="144">타입</th><th width="86" align="center">길이</th><th width="108" align="center">필수여부</th><th width="85">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>name</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>브랜드 이름 - 브랜드 등록 시 지정합니다.</td></tr><tr><td><strong><code>brandKey</code></strong></td><td>string</td><td align="center">18</td><td align="center"></td><td></td><td>브랜드 Key - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 - 브랜드 등록 일시입니다.</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인일시 - 브랜드가 검수에서 승인된 일시입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 - 브랜드의 정보가 수정된 일시입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td></td><td align="center"></td><td align="center"></td><td></td><td><p>브랜드의 상태 입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 브랜드 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.</li><li>검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다.<br>브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.</li></ul></td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>chatbotDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.</td></tr><tr><td><strong><code>logoDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 로고이미지 중 가장 최근에 변경된 로고이미지의 일시 정보 입니다.</td></tr><tr><td><strong><code>autoreplymsgDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 자동응답메시지 중 가장 최근에 변경된 자동응답메시지의 일시 정보 입니다.</td></tr><tr><td><strong><code>messagebaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.</td></tr><tr><td><strong><code>description</code></strong></td><td>string</td><td align="center">150</td><td align="center"></td><td></td><td>브랜드 설명에 등록된 내용입니다.</td></tr><tr><td><strong><code>tel</code></strong></td><td>string</td><td align="center">12</td><td align="center"></td><td></td><td>브랜드홈에 노출될 전화번호(대표발신번호와 별개) 입니다.</td></tr><tr><td><a href="#menu-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>menus</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center">3</td><td align="center"></td><td></td><td>브랜드 홈에는 최대 4개까지 표시됩니다. chat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.</td></tr><tr><td><strong><code>categoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 ID 입니다.</td></tr><tr><td><strong><code>categoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 명 입니다.</td></tr><tr><td><strong><code>subCategoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 하위 카테고리 ID 입니다.</td></tr><tr><td><strong><code>subCategoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 하위 카테고리 명 입니다.</td></tr><tr><td><strong><code>categoryOpt</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>검색용 키워드 임의 등록 할 수 있습니다.</td></tr><tr><td><strong><code>zipCode</code></strong></td><td>string</td><td align="center">5</td><td align="center"></td><td></td><td>브랜드 홈에 표시될 우편번호(5자리) 입니다.</td></tr><tr><td><strong><code>roadAddress</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 도로명주소 입니다.</td></tr><tr><td><strong><code>detailAddress</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 상세주소 입니다.</td></tr><tr><td><strong><code>email</code></strong></td><td>string</td><td align="center">100</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 이메일주소 입니다.</td></tr><tr><td><strong><code>webSiteUrl</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 홈페이지 주소 입니다.</td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>검수 시 반려 사유가 제공됩니다.</td></tr><tr><td><strong><code>brandFeedUrl</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 소식 URL 입니다. 브랜드 소식을 최초 등록하거나 브랜드 홈 기본 탭을 소식탭(FEED)로 설정하면 자동 생성됩니다.</td></tr><tr><td><strong><code>initTab</code></strong></td><td>string</td><td align="center">5</td><td align="center"></td><td>FEED</td><td><p>단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다. 미지정 시 기본값은 FEED 입니다.</p><ul><li>FEED: 소식탭을 기본 탭으로 지정합니다.</li><li>INFO: 정보탭을 기본 탭으로 지정합니다. 브랜드 최초 승인 시에만 선택이 가능하며 승인 이후에는 수정이 불가합니다.</li></ul></td></tr><tr><td><strong><code>initFeedItems</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td><p>initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다. menus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다. menus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.<br></p><p>Allowed values</p><ul><li>"call"</li><li>"web"</li><li>"store"</li><li>"order"</li><li>"buy"</li><li>"tickets"</li><li>"moreinfo"</li><li>"portalsearch"</li></ul><p>Example["call", "web", "moreinfo", "portalsearch"]</p></td></tr><tr><td><strong><code>templateColor</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.</td></tr><tr><td><strong><code>bizInfoYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>N</td><td>브랜드 소식탭에 운영정보 사용 여부를 설정합니다.</td></tr><tr><td><strong><code>bizInfoTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.</td></tr><tr><td><strong><code>bizInfoContent</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.</td></tr></tbody></table>

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="142">필드명</th><th width="89">타입</th><th width="91" align="center">길이</th><th width="104" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>typeName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미지</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">menu</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="142">필드명</th><th width="89">타입</th><th width="91" align="center">길이</th><th width="104" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonType</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>applink</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>weblink</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미지</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "승인",
            "approvalReason": "승인완료(비승인)",
            "chatbotDate": null,
            "messagebaseDate": "2024-05-17T17:48:07.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-06-03T15:16:31.000+09",
            "approvalDate": "2024-06-03T15:14:19.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ],
            "menus": [
                {
                    "buttonType": "tickets",
                    "weblink": "http://www.naver.com",
                    "feedinfoYn": "N"
                }
            ],
            "description": "테스트브랜드",
            "tel": "30000800",
            "categoryId": "EDU",
            "categoryName": "교육",
            "subCategoryId": "EDU007",
            "subCategoryName": "유학/연수",
            "categoryOpt": null,
            "zipCode": "55110",
            "roadAddress": "서울특별시",
            "detailAddress": "109-5",
            "email": "lng0415@naver.com",
            "webSiteUrl": "http://www.google.com",
            "brandFeedUrl": null,
            "initTab": "INFO",
            "initFeedItems": [],
            "templateColor": null,
            "bizInfoYn": "N",
            "bizInfoTitle": null,
            "bizInfoContent": null
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64329",
        "message": "Missing profile image"
    },
    "status": 400
}

{
    "error": {
        "code": "64332",
        "message": "brand profile file is only png"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 수정 승인 요청 취소

## Request

## 승인대기 중인 브랜드의 승인요청을 취소합니다.  <br>

> 승인대기 중인 브랜드의 승인요청을 취소합니다.  \
> \
> 브랜드 대표운영자 또는 운영자 권한이 있어야 승인요청 취소가 가능합니다.  \
> \
> 검수가 시작된 브랜드는 승인취소가 불가합니다.  \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 대표운영자, 운영자\*\*  \
> &#x20; \+ \*\*가능 상태 : 승인대기\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/corp/{personId}/brand/{brandId}/cancel":{"put":{"summary":"승인대기 중인 브랜드의 승인요청을 취소합니다.  \n","description":"승인대기 중인 브랜드의 승인요청을 취소합니다.  \n\n브랜드 대표운영자 또는 운영자 권한이 있어야 승인요청 취소가 가능합니다.  \n\n검수가 시작된 브랜드는 승인취소가 불가합니다.  \n  + **계정 권한 : 마스터, 매니저**  \n  + **브랜드 권한 : 대표운영자, 운영자**  \n  + **가능 상태 : 승인대기**  \n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="123">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>승인취소 된 브랜드 ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="83">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인취소 된 브랜드 ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 삭제

## Request

## 브랜드를 삭제합니다.<br>

> 브랜드를 삭제합니다.  \
> 브랜드 삭제를 위해서는 토큰 발급계정과 personId가 동일해야 하며 brandId에 대한 브랜드 대표운영자 권한이 있어야\
> 합니다.  \
> 승인을 받지 않은 '반려', '저장' 상태의 브랜드는 즉시 삭제 가능합니다.  \
> \*\*승인된 브랜드의 경우 등록된 발신번호, 템플릿을 먼저 삭제한 후 브랜드를 삭제해야 처리됩니다.\*\*  \
> &#x20; \+ \*\*계정 권한 : 마스터\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 대표운영자\*\*  \
> &#x20; \+ \*\*삭제 가능 상태 : 승인, 반려, 저장\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/corp/{personId}/brand/{brandId}":{"delete":{"summary":"브랜드를 삭제합니다.\n","description":"브랜드를 삭제합니다.  \n브랜드 삭제를 위해서는 토큰 발급계정과 personId가 동일해야 하며 brandId에 대한 브랜드 대표운영자 권한이 있어야\n합니다.  \n승인을 받지 않은 '반려', '저장' 상태의 브랜드는 즉시 삭제 가능합니다.  \n**승인된 브랜드의 경우 등록된 발신번호, 템플릿을 먼저 삭제한 후 브랜드를 삭제해야 처리됩니다.**  \n  + **계정 권한 : 마스터**  \n  + **브랜드 권한 : 대표운영자**  \n  + **삭제 가능 상태 : 승인, 반려, 저장**\n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>삭제한 브랜드 ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">**`result`**</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="85">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>삭제한 브랜드 ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 삭제 요청(미승인 이력)

## Request

## 마스터 계정을 이용하여 승인 이력이 없는 신규 개설 브랜드 삭제를 요청합니다.<br>

> 마스터 계정을 이용하여 승인 이력이 없는 해당 계정이 신규 개설한 브랜드 삭제를 요청합니다.  \
> \
> 정상적으로 승인요청된 브랜드는 \*\*승인대기\*\* 상태가 되므로 삭제가 불가합니다.\
> \
> &#x20; \+ \*\*사용 권한 계정 : 마스터\*\*\
> &#x20; \+ \*\*삭제 가능 상태 : 저장, 반려\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/corp/brand/{brandId}":{"delete":{"summary":"마스터 계정을 이용하여 승인 이력이 없는 신규 개설 브랜드 삭제를 요청합니다.\n","description":"마스터 계정을 이용하여 승인 이력이 없는 해당 계정이 신규 개설한 브랜드 삭제를 요청합니다.  \n\n정상적으로 승인요청된 브랜드는 **승인대기** 상태가 되므로 삭제가 불가합니다.\n\n  + **사용 권한 계정 : 마스터**\n  + **삭제 가능 상태 : 저장, 반려**\n","parameters":[{"$ref":"#/components/parameters/BrandId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>삭제한 브랜드 ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>삭제한 브랜드 ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 운영 권한 조회

## Request

## 브랜드에 등록된 운영 권한 정보를 조회합니다.<br>

> 브랜드에 등록된 운영 권한 정보를 조회합니다. 브랜드에 등록된 브랜드 대표운영자, 운영자, 권한 지정 대행사 정보를\
> 제공합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/corp/{personId}/brand/{brandId}/privilege":{"get":{"summary":"브랜드에 등록된 운영 권한 정보를 조회합니다.\n","description":"브랜드에 등록된 운영 권한 정보를 조회합니다. 브랜드에 등록된 브랜드 대표운영자, 운영자, 권한 지정 대행사 정보를\n제공합니다.  \n\n  + **계정 권한: 마스터, 매니저**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="122">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드의 권한 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="148">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="87">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>privilegeType</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>권한은 다음과 같이 구분됩니다.</p><ul><li>Manager : 브랜드 관리자(=마스터)</li><li>SubManager : 브랜드 부관리자(=마스터, 매니저)</li><li>Agency : 브랜드 대행사</li></ul></td></tr><tr><td><strong><code>id</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>마스터, 매니저 또는 대행사의 ID입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>권한 처리 상태를 표시합니다.</p><ul><li>Waiting : RCS Biz Center 웹에서 제공되는 기능인 '브랜드 운영권한 신청'을 이용하여 신청 후 대기 브랜드 관리자의 승인을 대기 중인 상태입니다. Waiting 상태의 대상은 POST를 이용하여 등록하면 승인이 되고 Ok 상태로 변경됩니다.</li><li>Processing : 권한 정보를 이통3사에 동기화 중인 경우 processing 상태로 표시됩니다. Processing 상태가 짧은 시간 동안 발생할 수 있으며 지속될 경우 RCS Biz Center에 문의하시기 바랍니다.</li><li>Ok : 권한 상태가 정상적인 경우 표시됩니다.</li></ul></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "privilegeType": "Manager",
            "id": "hong",
            "contracts": [],
            "status": "Ok"
        },
        {
            "privilegeType": "SubManager",
            "id": "hozzy59",
            "contracts": [],
            "status": "Ok"
        },
        {
            "privilegeType": "SubManager",
            "id": "hozzy123",
            "contracts": [],
            "status": "Ok"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 대표 운영자 권한 위임

## Request

## 브랜드 대표운영자 권한을 위임합니다.<br>

> 브랜드 대표운영자 권한을 지정된 마스터에게 위임합니다.  \
> \
> 브랜드 대표운영자 변경 시 위임전 대표운영자는 운영자로 변경됩니다.  \
> &#x20; \+ \*\*계정 권한 : 마스터\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegPrivilegeInfo":{"type":"object","description":"브랜드의 권한 정보 객체입니다.\n","required":["privilegeType","id"],"properties":{"privilegeType":{"type":"string","description":"권한은 다음과 같이 구분됩니다.  \n\n  - Manager : 대표운영자  \n  - SubManager : 운영자(기업의 마스터 또는 매니저)\n  - Agency : 운영자(대행사)\n","enum":["Agency","SubManager","Manager"]},"id":{"description":"maxLength: 20 - 마스터, 매니저 또는 대행사의 ID입니다.\n","type":"string","maxLength":20}}}}},"paths":{"/corp/{personId}/brand/{brandId}/privilege":{"put":{"summary":"브랜드 대표운영자 권한을 위임합니다.\n","description":"브랜드 대표운영자 권한을 지정된 마스터에게 위임합니다.  \n\n브랜드 대표운영자 변경 시 위임전 대표운영자는 운영자로 변경됩니다.  \n  + **계정 권한 : 마스터**  \n  + **브랜드 권한 : 브랜드 대표운영자**\n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"description":"- privilegeType이 Manager 만 허용되며 지정한 마스터 ID를 대표운영자로 설정합니다. \n","content":{"application/json":{"schema":{"properties":{"regPrivilege":{"$ref":"#/components/schemas/RegPrivilegeInfo"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="Manager권한" %}

```
{
    "regPrivileges": [
        {
            "privilegeType": "Manager",
            "id": "hong"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="122">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드의 권한 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="148">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="82">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>privilegeType</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>권한은 다음과 같이 구분됩니다.</p><ul><li>Manager : 브랜드 관리자(=마스터)</li><li>SubManager : 브랜드 부관리자(=마스터, 매니저)</li><li>Agency : 브랜드 대행사</li></ul></td></tr><tr><td><strong><code>id</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>마스터, 매니저 또는 대행사의 ID입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>권한 처리 상태를 표시합니다.</p><ul><li>Waiting : RCS Biz Center 웹에서 제공되는 기능인 '브랜드 운영권한 신청'을 이용하여 신청 후 대기 브랜드 관리자의 승인을 대기 중인 상태입니다. Waiting 상태의 대상은 POST를 이용하여 등록하면 승인이 되고 Ok 상태로 변경됩니다.</li><li>Processing : 권한 정보를 이통3사에 동기화 중인 경우 processing 상태로 표시됩니다. Processing 상태가 짧은 시간 동안 발생할 수 있으며 지속될 경우 RCS Biz Center에 문의하시기 바랍니다.</li><li>Ok : 권한 상태가 정상적인 경우 표시됩니다.</li></ul></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "privilegeType": "Manager",
            "id": "hong",
            "contracts": [],
            "status": "Ok"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64323",
        "message": "No changes"
    },
    "status": 400
}

{
    "error": {
        "code": "64349",
        "message": "hong has not qualified"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [privilegeType]"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 운영자 권한 부여

## Request

## 브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다.<br>

> 브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다.  \
> &#x20; \+ \*\*계정 권한 : 마스터\*\*\
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegPrivilegeInfo":{"type":"object","description":"브랜드의 권한 정보 객체입니다.\n","required":["privilegeType","id"],"properties":{"privilegeType":{"type":"string","description":"권한은 다음과 같이 구분됩니다.  \n\n  - Manager : 대표운영자  \n  - SubManager : 운영자(기업의 마스터 또는 매니저)\n  - Agency : 운영자(대행사)\n","enum":["Agency","SubManager","Manager"]},"id":{"description":"maxLength: 20 - 마스터, 매니저 또는 대행사의 ID입니다.\n","type":"string","maxLength":20}}}}},"paths":{"/corp/{personId}/brand/{brandId}/privilege":{"post":{"summary":"브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다.\n","description":"브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다.  \n  + **계정 권한 : 마스터**\n  + **브랜드 권한 : 브랜드 대표운영자**\n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"description":"+ privilegeType이 SubManager 인 경우, 소속된 기업 내 다른 마스터, 매니저 계정을 운영자로 지정할 수\n있습니다.  \n\n+ privilegeType이 Agency 인 경우, 별도의 RCS 발송 계약을 맺은 대행사를 운영자로 지정합니다.  \n","content":{"application/json":{"schema":{"properties":{"regPrivileges":{"type":"array","items":{"$ref":"#/components/schemas/RegPrivilegeInfo"}}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="SubManager 권한부여" %}

<pre><code><strong>{
</strong>    "regPrivileges": [
        {
            "privilegeType": "SubManager",
            "id": "lng04152"
        }
    ]
}
</code></pre>

{% endtab %}

{% tab title="Agency 권한부여" %}

```
{
    "regPrivileges": [
        {
            "privilegeType": "Agency",
            "id": "lng04152"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="122">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드의 권한 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="148">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>privilegeType</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>권한은 다음과 같이 구분됩니다.</p><ul><li>Manager : 브랜드 관리자(=마스터)</li><li>SubManager : 브랜드 부관리자(=마스터, 매니저)</li><li>Agency : 브랜드 대행사</li></ul></td></tr><tr><td><strong><code>id</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>마스터, 매니저 또는 대행사의 ID입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>권한 처리 상태를 표시합니다.</p><ul><li>Waiting : RCS Biz Center 웹에서 제공되는 기능인 '브랜드 운영권한 신청'을 이용하여 신청 후 대기 브랜드 관리자의 승인을 대기 중인 상태입니다. Waiting 상태의 대상은 POST를 이용하여 등록하면 승인이 되고 Ok 상태로 변경됩니다.</li><li>Processing : 권한 정보를 이통3사에 동기화 중인 경우 processing 상태로 표시됩니다. Processing 상태가 짧은 시간 동안 발생할 수 있으며 지속될 경우 RCS Biz Center에 문의하시기 바랍니다.</li><li>Ok : 권한 상태가 정상적인 경우 표시됩니다.</li></ul></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "privilegeType": "Manager",
            "id": "hong",
            "contracts": [],
            "status": "Ok"
        },
        {
            "privilegeType": "SubManager",
            "id": "hozzy59",
            "contracts": [],
            "status": "Ok"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64348",
        "message": "hozzy59 is already registered."
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [privilegeType]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [privilegeType], SubManager or Agency (case sensitive)"
    },
    "status": 400
}

{
    "error": {
        "code": "64346",
        "message": "user not found: hozzy59"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 운영 권한 삭제

## Request

## 브랜드 운영자 권한 중 지정한 대상을 삭제합니다.<br>

> 브랜드 운영자(마스터, 매니저), 운영자(대행사) 권한 중 지정한 대상을 삭제합니다.  \
> 대행사가 양방향 대행사인 경우, 권한 삭제 시 대행사가 연결된 양방향 대화방의 연결을 해지합니다.  \
> 브랜드 대표운영자는 삭제할 수 없으며 브랜드 대표운영자를 변경하고자 할 경우 PUT 메서드를 사용하여야 합니다.\
> &#x20; \+ \*\*계정 권한 : 마스터\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Id":{"name":"id","in":"path","description":"maxLength: 20 - 브랜드 운영자(마스터, 매니저) 또는 운영자(대행사) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true}}},"paths":{"/corp/{personId}/brand/{brandId}/privilege/{id}":{"delete":{"summary":"브랜드 운영자 권한 중 지정한 대상을 삭제합니다.\n","description":"브랜드 운영자(마스터, 매니저), 운영자(대행사) 권한 중 지정한 대상을 삭제합니다.  \n대행사가 양방향 대행사인 경우, 권한 삭제 시 대행사가 연결된 양방향 대화방의 연결을 해지합니다.  \n브랜드 대표운영자는 삭제할 수 없으며 브랜드 대표운영자를 변경하고자 할 경우 PUT 메서드를 사용하여야 합니다.\n  + **계정 권한 : 마스터**\n  + **브랜드 권한: 브랜드 대표운영자**\n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Id"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드의 권한 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="148">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="85">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>privilegeType</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>권한은 다음과 같이 구분됩니다.</p><ul><li>Manager : 브랜드 관리자(=마스터)</li><li>SubManager : 브랜드 부관리자(=마스터, 매니저)</li><li>Agency : 브랜드 대행사</li></ul></td></tr><tr><td><strong><code>id</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>마스터, 매니저 또는 대행사의 ID입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>권한 처리 상태를 표시합니다.</p><ul><li>Waiting : RCS Biz Center 웹에서 제공되는 기능인 '브랜드 운영권한 신청'을 이용하여 신청 후 대기 브랜드 관리자의 승인을 대기 중인 상태입니다. Waiting 상태의 대상은 POST를 이용하여 등록하면 승인이 되고 Ok 상태로 변경됩니다.</li><li>Processing : 권한 정보를 이통3사에 동기화 중인 경우 processing 상태로 표시됩니다. Processing 상태가 짧은 시간 동안 발생할 수 있으며 지속될 경우 RCS Biz Center에 문의하시기 바랍니다.</li><li>Ok : 권한 상태가 정상적인 경우 표시됩니다.</li></ul></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "privilegeType": "Manager",
            "id": "hong",
            "contracts": [],
            "status": "Ok"
        },
        {
            "privilegeType": "SubManager",
            "id": "hozzy59",
            "contracts": [],
            "status": "Ok"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방

이 문서는 메시지 대화방에 대한 API 정보를 안내합니다.


# 대화방 목록 조회

## Request

## 브랜드 내에 등록된 대화방 목록을 조회합니다.<br>

> 브랜드 내에 등록된 대화방(발신번호) 목록을 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/brand/{brandId}/chatbot":{"get":{"summary":"브랜드 내에 등록된 대화방 목록을 조회합니다.\n","description":"브랜드 내에 등록된 대화방(발신번호) 목록을 조회합니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방(발신번호) 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>대화방이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "07082245290",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "isMainNum": true,
            "subTitle": "대화방",
            "service": "a2p",
            "display": "01",
            "inputField": 1,
            "subDescr": "",
            "botAgencyId": null,
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인",
            "registerDate": "2024-06-18T09:42:21.000+09",
            "approvalDate": "2024-06-18T09:48:37.000+09",
            "updateDate": "2024-06-18T09:48:27.000+09",
            "registerId": "hong",
            "updateId": "hong"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 상세 조회

## Request

## 지정된 대화방(발신번호)의 상세 정보를 조회합니다.<br>

> 지정된 대화방(발신번호)의 상세 정보를 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/brand/{brandId}/chatbot/{chatbotId}":{"get":{"summary":"지정된 대화방(발신번호)의 상세 정보를 조회합니다.\n","description":"지정된 대화방(발신번호)의 상세 정보를 조회합니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방(발신번호) 상세 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>pagination</code></strong></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><strong><code>links</code></strong></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>대화방이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>rcsReply</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>1</td><td><p>service가 'chat' 이거나 양방향 대화방으로 설정하고자 한다면 반드시 '1'로 설정해야 합니다.</p><ul><li>0 : SMS MO 수신</li><li>1 : RCS Postback 수신</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 상태를 나타내는 필드입니다. 현재는 단일 값인 "published" 만 존재하며, 대행사나 기업에서 API를 통한 등록/수정은 제공하지 않습니다.</td></tr><tr><td><strong><code>searchWeight</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>검색 우선 순위로 사용자 단말에서 검색 시 검색 결과가 여러 개라면 이 값이 높은 순서로 보여집니다. 대행사나 기업에서 API를 통한 등록/수정은 제공하지 않습니다.</td></tr><tr><td><strong><code>webhook</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>양방향 대화방 서비스 중계사 webhook URL 정보이며 botAgencyId 지정 시 자동으로 등록됩니다.</td></tr><tr><td><strong><code>botTcPage</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>이용약관페이지 URL 입니다. 대행사나 기업에서 API를 통해 등록/수정은 제공하지 않습니다.</td></tr><tr><td><a href="#persistentmenu-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>persistentMenu</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>대화방메뉴 정보입니다.</td></tr></tbody></table>

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td>fileId</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td>url</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td>typeName</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td>fileName</td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">persistentMenu</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="176">필드명</th><th width="159">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td>postbackId</td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>메뉴에 자동 부여되는 고유ID이며, RBC 자동할당하므로 별도 입력이 불가합니다.</td></tr><tr><td>upPostbackId</td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>현재 메뉴가 속한 상위 메뉴 버튼의 Postback ID, RBC 자동할당하므로 별도 입력이 불가합니다.</td></tr><tr><td>type</td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>대화방 메뉴를 구성하는 메뉴버튼의 유형입니다.<br>RBC 개편 이후 하위메뉴(type menu)는 허용하지 않습니다.</p><ul><li>menu : 하위메뉴를 갖는 메뉴 버튼 (deprecated)</li><li>reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)</li><li>feed : 브랜드 소식 연결 버튼</li><li>action : RCS 액션 지정 버튼</li></ul></td></tr><tr><td>title</td><td>string</td><td align="center">25</td><td align="center">O</td><td></td><td>메뉴버튼에 표시되는 메뉴명입니다.</td></tr><tr><td>ordNo</td><td>number</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼 순서 값입니다.</td></tr><tr><td>autoReplyMsgId</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'reply' 인 경우, 자동응답메시지ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.</td></tr><tr><td>actionType</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다. 2022년 7월 28일 대화방 메뉴 정책 변경으로 dialerAction만 지정할 수 있습니다.</td></tr><tr><td>action</td><td>dialerAction</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

{% hint style="info" %}
[**버튼 Action 목록 Link (2023.12.14)**](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)
{% endhint %}

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "07082245290",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "isMainNum": true,
            "subTitle": "대화방",
            "service": "a2p",
            "display": "01",
            "inputField": 1,
            "subDescr": "",
            "botAgencyId": null,
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인",
            "registerDate": "2024-06-18T09:42:21.000+09",
            "approvalDate": "2024-06-18T09:48:37.000+09",
            "updateDate": "2024-06-18T09:48:27.000+09",
            "registerId": "hong",
            "updateId": "hong",
            "mediaUrl": [
                {
                    "fileId": "LT-common-Cni7oQ",
                    "fileName": "교육.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-Cni7oQ_1.png",
                    "typeName": "profile"
                }
            ],
            "approvalReason": "승인완료",
            "status": "published",
            "rcsReply": "1",
            "searchWeight": "512",
            "webhook": null,
            "botTcPage": "http://www.rcsbizcenter.com"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 등록

## Request

## 지정된 브랜드에 대화방(발신번호)을 등록합니다.<br>

> 지정된 브랜드에 대화방(발신번호)을 등록합니다.  \
> 대화방 등록 시 RBC 운영자 검수 승인 후 사용이 가능합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegChatbotInfo":{"description":"대화방(발신번호) 등록 정보 객체입니다.  \nObject 구성은 [RegChatbotInfo](#/RegChatbotInfo)를 참고하시기 바랍니다.\n","type":"object","properties":{"mdn":{"type":"string","maxLength":40,"description":"maxLength: 40 - 등록할 발신번호입니다. 국가번호는 제외하고 등록하며, 현재 정책적으로 휴대전화번호는 등록이 불가합니다.\n"},"subNum":{"type":"string","maxLength":40,"description":"maxLength: 40 - 회신번호 입니다. 발신번호(mdn)와 회신번호가 동일해야 합니다. 발신번호와 동일하게 설정됩니다.\n"},"subTitle":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대화방명입니다.\n"},"rcsReply":{"type":"string","enum":["0","1"],"description":"SMS MO 수신 0, RCS Postback 수신 1","default":"1"},"display":{"type":"string","enum":["11","10","01","00"],"default":"01","description":"대화방 전시 설정값 입니다. 설정하지 않을 경우 기본 '01'로 설정됩니다.  \n\n  + '11' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 전시  \n  + '10' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 비전시  \n  + '01' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 전시  \n  + '00' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 비전시  \n"},"inputField":{"type":"integer","description":"단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.  \n\n  + 0 : 비활성화  \n  + 1 : 활성화\n","enum":[0,1],"default":1},"subDescr":{"type":"string","description":"maxLength: 50 - 대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.  \n","maxLength":50},"saftyStatusYn":{"description":"안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.  \n\n  + Y : 안심마크 표시\n  + N : 안심마크 미표시\n","type":"string","enum":["Y","N"],"default":"Y"}},"required":["mdn","subTitle","rcsReply"]}}},"paths":{"/brand/{brandId}/chatbot":{"post":{"summary":"지정된 브랜드에 대화방(발신번호)을 등록합니다.\n","description":"지정된 브랜드에 대화방(발신번호)을 등록합니다.  \n대화방 등록 시 RBC 운영자 검수 승인 후 사용이 가능합니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"description":"대화방(발신번호) 등록시 통신서비스 이용증명원을 함께 업로드해야 합니다.\n","required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"subNumCertificate":{"description":"통신서비스 이용증명원 입니다.  \n\n입력한 발신번호와 통신서비스 이용증명원의 전화번호가 일치해야 발신번호 등록이 가능하며 최근 1개월 이내\n발급된 서류로 제출해야 합니다.  \n\n**파일형식 : jpg, png, pdf, tiff, zip (최대20MB)**\n","type":"object","format":"binary"},"chatbots":{"description":"등록할 대화방(발신번호) 정보를 최대 1000개까지 등록합니다.  \nObject 구성은 [RegChatbotInfo](#/RegChatbotInfo)를 참고하시기 바랍니다.\n","type":"object","properties":{"chatbots":{"type":"array","items":{"$ref":"#/components/schemas/RegChatbotInfo"},"maxItems":1000,"minItems":1}}}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body form data sample

{% tabs %}
{% tab title="chatbots" %}

```
'chatbots="{
  \"chatbots\": [
    {
      \"mdn\": \"15330000\",
      \"subNum\": \"15330000\",
      \"subTitle\": \"테스트대화방\",
      \"rcsReply\": \"0\",
      \"display\": \"01\",
      \"inputField\": \"1\",
      \"subDescr\": \"테스트용 대화방입니다.\",
      \"saftyStatusYn\": \"Y\"
    }
  ]
}"' \
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방(발신번호) 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong>groupId</strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>대화방이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "15330000",
            "brandId": "BR.u720xwadx0",
            "subNum": "15330000",
            "isMainNum": false,
            "subTitle": "테스트대화방",
            "service": "a2p",
            "display": "01",
            "inputField": 1,
            "subDescr": "테스트용 대화방입니다.",
            "botAgencyId": null,
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인대기",
            "registerDate": "2024-06-24T14:09:21.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-24T14:09:21.000+09",
            "registerId": "hong",
            "updateId": "hong"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64307",
        "message": "Missing MDN"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 승인 요청 취소

## Request

## 지정된 대화방(발신번호, 양방향ID)의 승인요청을 취소합니다.<br>

> 지정된 대화방(발신번호, 양방향ID)의 승인요청을 취소합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*  \
> \
> 각 상태별 취소 요청 동작은 다음과 같습니다.\
> &#x20;       \
> &#x20; \+ \*\*승인대기 : 저장 상태로 변경\*\*          \
> &#x20; \+ \*\*승인대기(수정) : 직전 승인 상태 및 데이터로 롤백\*\*        \
> &#x20; \+ \*\*반려(수정) : 직전 승인 상태 및 데이터로 롤백\*\*  \
> &#x20; \+ \*\*이외의 경우 에러 리턴\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/brand/{brandId}/chatbot/{chatbotId}/cancel":{"put":{"summary":"지정된 대화방(발신번호, 양방향ID)의 승인요청을 취소합니다.\n","description":"지정된 대화방(발신번호, 양방향ID)의 승인요청을 취소합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**  \n\n각 상태별 취소 요청 동작은 다음과 같습니다.\n        \n  + **승인대기 : 저장 상태로 변경**          \n  + **승인대기(수정) : 직전 승인 상태 및 데이터로 롤백**        \n  + **반려(수정) : 직전 승인 상태 및 데이터로 롤백**  \n  + **이외의 경우 에러 리턴**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td>result</td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방ID(=chatbotId)</td></tr><tr><td>code</td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td>status</td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td>desc</td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td>chatbotId</td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>대화방ID(=chatbotId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "chatbotId": "15330001"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64321",
        "message": "Invalid approval status"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 수정

## Request

## 지정된 대화방(발신번호)의 정보를 업데이트합니다.<br>

> 지정된 대화방(발신번호)의 정보를 업데이트합니다.  \
> \
> 저장, 반려, 승인 상태의 대화방(발신번호)만 수정이 가능하며, 대화방명이 변경되면 RBC 운영자의 검수를 받아야 합니다.    \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*수정 가능 상태 : 저장, 반려, 승인\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}},"schemas":{"RegChatbotInfo":{"description":"대화방(발신번호) 등록 정보 객체입니다.  \nObject 구성은 [RegChatbotInfo](#/RegChatbotInfo)를 참고하시기 바랍니다.\n","type":"object","properties":{"mdn":{"type":"string","maxLength":40,"description":"maxLength: 40 - 등록할 발신번호입니다. 국가번호는 제외하고 등록하며, 현재 정책적으로 휴대전화번호는 등록이 불가합니다.\n"},"subNum":{"type":"string","maxLength":40,"description":"maxLength: 40 - 회신번호 입니다. 발신번호(mdn)와 회신번호가 동일해야 합니다. 발신번호와 동일하게 설정됩니다.\n"},"subTitle":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대화방명입니다.\n"},"rcsReply":{"type":"string","enum":["0","1"],"description":"SMS MO 수신 0, RCS Postback 수신 1","default":"1"},"display":{"type":"string","enum":["11","10","01","00"],"default":"01","description":"대화방 전시 설정값 입니다. 설정하지 않을 경우 기본 '01'로 설정됩니다.  \n\n  + '11' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 전시  \n  + '10' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 비전시  \n  + '01' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 전시  \n  + '00' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 비전시  \n"},"inputField":{"type":"integer","description":"단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.  \n\n  + 0 : 비활성화  \n  + 1 : 활성화\n","enum":[0,1],"default":1},"subDescr":{"type":"string","description":"maxLength: 50 - 대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.  \n","maxLength":50},"saftyStatusYn":{"description":"안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.  \n\n  + Y : 안심마크 표시\n  + N : 안심마크 미표시\n","type":"string","enum":["Y","N"],"default":"Y"}},"required":["mdn","subTitle","rcsReply"]}}},"paths":{"/brand/{brandId}/chatbot/{chatbotId}":{"put":{"summary":"지정된 대화방(발신번호)의 정보를 업데이트합니다.\n","description":"지정된 대화방(발신번호)의 정보를 업데이트합니다.  \n\n저장, 반려, 승인 상태의 대화방(발신번호)만 수정이 가능하며, 대화방명이 변경되면 RBC 운영자의 검수를 받아야 합니다.    \n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n  + **수정 가능 상태 : 저장, 반려, 승인**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"subNumCertificate":{"description":"통신서비스 이용증명원 입니다.  \n\n입력한 발신번호와 통신서비스 이용증명원의 전화번호가 일치해야 발신번호 등록이 가능하며 최근 1개월 이내\n발급된 서류로 제출해야 합니다.  \n\n**파일형식 : jpg, png, pdf, tiff, zip (최대20MB)**\n","type":"object","format":"binary"},"chatbot":{"$ref":"#/components/schemas/RegChatbotInfo"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body form data sample

{% tabs %}
{% tab title="chatbot" %}

```
'chatbot="{
  \"mdn\": \"15330003\",
  \"subNum\": \"15330003\",
  \"subTitle\": \"테스트대화방수\",
  \"rcsReply\": \"0\",
  \"display\": \"01\",
  \"inputField\": \"1\",
  \"subDescr\": \"테스트용 대화방입니다.\",
  \"saftyStatusYn\": \"Y\"
}"' \
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방(발신번호) 상세 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>대화방이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>rcsReply</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>1</td><td><p>service가 'chat' 이거나 양방향 대화방으로 설정하고자 한다면 반드시 '1'로 설정해야 합니다.</p><ul><li>0 : SMS MO 수신</li><li>1 : RCS Postback 수신</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 상태를 나타내는 필드입니다. 현재는 단일 값인 "published" 만 존재하며, 대행사나 기업에서 API를 통한 등록/수정은 제공하지 않습니다.</td></tr><tr><td><strong><code>searchWeight</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>검색 우선 순위로 사용자 단말에서 검색 시 검색 결과가 여러 개라면 이 값이 높은 순서로 보여집니다. 대행사나 기업에서 API를 통한 등록/수정은 제공하지 않습니다.</td></tr><tr><td><strong><code>webhook</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>양방향 대화방 서비스 중계사 webhook URL 정보이며 botAgencyId 지정 시 자동으로 등록됩니다.</td></tr><tr><td><strong><code>botTcPage</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>이용약관페이지 URL 입니다. 대행사나 기업에서 API를 통해 등록/수정은 제공하지 않습니다.</td></tr><tr><td><a href="#persistentmenu-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>persistentMenu</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>대화방메뉴 정보입니다.</td></tr></tbody></table>

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>typeName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">persistentMenu</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="176">필드명</th><th width="159">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>postbackId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>메뉴에 자동 부여되는 고유ID이며, RBC 자동할당하므로 별도 입력이 불가합니다.</td></tr><tr><td><strong><code>upPostbackId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>현재 메뉴가 속한 상위 메뉴 버튼의 Postback ID, RBC 자동할당하므로 별도 입력이 불가합니다.</td></tr><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>대화방 메뉴를 구성하는 메뉴버튼의 유형입니다.<br>RBC 개편 이후 하위메뉴(type menu)는 허용하지 않습니다.</p><ul><li>menu : 하위메뉴를 갖는 메뉴 버튼 (deprecated)</li><li>reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)</li><li>feed : 브랜드 소식 연결 버튼</li><li>action : RCS 액션 지정 버튼</li></ul></td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center">25</td><td align="center">O</td><td></td><td>메뉴버튼에 표시되는 메뉴명입니다.</td></tr><tr><td><strong><code>ordNo</code></strong></td><td>number</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼 순서 값입니다.</td></tr><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'reply' 인 경우, 자동응답메시지ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.</td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다. 2022년 7월 28일 대화방 메뉴 정책 변경으로 dialerAction만 지정할 수 있습니다.</td></tr><tr><td><strong><code>action</code></strong></td><td>dialerAction</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

{% hint style="info" %}
[**버튼 Action 목록 Link (2023.12.14)**](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)
{% endhint %}

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "15330003",
            "brandId": "BR.u720xwadx0",
            "subNum": "15330003",
            "isMainNum": false,
            "subTitle": "테스트대화방수정",
            "service": "a2p",
            "display": "01",
            "inputField": 1,
            "subDescr": "테스트용 대화방입니다.",
            "botAgencyId": null,
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인대기(수정)",
            "registerDate": "2024-06-25T15:00:23.000+09",
            "approvalDate": "2024-06-25T14:58:02.000+09",
            "updateDate": "2024-06-25T15:00:23.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "mediaUrl": [
                {
                    "fileId": "LT-common-Cni7oQ",
                    "fileName": "교육.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-Cni7oQ_1.png",
                    "typeName": "profile"
                }
            ],
            "approvalReason": "승인완료",
            "status": "published",
            "rcsReply": "0",
            "searchWeight": "512",
            "webhook": null,
            "botTcPage": "http://www.rcsbizcenter.com"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64323",
        "message": "No changes"
    },
    "status": 400
}

{
    "error": {
        "code": "64307",
        "message": "Missing MDN"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 삭제

## Request

## 대화방(발신번호)을 삭제합니다.<br>

> 대화방(발신번호)을 삭제합니다.\
> 양방향 대화방의 회신번호로 등록된 발신번호 삭제 시, 대상 양방향 대화방도 함께 삭제 처리 됩니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*삭제 가능 상태 : 저장, 반려, 승인\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/brand/{brandId}/chatbot/{chatbotId}":{"delete":{"summary":"대화방(발신번호)을 삭제합니다.\n","description":"대화방(발신번호)을 삭제합니다.\n양방향 대화방의 회신번호로 등록된 발신번호 삭제 시, 대상 양방향 대화방도 함께 삭제 처리 됩니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n  + **삭제 가능 상태 : 저장, 반려, 승인**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방Id(=chatbotId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="183">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>대화방Id(=chatbotId)</td></tr><tr><td><strong><code>releatedChatbots</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>삭제된 chatbotId를 회신번호로 사용하는 함께 삭제된 양방향대화방 리스트</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "chatbotId": "15330003"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방ID 등록 가능 여부 조회

## Request

## 대화방ID 등록 가능 여부를 조회 합니다.<br>

> 대화방ID 등록 가능 여부를 조회 합니다. 등록 가능한 경우 200 OK 응답으로 리턴되며, 대화방ID 형식 부적합, 이미 등록된\
> 대화방ID 등  등록이 불가능한 경우 400 Error 리턴됩니다.\
> \
> &#x20; \+ 발신번호 조회 시에는 숫자만 입력해야 합니다.  \
> &#x20;   \- 발신번호 조회 시 숫자 이외 '-'을 삽입할 경우 양방향 대화방ID로 인식될 수 있으므로 주의해 주세요.  \
> &#x20; \+ 양방향 대화방ID 조회 시에는 영문, 숫자, '-', '\_' 사용이 가능합니다.  \
> &#x20;   \- 양방향 대화방ID 영문 대문자는 소문자로 변환됩니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/usableQuery/chatbotId/{chatbotId}":{"get":{"summary":"대화방ID 등록 가능 여부를 조회 합니다.\n","description":"대화방ID 등록 가능 여부를 조회 합니다. 등록 가능한 경우 200 OK 응답으로 리턴되며, 대화방ID 형식 부적합, 이미 등록된\n대화방ID 등  등록이 불가능한 경우 400 Error 리턴됩니다.\n\n  + 발신번호 조회 시에는 숫자만 입력해야 합니다.  \n    - 발신번호 조회 시 숫자 이외 '-'을 삽입할 경우 양방향 대화방ID로 인식될 수 있으므로 주의해 주세요.  \n  + 양방향 대화방ID 조회 시에는 영문, 숫자, '-', '_' 사용이 가능합니다.  \n    - 양방향 대화방ID 영문 대문자는 소문자로 변환됩니다.  \n\n  + **계정 권한: 대행사**  \n","parameters":[{"$ref":"#/components/parameters/ChatbotId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-object"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>대화방Id(=chatbotId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - object

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방Id(=chatbotId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": "registration available",
    "result": {
        "chatbotId": "121251"
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64373",
        "message": "Invalid chatbotId format"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 공통포맷

이 문서는 템플릿 양식에 대한 API 정보를 안내합니다.


# 공통포맷 조회

## Request

## 이통사가 기본 제공하는 공통템플릿을 조회합니다.<br>

> 이통사가 기본 제공하는 공통템플릿을 조회합니다.  \
> 공통템플릿은 SMS, LMS, MMS와 양방향 대화방용 CHAT 상품으로 구성되어 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"ProductCode":{"name":"productCode","in":"query","description":"리치카드 메시지 유형 구분값 입니다.","schema":{"type":"string","enum":["sms","lms","mms","chat"]}},"CardType":{"name":"cardType","in":"query","description":"MMS에서 제공되는 메시지 카드 형태 구분값 입니다.","schema":{"type":"string","enum":["standalone","standalone media top","standalone horizontal","carousel medium","carousel small","Highlighted Image n Title","Highlighted Image","Thumbnail","SNS","format","formatBr"]}},"BizService":{"name":"bizService","in":"query","schema":{"type":"string","enum":["승인","입금","출금","출고","주문","배송","예약","회원가입","인증"]},"description":"서비스 내 업무 유형별 제공되는 항목으로 초기 텍스트 템플릿 한정 구분자 입니다.  \n\n이미지템플릿, LMS템플릿, 공통 포맷은 해당되지 않습니다.\n","deprecated":true},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/messagebase/common":{"get":{"summary":"이통사가 기본 제공하는 공통템플릿을 조회합니다.\n","description":"이통사가 기본 제공하는 공통템플릿을 조회합니다.  \n공통템플릿은 SMS, LMS, MMS와 양방향 대화방용 CHAT 상품으로 구성되어 있습니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**\n","parameters":[{"$ref":"#/components/parameters/ProductCode"},{"$ref":"#/components/parameters/CardType"},{"$ref":"#/components/parameters/BizService"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>Messagebase 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="89">기본값</th><th>설명</th></tr></thead><tbody><tr><td>groupId</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td>messagebaseId</td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>템플릿 ID</td></tr><tr><td>tmpltName</td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>템플릿 등록시 입력된 템플릿 명칭입니다.</td></tr><tr><td>messagebaseformId</td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>템플릿의 원형인 템플릿 양식 ID 입니다.</td></tr><tr><td>brandId</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿이 등록되어 있는 브랜드 ID 입니다. 공통으로 사용하는 템플릿인 경우 'common'으로 표시됩니다.</td></tr><tr><td>status</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>템플릿의 상태를 표시합니다.</p><ul><li>ready : 사용</li><li>pause : 사용중지</li></ul></td></tr><tr><td>approvalResult</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>템플릿의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 템플릿 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 템플릿은 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 템플릿 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 템플릿 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 템플릿은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 템플릿 변경 승인요청 직후 검수 이전 상태입니다.</li><li>검수시작(수정) : 승인된 템플릿 변경으로 승인요청된 템플릿 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 템플릿 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다</li></ul></td></tr><tr><td>approvalReason</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td>registerDate</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록일시</td></tr><tr><td>approvalDate</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 승인일시</td></tr><tr><td>updateDate</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 수정일시</td></tr><tr><td>registerId</td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>템플릿 등록 계정 ID</td></tr><tr><td>updateId</td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>템플릿 수정 계정 ID</td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td>total</td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td>offset</td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td>limit</td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td>prev</td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td>next</td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "OL00000003",
            "tmpltName": "문단형",
            "messagebaseformId": "OL00000003",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2023-10-24T09:33:06.000+09",
            "approvalDate": "2023-10-24T09:33:07.000+09",
            "updateDate": "2023-10-24T09:33:06.000+09",
            "registerId": "rd135",
            "updateId": null
        },
        {
            "groupId": null,
            "messagebaseId": "OL00000002",
            "tmpltName": "기본형 타이틀 강조",
            "messagebaseformId": "OL00000002",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2023-10-24T09:32:55.000+09",
            "approvalDate": "2023-10-24T09:32:56.000+09",
            "updateDate": "2023-10-24T09:32:55.000+09",
            "registerId": "rd135",
            "updateId": null
        },
        {
            "groupId": null,
            "messagebaseId": "OL00000001",
            "tmpltName": "기본형",
            "messagebaseformId": "OL00000001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2023-10-24T09:32:46.000+09",
            "approvalDate": "2023-10-24T09:32:47.000+09",
            "updateDate": "2023-10-24T09:32:46.000+09",
            "registerId": "rd135",
            "updateId": null
        },
        {
            "groupId": null,
            "messagebaseId": "OM00000003",
            "tmpltName": "아이템 상세형",
            "messagebaseformId": "OM00000003",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2024-04-16T11:17:40.000+09",
            "approvalDate": "2024-04-16T11:17:42.000+09",
            "updateDate": "2024-04-16T11:17:42.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OM00000002",
            "tmpltName": "기본형 타이틀 강조형",
            "messagebaseformId": "OM00000002",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2023-10-24T09:32:22.000+09",
            "approvalDate": "2023-10-24T09:32:23.000+09",
            "updateDate": "2023-10-24T09:32:23.000+09",
            "registerId": "rd135",
            "updateId": "rd135"
        },
        {
            "groupId": null,
            "messagebaseId": "OM00000001",
            "tmpltName": "기본형",
            "messagebaseformId": "OM00000001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2023-10-24T09:32:10.000+09",
            "approvalDate": "2023-10-24T09:32:11.000+09",
            "updateDate": "2023-10-24T09:32:11.000+09",
            "registerId": "rd135",
            "updateId": "rd135"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwShS0200",
            "tmpltName": "슬라이드형(Small,2장)",
            "messagebaseformId": "CMwShS0200",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2022-08-30T17:52:43.000+09",
            "approvalDate": "2022-08-30T17:52:50.000+09",
            "updateDate": "2022-08-30T17:52:50.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwMhM0200",
            "tmpltName": "슬라이드형(Medium,2장)",
            "messagebaseformId": "CMwMhM0200",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2022-08-30T17:51:39.000+09",
            "approvalDate": "2022-08-30T17:52:02.000+09",
            "updateDate": "2022-08-30T17:52:02.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OMSNSH0001",
            "tmpltName": "SNS형 (중간버튼)",
            "messagebaseformId": "OMSNSH0001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2022-06-23T19:28:40.000+09",
            "approvalDate": "2022-06-27T15:15:25.000+09",
            "updateDate": "2022-10-13T18:27:05.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OMSNSS0001",
            "tmpltName": "SNS형",
            "messagebaseformId": "OMSNSS0001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2022-06-23T19:23:23.000+09",
            "approvalDate": "2022-06-27T15:15:02.000+09",
            "updateDate": "2022-10-13T18:26:44.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OMTBNH0001",
            "tmpltName": "썸네일형 (가로)",
            "messagebaseformId": "OMTBNH0001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2022-06-23T19:18:57.000+09",
            "approvalDate": "2022-06-23T19:19:09.000+09",
            "updateDate": "2022-10-13T18:26:33.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OMTBNV0001",
            "tmpltName": "썸네일형 (세로)",
            "messagebaseformId": "OMTBNV0001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2022-06-23T19:11:21.000+09",
            "approvalDate": "2022-06-23T19:13:05.000+09",
            "updateDate": "2022-10-13T18:26:16.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OMHIMS0001",
            "tmpltName": "이미지 강조형 (1:1)",
            "messagebaseformId": "OMHIMS0001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2022-06-23T19:02:05.000+09",
            "approvalDate": "2022-06-23T19:02:14.000+09",
            "updateDate": "2022-10-13T18:25:59.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OMHIMV0001",
            "tmpltName": "이미지 강조형 (3:4)",
            "messagebaseformId": "OMHIMV0001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2022-06-23T18:57:45.000+09",
            "approvalDate": "2022-06-23T18:57:56.000+09",
            "updateDate": "2022-10-13T18:25:46.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OMHITS0001",
            "tmpltName": "이미지 & 타이틀 강조형 (1:1)",
            "messagebaseformId": "OMHITS0001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2022-06-23T18:52:57.000+09",
            "approvalDate": "2022-06-23T18:53:22.000+09",
            "updateDate": "2022-10-13T18:25:25.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "OMHITV0001",
            "tmpltName": "이미지 & 타이틀 강조형 (3:4)",
            "messagebaseformId": "OMHITV0001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2022-06-23T18:37:26.000+09",
            "approvalDate": "2022-06-23T18:37:39.000+09",
            "updateDate": "2022-10-13T18:22:43.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwShS0600",
            "tmpltName": "슬라이드형(Small,6장)",
            "messagebaseformId": "CCwShS0600",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:10:23.000+09",
            "approvalDate": "2021-09-30T15:10:32.000+09",
            "updateDate": "2021-09-30T15:10:32.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwShS0500",
            "tmpltName": "슬라이드형(Small,5장)",
            "messagebaseformId": "CCwShS0500",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:10:05.000+09",
            "approvalDate": "2021-09-30T15:10:14.000+09",
            "updateDate": "2021-09-30T15:10:14.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwShS0400",
            "tmpltName": "슬라이드형(Small,4장)",
            "messagebaseformId": "CCwShS0400",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:09:45.000+09",
            "approvalDate": "2021-09-30T15:09:55.000+09",
            "updateDate": "2021-09-30T15:09:55.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwShS0300",
            "tmpltName": "슬라이드형(Small,3장)",
            "messagebaseformId": "CCwShS0300",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:08:39.000+09",
            "approvalDate": "2021-09-30T15:08:48.000+09",
            "updateDate": "2021-09-30T15:08:48.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwShS0200",
            "tmpltName": "슬라이드형(Small,2장)",
            "messagebaseformId": "CCwShS0200",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:08:06.000+09",
            "approvalDate": "2021-09-30T15:08:14.000+09",
            "updateDate": "2021-09-30T15:08:14.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwMhM0600",
            "tmpltName": "슬라이드형(Medium,6장)",
            "messagebaseformId": "CCwMhM0600",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:07:36.000+09",
            "approvalDate": "2021-09-30T15:07:46.000+09",
            "updateDate": "2021-09-30T15:07:46.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwMhM0500",
            "tmpltName": "슬라이드형(Medium,5장)",
            "messagebaseformId": "CCwMhM0500",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:07:11.000+09",
            "approvalDate": "2021-09-30T15:07:22.000+09",
            "updateDate": "2021-09-30T15:07:22.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwMhM0400",
            "tmpltName": "슬라이드형(Medium,4장)",
            "messagebaseformId": "CCwMhM0400",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:06:46.000+09",
            "approvalDate": "2021-09-30T15:06:59.000+09",
            "updateDate": "2021-09-30T15:06:59.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwMhM0300",
            "tmpltName": "슬라이드형(Medium,3장)",
            "messagebaseformId": "CCwMhM0300",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:06:15.000+09",
            "approvalDate": "2021-09-30T15:06:30.000+09",
            "updateDate": "2021-09-30T15:06:30.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CCwMhM0200",
            "tmpltName": "슬라이드형(Medium,2장)",
            "messagebaseformId": "CCwMhM0200",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:03:11.000+09",
            "approvalDate": "2021-09-30T15:05:41.000+09",
            "updateDate": "2021-09-30T15:05:41.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "SCwThM00",
            "tmpltName": "세로형(Medium)",
            "messagebaseformId": "SCwThM00",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:02:43.000+09",
            "approvalDate": "2021-09-30T15:02:51.000+09",
            "updateDate": "2021-09-30T15:02:51.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "SCwThT00",
            "tmpltName": "세로형(Tall)",
            "messagebaseformId": "SCwThT00",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:02:20.000+09",
            "approvalDate": "2021-09-30T15:02:30.000+09",
            "updateDate": "2021-09-30T15:02:30.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "SCL00000",
            "tmpltName": "텍스트 카드",
            "messagebaseformId": "SCL00000",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2021-09-30T15:01:46.000+09",
            "approvalDate": "2021-09-30T15:01:59.000+09",
            "updateDate": "2021-09-30T15:01:59.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "SCS00000",
            "tmpltName": "기본 말풍선",
            "messagebaseformId": "SCS00000",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2021-09-30T09:39:26.000+09",
            "approvalDate": "2021-09-30T15:00:40.000+09",
            "updateDate": "2021-09-30T09:39:26.000+09",
            "registerId": null,
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwMhM0300",
            "tmpltName": "슬라이드형(Medium,3장)",
            "messagebaseformId": "CMwMhM0300",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:09:09.000+09",
            "updateDate": "2020-04-08T12:32:01.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwMhM0400",
            "tmpltName": "슬라이드형(Medium,4장)",
            "messagebaseformId": "CMwMhM0400",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:08:50.000+09",
            "updateDate": "2020-04-08T12:33:39.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwMhM0500",
            "tmpltName": "슬라이드형(Medium,5장)",
            "messagebaseformId": "CMwMhM0500",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:08:34.000+09",
            "updateDate": "2020-04-08T12:34:05.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwMhM0600",
            "tmpltName": "슬라이드형(Medium,6장)",
            "messagebaseformId": "CMwMhM0600",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:08:17.000+09",
            "updateDate": "2020-04-08T12:34:53.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwShS0300",
            "tmpltName": "슬라이드형(Small,3장)",
            "messagebaseformId": "CMwShS0300",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:10:25.000+09",
            "updateDate": "2020-04-08T12:35:26.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwShS0400",
            "tmpltName": "슬라이드형(Small,4장)",
            "messagebaseformId": "CMwShS0400",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:10:08.000+09",
            "updateDate": "2020-04-08T12:36:23.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwShS0500",
            "tmpltName": "슬라이드형(Small,5장)",
            "messagebaseformId": "CMwShS0500",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:09:52.000+09",
            "updateDate": "2020-04-08T12:36:44.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "CMwShS0600",
            "tmpltName": "슬라이드형(Small,6장)",
            "messagebaseformId": "CMwShS0600",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:09:34.000+09",
            "updateDate": "2020-04-08T12:37:22.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "SL000000",
            "tmpltName": "LMS",
            "messagebaseformId": "SL000000",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:06:21.000+09",
            "updateDate": "2021-09-03T11:11:03.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "SMwThM00",
            "tmpltName": "세로형(Medium)",
            "messagebaseformId": "SMwThM00",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:07:37.000+09",
            "updateDate": "2021-04-12T10:53:57.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "SMwThT00",
            "tmpltName": "세로형(Tall)",
            "messagebaseformId": "SMwThT00",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:07:54.000+09",
            "updateDate": "2020-04-08T12:28:26.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        },
        {
            "groupId": null,
            "messagebaseId": "SS000000",
            "tmpltName": "SMS",
            "messagebaseformId": "SS000000",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:06:39.000+09",
            "updateDate": "2020-04-08T12:25:26.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 42
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 공통포맷 상세 조회

## Request

## 이통사가 기본 제공하는 공통템플릿 별 상세 내용을 조회합니다.<br>

> 이통사가 기본 제공하는 공통템플릿 별 상세 내용을 조회합니다.  \
> 상품별 SMS, LMS, MMS, CHAT용 세부 정보를 조회할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"MessagebaseId":{"name":"messagebaseId","in":"path","schema":{"type":"string"},"required":true,"description":"messagebase ID Path parameter 입니다."}}},"paths":{"/messagebase/common/{messagebaseId}":{"get":{"summary":"이통사가 기본 제공하는 공통템플릿 별 상세 내용을 조회합니다.\n","description":"이통사가 기본 제공하는 공통템플릿 별 상세 내용을 조회합니다.  \n상품별 SMS, LMS, MMS, CHAT용 세부 정보를 조회할 수 있습니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n","parameters":[{"$ref":"#/components/parameters/MessagebaseId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>Messagebase 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="212">필드명</th><th width="145">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="97">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>템플릿 ID</td></tr><tr><td><strong><code>tmpltName</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>템플릿 등록시 입력된 템플릿 명칭입니다.</td></tr><tr><td><strong><code>messagebaseformId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>템플릿의 원형인 템플릿 양식 ID 입니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>템플릿이 등록되어 있는 브랜드 ID 입니다. 공통으로 사용하는 템플릿인 경우 'common'으로 표시됩니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿의 상태를 표시합니다.<br>ready : 사용 pause : 사용중지</td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>템플릿의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 템플릿 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 템플릿은 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 템플릿 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 템플릿 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 템플릿은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 템플릿 변경 승인요청 직후 검수 이전 상태입니다.</li><li>검수시작(수정) : 승인된 템플릿 변경으로 승인요청된 템플릿 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 템플릿 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>템플릿 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>템플릿 수정 계정 ID</td></tr><tr><td><strong><code>productCode</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>메시지 상품 종류 구분값입니다.<br>"sms", "lms", "mms", "tmplt", "itmpl"</td></tr><tr><td><strong><code>spec</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃 구조가 리치카드인지 오픈리치카드인지 구분합니다.</p><p>"richcard", "openrichcard"<br><br>AOS/iOS 26 통합 지원 규격이 추가되었습니다.<br>"richcardPlus"</p></td></tr><tr><td><strong><code>cardType</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td><p>카드종류를 구분합니다. 향후 추가될 수 있습니다.</p><ul><li>standalone</li><li>standalone horizontal</li><li>standalone media top - carousel</li><li>carousel medium</li><li>carousel small</li><li>Highlighted Image n Title</li><li>Highlighted Image</li><li>Thumbnail</li><li>SNS</li><li>Description</li><li>Cell</li><li>Free</li></ul></td></tr><tr><td><strong><code>agencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>템플릿을 대행사가 등록한 경우, 등록한 대행사ID 입니다.</td></tr><tr><td><strong><code>inputText</code></strong></td><td>string</td><td align="center">300</td><td align="center"></td><td></td><td>정보성 텍스트 템플릿 서술(Description)인 경우, 템플릿 등록시 입력한 원본 문장을 제공합니다.</td></tr><tr><td><strong><code>attribute</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>통계용 속성 정보 제공 목적의 필드이며, messagebaseform의 [bizCondition, bizCategory, bizService] 로 구성된 배열입니다.</td></tr><tr><td><a href="#guideinfo-object"><mark style="color:blue;"><strong><code>guideInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 작성에 필요한 가이드 정보를 제공하기 위하여 양식 정의 시 포함되는 정보입니다. 리치카드의 경우 messagebaseInfo에서 제공됩니다.</td></tr><tr><td><a href="#policyinfo-object"><mark style="color:blue;"><strong><code>policyInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>리치카드, 오픈리치카드에 포함된 content(title, description, media, button) 에 대한 검증 정책 저장을 위한 객체입니다.</td></tr><tr><td><a href="#params-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>params</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>템플릿의 개별 파라미터를 검수하기 위한 대상 파라미터 정보 객체입니다. 크기 관련 필드는 &#x3C;=0 인 경우 체크하지 않습니다.</td></tr><tr><td><a href="#files-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>files</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 템플릿용 파일 등록 정보입니다.</td></tr><tr><td><strong><code>formattedString</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>GSMA 및 TTA RCS 규격이며 JSON 형식으로 정의된 템플릿의 레이아웃 데이터입니다.</td></tr></tbody></table>

{% hint style="info" %}
GSMA RCC.07-v11.0 참조\
<https://www.gsma.com/solutions-and-impact/technologies/networks/wp-content/uploads/2019/10/RCC.07-v11.0.pdf>
{% endhint %}

{% hint style="info" %}
TTAK.KO-06.0410/R7 참조

<https://committee.tta.or.kr/data/standard_view.jsp?secondDepthCode=PG1105&firstDepthCode=TC011&pk_num=TTAK.KO-06.0410/R7&commit_code=PG1105>
{% endhint %}

### <mark style="color:blue;">guideInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="111">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>maxLineCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>max 라인수</td></tr><tr><td><strong><code>maxDisplayText</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼명 글자수</td></tr><tr><td><strong><code>maxDescriptionSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>카드별 max 본문 글자수</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 권고 가로 사이즈 단위는 Pixel</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 권고 세로 사이즈 단위는 Pixel</td></tr><tr><td><a href="#detailinfo-object"><mark style="color:blue;"><strong><code>detailInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td><p>리치카드 메시지 상품별 1라인당 글자수, 타이틀 라인수 및 버튼 수에 따라 메시지가 잘려 보이지 않는 최대 라인수 정보를 제공합니다.</p><p>메시지가 수신된 단말에 따라 상이할 수 있으나 리치카드 RCS메시지 발송 시 권장사항으로 참고하시기 바랍니다.</p><p>LMS와 MMS 12종 총 13종에 대해 개별 제공됩니다.</p></td></tr></tbody></table>

### <mark style="color:blue;">detailInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>productCardType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>상품 카드 종류</td></tr><tr><td><strong><code>releaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>정보 제공 일자(내용 수정시 일시 변경)</td></tr><tr><td><strong><code>summary</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>요약 정보</td></tr><tr><td><strong><code>charactersPerLine</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>각 항목 별 권장 라인당 글자수</td></tr><tr><td><strong><code>combinations</code></strong></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>디스크립션 권장 라인수 조합</td></tr></tbody></table>

### <mark style="color:blue;">policyInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="224">필드명</th><th width="102">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="88">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonsAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>MaaP FE /message의 buttons 사용 유무</p><ul><li>true : buttons 필드 사용</li><li>false : buttons 에 값이 들어오면 실패 처리</li></ul></td></tr><tr><td><strong><code>adHeaderAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>header에 광고 인입 허가 여부</p><ul><li>true : 광고인입 허용(MaaP FE /message의 header 체크안함)</li><li>false : 광고인입 불허(MaaP FE /message이 header가 1(광고) 이면 실패 처리)</li></ul></td></tr><tr><td><strong><code>adBodyAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>광고 문구 허용 여부</p><ul><li>true : 본문 광고 문구를 체크하지 않음.</li><li>false : 본문이 "(광고)"로 시작하면 실패 처리</li></ul></td></tr><tr><td><strong><code>cardCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>카드 개수</td></tr><tr><td><strong><code>maxTitleSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>개별 타이틀 글자 최대 수. 사용하지 않음.</td></tr><tr><td><strong><code>maxButtonCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼 최대 개수</td></tr><tr><td><strong><code>maxDescriptionSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td><ul><li>RichCard인 경우(Carousel포함) Description들의 글자수 총합.</li><li>OpenRichCard인 경우 변수부 글자수 총합. &#x3C;=0 인 경우 사용하지 않음.</li></ul></td></tr><tr><td><strong><code>maxMediaSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>Byte단위 미디어 크기 총합의 최대 크기, &#x3C;=0 인 경우 사용하지 않음.</td></tr></tbody></table>

### <mark style="color:blue;">params</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="155">필드명</th><th width="152">타입</th><th width="87" align="center">길이</th><th width="108" align="center">필수여부</th><th width="82">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>param</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>검수 파라미터명. (영문, 한글, 숫자, '_' 만 사용)</td></tr><tr><td><strong><code>isMandatory</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>필수여부.</p><ul><li>true인 경우 중계사에서 메시지 전송 요청 시 해당 필드가 없는 경우 MaaP FE에서 실패처리한다.</li><li>false인 경우는 해당 필드가 없는 경우도 메시지 전송이 되도록 MaaP FE에서 적절하게 처리한다.</li></ul></td></tr><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>기술검사타입을 지정합니다.</p><ul><li>string: 문자열 검사 대상</li><li>file: 파일 검사 대상</li><li>button: formattedString 내 button 제어 대상</li><li>layout: formattedString 내 button외 제어 대상</li></ul></td></tr><tr><td><strong><code>contentType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>컨텐츠 유형, PolicyInfo 정책을 검사하는데 사용됩니다.</p><ul><li>"title"</li><li>"description"</li><li>"maapfile"</li><li>"cell"</li><li>"displayText"</li><li>"url"</li><li>"etc"</li><li>"buttonName"</li><li>"visibility"</li></ul></td></tr><tr><td><strong><code>strSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>글자 최대 크기, type이 string인 경우</td></tr><tr><td><strong><code>fileSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>파일 최대 크기, type이 file인 경우.</td></tr><tr><td><strong><code>strRegx</code></strong></td><td>string</td><td align="center">65535</td><td align="center"></td><td></td><td><p>java regular expression, null 인경우 사용하지 않음. 예)</p><ol><li>숫자만 : '^[0-9]*$'</li><li>영문자만 : '[a-zA-Z]*$'</li><li>한글만 : '^[가-힣]*$'</li><li>영어 &#x26; 숫자만 : '^[a-zA-Z0-9]*$'</li><li>E-Mail : '^[a-zA-Z0-9]+@[a-zA-Z0-9]+$'</li><li>휴대폰 : '^01(?:0|1|[6-9])-(?:\d{3}|\d{4})-\d{4}$'</li><li>일반전화 : '^\d{2,3}-\d{3,4}-\d{4}$'</li><li>주민등록번호 : '\d{6}-[1-4]\d{6}'</li><li>IP 주소 : '([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3})'</li></ol></td></tr><tr><td><strong><code>verification</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>문장 패턴 정의 (SKT향) "안녕하세요", "님 ", "원입니다."</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 해상도 가로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 해상도 세로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)</td></tr><tr><td><strong><code>couplingId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>파라미터 간 함께 처리되어야 하는 경우 동일한 값을 부여 즉, 같은 값의 couplingId가 지정되는 경우 지정된 파라미터는 모두 조건을 만족해야 정상 발송 처리됨</td></tr><tr><td><strong><code>inputText</code></strong></td><td>string</td><td align="center">65535</td><td align="center"></td><td></td><td>템플릿 등록시 사용자 입력한 원본 문장(고정부 &#x26; 변수부)을 제공합니다. 단, cell방식의 타이틀 선택형은 제공되지 않습니다.</td></tr><tr><td><strong><code>relationId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>param과 관계가 있는 param을 의미합니다. 주로 현재 param이 입력되지 않을 경우 메시지 상에 노출여부와 연관된 visibility에 지정된 param을 표시합니다. 메시지 발송시 이통MaaP FE에서 핸들링하는 것으로 템플릿 등록이나 메시지 발송 param과는 무관하며, 참조 용도로 제공됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">files</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="100">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="94">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center">64</td><td align="center">O</td><td></td><td>등록된 파일의 ID 입니다.</td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>등록된 파일의 URL 정보 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 가로 크기 입니다.</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 세로 크기 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200 - richcard - SMS" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "SS000000",
            "tmpltName": "SMS",
            "messagebaseformId": "SS000000",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:06:39.000+09",
            "updateDate": "2020-04-08T12:25:26.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho",
            "productCode": "sms",
            "spec": "richcard",
            "cardType": "standalone",
            "agencyId": null,
            "inputText": null,
            "attribute": null,
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": null,
                "maxButtonCount": 1,
                "maxDescriptionSize": 100,
                "maxMediaSize": null,
                "buttonsAllowed": true,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "guideInfo": {
                "maxLineCount": null,
                "maxDisplayText": 17,
                "maxDescriptionSize": 100,
                "imageWidth": null,
                "imageHeight": null,
                "detailInfo": null
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "richcardMessage": {
                        "message": {
                            "generalPurposeCard": {
                                "layout": {
                                    "cardOrientation": "VERTICAL"
                                },
                                "content": {
                                    "description": "{{description}}"
                                },
                                "zoomAllowed": true
                            }
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - richcard - LMS" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "SL000000",
            "tmpltName": "LMS",
            "messagebaseformId": "SL000000",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:06:21.000+09",
            "updateDate": "2021-09-03T11:11:03.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho",
            "productCode": "lms",
            "spec": "richcard",
            "cardType": "standalone",
            "agencyId": null,
            "inputText": null,
            "attribute": null,
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 3,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": true,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "guideInfo": {
                "maxLineCount": 96,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "richcardMessage": {
                        "message": {
                            "generalPurposeCard": {
                                "layout": {
                                    "cardOrientation": "VERTICAL"
                                },
                                "content": {
                                    "title": "{{title}}",
                                    "description": "{{description}}"
                                },
                                "zoomAllowed": true
                            }
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - richcard - MMS(스텐다드형)" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "SMwThM00",
            "tmpltName": "세로형(Medium)",
            "messagebaseformId": "SMwThM00",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:07:37.000+09",
            "updateDate": "2021-04-12T10:53:57.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho",
            "productCode": "mms",
            "spec": "richcard",
            "cardType": "standalone media top",
            "agencyId": null,
            "inputText": null,
            "attribute": null,
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 1048576,
                "buttonsAllowed": true,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "guideInfo": {
                "maxLineCount": 96,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "568",
                "imageHeight": "336",
                "detailInfo": null
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": null,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "richcardMessage": {
                        "message": {
                            "generalPurposeCard": {
                                "layout": {
                                    "cardOrientation": "VERTICAL"
                                },
                                "content": {
                                    "media": {
                                        "height": "MEDIUM_HEIGHT",
                                        "mediaUrl": "{{media}}"
                                    },
                                    "title": "{{title}}",
                                    "description": "{{description}}"
                                },
                                "zoomAllowed": true
                            }
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - richcard - MMS(슬라이드형)" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "CMwMhM0300",
            "tmpltName": "슬라이드형(Medium,3장)",
            "messagebaseformId": "CMwMhM0300",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2019-11-08T19:17:24.000+09",
            "approvalDate": "2020-11-06T13:09:09.000+09",
            "updateDate": "2020-04-08T12:32:01.000+09",
            "registerId": "smooncho",
            "updateId": "smooncho",
            "productCode": "mms",
            "spec": "richcard",
            "cardType": "carousel medium",
            "agencyId": null,
            "inputText": null,
            "attribute": null,
            "policyInfo": {
                "cardCount": 3,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 1048576,
                "buttonsAllowed": true,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "guideInfo": {
                "maxLineCount": 4,
                "maxDisplayText": 13,
                "maxDescriptionSize": 60,
                "imageWidth": "696",
                "imageHeight": "504",
                "detailInfo": {
                    "summary": "모든 RCS A2P 대상 단말에서 메시지가 잘려 보이지 않을 최대 보장 description 라인 수에 대한 가이드 정보입니다.",
                    "charactersPerLine": {
                        "title": 13,
                        "description": 14,
                        "buttonName": 13
                    },
                    "combinations": [
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 0,
                                "numberOfButtons": 0
                            },
                            "numberOfLinesOnDescription": 28
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 0,
                                "numberOfButtons": 1
                            },
                            "numberOfLinesOnDescription": 26
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 0,
                                "numberOfButtons": 2
                            },
                            "numberOfLinesOnDescription": 23
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 1,
                                "numberOfButtons": 0
                            },
                            "numberOfLinesOnDescription": 27
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 1,
                                "numberOfButtons": 1
                            },
                            "numberOfLinesOnDescription": 25
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 1,
                                "numberOfButtons": 2
                            },
                            "numberOfLinesOnDescription": 23
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 2,
                                "numberOfButtons": 0
                            },
                            "numberOfLinesOnDescription": 26
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 2,
                                "numberOfButtons": 1
                            },
                            "numberOfLinesOnDescription": 23
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 2,
                                "numberOfButtons": 2
                            },
                            "numberOfLinesOnDescription": 21
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 3,
                                "numberOfButtons": 0
                            },
                            "numberOfLinesOnDescription": 24
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 3,
                                "numberOfButtons": 1
                            },
                            "numberOfLinesOnDescription": 22
                        },
                        {
                            "condition": {
                                "mediaPhase": null,
                                "numberOfLinesOnTitle": 3,
                                "numberOfButtons": 2
                            },
                            "numberOfLinesOnDescription": 20
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 0,
                                "numberOfButtons": 0
                            },
                            "numberOfLinesOnDescription": 17
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 0,
                                "numberOfButtons": 1
                            },
                            "numberOfLinesOnDescription": 15
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 0,
                                "numberOfButtons": 2
                            },
                            "numberOfLinesOnDescription": 13
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 1,
                                "numberOfButtons": 0
                            },
                            "numberOfLinesOnDescription": 16
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 1,
                                "numberOfButtons": 1
                            },
                            "numberOfLinesOnDescription": 14
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 1,
                                "numberOfButtons": 2
                            },
                            "numberOfLinesOnDescription": 12
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 2,
                                "numberOfButtons": 0
                            },
                            "numberOfLinesOnDescription": 15
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 2,
                                "numberOfButtons": 1
                            },
                            "numberOfLinesOnDescription": 13
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 2,
                                "numberOfButtons": 2
                            },
                            "numberOfLinesOnDescription": 11
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 3,
                                "numberOfButtons": 0
                            },
                            "numberOfLinesOnDescription": 14
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 3,
                                "numberOfButtons": 1
                            },
                            "numberOfLinesOnDescription": 12
                        },
                        {
                            "condition": {
                                "mediaPhase": "Medium",
                                "numberOfLinesOnTitle": 3,
                                "numberOfButtons": 2
                            },
                            "numberOfLinesOnDescription": 10
                        }
                    ],
                    "releaseDate": "2021-08-02T00:00:00.000+09",
                    "productCardType": "Carousel Medium"
                }
            },
            "params": [
                {
                    "param": "description1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "description2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "description3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media1",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": null,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media2",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": null,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media3",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": null,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "richcardMessage": {
                        "message": {
                            "generalPurposeCardCarousel": {
                                "layout": {
                                    "cardWidth": "MEDIUM_WIDTH"
                                },
                                "content": [
                                    {
                                        "media": {
                                            "height": "MEDIUM_HEIGHT",
                                            "mediaUrl": "{{media1}}"
                                        },
                                        "title": "{{title1}}",
                                        "description": "{{description1}}"
                                    },
                                    {
                                        "media": {
                                            "height": "MEDIUM_HEIGHT",
                                            "mediaUrl": "{{media2}}"
                                        },
                                        "title": "{{title2}}",
                                        "description": "{{description2}}"
                                    },
                                    {
                                        "media": {
                                            "height": "MEDIUM_HEIGHT",
                                            "mediaUrl": "{{media3}}"
                                        },
                                        "title": "{{title3}}",
                                        "description": "{{description3}}"
                                    }
                                ],
                                "zoomAllowed": true
                            }
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - openrichcard - LMS" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "OL00000001",
            "tmpltName": "기본형",
            "messagebaseformId": "OL00000001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2024-07-10T14:32:18.000+09",
            "approvalDate": "2024-07-10T14:32:25.000+09",
            "updateDate": "2024-07-10T14:32:18.000+09",
            "registerId": "leekmstg",
            "updateId": null,
            "productCode": "lms",
            "spec": "openrichcard",
            "cardType": "format",
            "agencyId": null,
            "inputText": null,
            "attribute": null,
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 17,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": true,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "params": [
                {
                    "param": "btnName1",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "buttonName",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "btnVsblty1"
                },
                {
                    "param": "btnName2",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "buttonName",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "btnVsblty2"
                },
                {
                    "param": "btnVsblty1",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "btnVsblty2",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "description",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty"
                },
                {
                    "param": "descTitleVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "descVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleVsblty"
                },
                {
                    "param": "mTitleMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleMediaVsblty"
                },
                {
                    "param": "mTitleMediaVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mTitleVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "{{mTitleVsblty}}",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "ImageView",
                                                    "width": "24dp",
                                                    "height": "24dp",
                                                    "corner_radius": "4dp",
                                                    "scaleType": "fitXY",
                                                    "marginRight": "4dp",
                                                    "visibility": "{{mTitleMediaVsblty}}",
                                                    "mediaUrl": "{{mTitleMedia}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{mTitle}}",
                                                    "textColor": "#1e1e1e",
                                                    "textAlignment": "textStart",
                                                    "textSize": "19dp"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "2dp",
                                            "widget": "View",
                                            "marginTop": "6dp",
                                            "background": "#1e1e1e"
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{descVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "150"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName1}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty1}}"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName2}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty2}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - openrichcard - MMS" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "OM00000001",
            "tmpltName": "기본형",
            "messagebaseformId": "OM00000001",
            "brandId": "common",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": null,
            "registerDate": "2024-07-10T14:30:21.000+09",
            "approvalDate": "2024-07-10T14:30:22.000+09",
            "updateDate": "2024-07-10T14:30:22.000+09",
            "registerId": "leekmstg",
            "updateId": "leekmstg",
            "productCode": "mms",
            "spec": "openrichcard",
            "cardType": "format",
            "agencyId": null,
            "inputText": null,
            "attribute": null,
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 17,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 1048576,
                "buttonsAllowed": true,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "900",
                "imageHeight": "900",
                "detailInfo": null
            },
            "params": [
                {
                    "param": "btnName1",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "buttonName",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "btnVsblty1"
                },
                {
                    "param": "btnName2",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "buttonName",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "btnVsblty2"
                },
                {
                    "param": "btnVsblty1",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "btnVsblty2",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "description",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty"
                },
                {
                    "param": "descTitleVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "descVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 900,
                    "imageHeight": 900,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mediaVsblty"
                },
                {
                    "param": "mediaUrl",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mediaVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleVsblty"
                },
                {
                    "param": "mTitleMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleMediaVsblty"
                },
                {
                    "param": "mTitleMediaVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mTitleVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "{{mTitleVsblty}}",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "ImageView",
                                                    "width": "24dp",
                                                    "height": "24dp",
                                                    "corner_radius": "4dp",
                                                    "scaleType": "fitXY",
                                                    "marginRight": "4dp",
                                                    "visibility": "{{mTitleMediaVsblty}}",
                                                    "mediaUrl": "{{mTitleMedia}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{mTitle}}",
                                                    "textColor": "#1e1e1e",
                                                    "textAlignment": "textStart",
                                                    "textSize": "19dp"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "2dp",
                                            "widget": "View",
                                            "marginTop": "6dp",
                                            "background": "#1e1e1e"
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "marginTop": "8dp",
                                            "visibility": "{{mediaVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "ImageView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "scaleType": "fitXY",
                                                    "mediaUrl": "{{media}}",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": "{{mediaUrl}}"
                                                                }
                                                            },
                                                            "displayText": "정형이미지",
                                                            "postback": {
                                                                "data": "set_by_chatbot_open_url"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{descVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "100"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName1}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty1}}"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName2}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty2}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿

이 문서는 템플릿에 대한 API 정보를 안내합니다.


# 템플릿 양식 목록 조회

## Request

## 템플릿 양식 목록을 조회합니다.<br>

> 템플릿 양식 목록을 조회합니다.  \
> \
> 템플릿 작성이 필요한 경우 조회된 템플릿 양식 ID를 이용하여 템플릿 양식 세부정보를 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"TmplCardType":{"name":"cardType","in":"query","schema":{"type":"string","enum":["Cell","Description","Highlighted Image n Title","Highlighted Image","Thumbnail","SNS","descriptionNew"]}},"BizCondition":{"name":"bizCondition","in":"query","schema":{"type":"string"},"description":"업태"},"BizCategory":{"name":"bizCategory","in":"query","schema":{"type":"string"},"description":"업종"},"BizService":{"name":"bizService","in":"query","schema":{"type":"string","enum":["승인","입금","출금","출고","주문","배송","예약","회원가입","인증"]},"description":"서비스 내 업무 유형별 제공되는 항목으로 초기 텍스트 템플릿 한정 구분자 입니다.  \n\n이미지템플릿, LMS템플릿, 공통 포맷은 해당되지 않습니다.\n","deprecated":true},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/messagebase/messagebaseform":{"get":{"summary":"템플릿 양식 목록을 조회합니다.\n","description":"템플릿 양식 목록을 조회합니다.  \n\n템플릿 작성이 필요한 경우 조회된 템플릿 양식 ID를 이용하여 템플릿 양식 세부정보를 조회합니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**\n","parameters":[{"$ref":"#/components/parameters/TmplCardType"},{"$ref":"#/components/parameters/BizCondition"},{"$ref":"#/components/parameters/BizCategory"},{"$ref":"#/components/parameters/BizService"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>MessagebaseForm 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="204">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>messagebaseformId</code></strong></td><td>array&#x3C;object></td><td align="center">40</td><td align="center">O</td><td></td><td>템플릿 양식 ID 입니다.</td></tr><tr><td><strong><code>formName</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td>20000000</td><td>템플릿 양식명 입니다.</td></tr><tr><td><strong><code>cardType</code></strong></td><td>integer</td><td align="center">64</td><td align="center"></td><td>200</td><td><p>카드종류를 구분합니다. 향후 추가될 수 있습니다. [openrichcard]</p><ul><li>Description</li><li>Cell</li><li>Free</li></ul></td></tr><tr><td><strong><code>bizCondition</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>양식을 사용할 수 있는 대상 업태의 목록입니다.</td></tr><tr><td><strong><code>bizCategory</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>Description, Cell의 유형그룹 입니다.</td></tr><tr><td><strong><code>bizService</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>Description, Cell의 세부 유형 입니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 양식 등록일시 입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 양식 수정일시 입니다.</td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "ITCRM6",
            "formName": "슬라이드형",
            "cardType": "carousel medium",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-11-27T10:30:30.000+09",
            "updateDate": "2023-11-29T13:07:04.000+09"
        },
        {
            "messagebaseformId": "ITCRM5",
            "formName": "슬라이드형",
            "cardType": "carousel medium",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-11-27T10:28:41.000+09",
            "updateDate": "2023-11-29T13:06:48.000+09"
        },
        {
            "messagebaseformId": "ITCRM4",
            "formName": "슬라이드형",
            "cardType": "carousel medium",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-11-27T10:27:23.000+09",
            "updateDate": "2023-11-29T13:06:18.000+09"
        },
        {
            "messagebaseformId": "ITCRM3",
            "formName": "슬라이드형",
            "cardType": "carousel medium",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-11-27T10:25:34.000+09",
            "updateDate": "2023-11-29T13:06:08.000+09"
        },
        {
            "messagebaseformId": "ITCRM2",
            "formName": "슬라이드형",
            "cardType": "carousel medium",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-11-27T09:44:38.000+09",
            "updateDate": "2023-11-29T13:05:57.000+09"
        },
        {
            "messagebaseformId": "ITTBNV",
            "formName": "썸네일형 (세로)",
            "cardType": "Thumbnail",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T18:05:01.000+09",
            "updateDate": "2022-10-12T09:47:13.000+09"
        },
        {
            "messagebaseformId": "ITTBNH",
            "formName": "썸네일형 (가로)",
            "cardType": "Thumbnail",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T18:04:01.000+09",
            "updateDate": "2022-10-12T09:47:26.000+09"
        },
        {
            "messagebaseformId": "ITHIMS",
            "formName": "이미지 강조형 (1:1)",
            "cardType": "Highlighted Image",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:58:20.000+09",
            "updateDate": "2023-07-18T16:16:34.000+09"
        },
        {
            "messagebaseformId": "ITSNSS",
            "formName": "SNS형 (하단버튼)",
            "cardType": "SNS",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:57:08.000+09",
            "updateDate": "2022-10-12T09:47:44.000+09"
        },
        {
            "messagebaseformId": "ITHIMV",
            "formName": "이미지 강조형 (3:4)",
            "cardType": "Highlighted Image",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:56:09.000+09",
            "updateDate": "2022-10-12T09:46:36.000+09"
        },
        {
            "messagebaseformId": "ITHITS",
            "formName": "이미지 & 타이틀 강조형 (1:1)",
            "cardType": "Highlighted Image n Title",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:53:46.000+09",
            "updateDate": "2022-10-12T09:46:19.000+09"
        },
        {
            "messagebaseformId": "ITSNSH",
            "formName": "SNS형 (중간버튼)",
            "cardType": "SNS",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:53:07.000+09",
            "updateDate": "2022-10-12T09:47:56.000+09"
        },
        {
            "messagebaseformId": "ITHITV",
            "formName": "이미지 & 타이틀 강조형 (3:4)",
            "cardType": "Highlighted Image n Title",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:49:36.000+09",
            "updateDate": "2022-10-12T09:40:49.000+09"
        },
        {
            "messagebaseformId": "TATA001C",
            "formName": "테마 강조형A 스타일",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "타이틀 자유형",
            "bizService": "타이틀 자유형",
            "registerDate": "2022-06-28T15:28:58.000+09",
            "updateDate": "2023-03-21T16:20:08.000+09"
        },
        {
            "messagebaseformId": "TATA001D",
            "formName": "테마 강조형A 서술",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "타이틀 자유형",
            "bizService": "타이틀 자유형",
            "registerDate": "2022-06-28T15:20:39.000+09",
            "updateDate": "2023-03-21T16:20:31.000+09"
        },
        {
            "messagebaseformId": "FF005C",
            "formName": "명세서 C",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "명세서",
            "registerDate": "2021-04-19T11:09:11.000+09",
            "updateDate": "2023-10-27T17:32:03.000+09"
        },
        {
            "messagebaseformId": "FF005D",
            "formName": "명세서 D",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "명세서",
            "registerDate": "2021-04-19T11:06:58.000+09",
            "updateDate": "2023-10-27T17:32:19.000+09"
        },
        {
            "messagebaseformId": "FF004C",
            "formName": "취소 C",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "취소",
            "registerDate": "2021-04-19T10:58:14.000+09",
            "updateDate": "2023-10-27T17:31:21.000+09"
        },
        {
            "messagebaseformId": "FF004D",
            "formName": "취소 D",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "취소",
            "registerDate": "2021-04-19T09:41:03.000+09",
            "updateDate": "2023-10-27T17:31:38.000+09"
        },
        {
            "messagebaseformId": "GG003C",
            "formName": "안내 C",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "일반",
            "bizService": "안내",
            "registerDate": "2021-03-04T17:58:07.000+09",
            "updateDate": "2023-10-27T18:08:31.000+09"
        },
        {
            "messagebaseformId": "GG003D",
            "formName": "안내 D",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "일반",
            "bizService": "안내",
            "registerDate": "2020-11-20T09:22:40.000+09",
            "updateDate": "2023-10-27T18:14:18.000+09"
        },
        {
            "messagebaseformId": "GG002C",
            "formName": "인증cell",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "일반",
            "bizService": "인증",
            "registerDate": "2019-11-22T00:14:39.000+09",
            "updateDate": "2023-10-27T17:33:42.000+09"
        },
        {
            "messagebaseformId": "GG001C",
            "formName": "회원가입cell",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "일반",
            "bizService": "회원가입",
            "registerDate": "2019-11-22T00:12:42.000+09",
            "updateDate": "2023-10-27T18:14:41.000+09"
        },
        {
            "messagebaseformId": "EE001C",
            "formName": "예약cell",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "엔터테인먼트",
            "bizService": "예약",
            "registerDate": "2019-11-21T14:08:12.000+09",
            "updateDate": "2023-10-27T17:26:33.000+09"
        },
        {
            "messagebaseformId": "CC003C",
            "formName": "배송cell",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "유통/커머스",
            "bizService": "배송",
            "registerDate": "2019-11-21T14:06:19.000+09",
            "updateDate": "2023-10-27T17:25:39.000+09"
        },
        {
            "messagebaseformId": "CC003D",
            "formName": "배송desc",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "유통/커머스",
            "bizService": "배송",
            "registerDate": "2019-11-21T14:02:15.000+09",
            "updateDate": "2023-10-27T17:26:02.000+09"
        },
        {
            "messagebaseformId": "CC002D",
            "formName": "주문desc",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "유통/커머스",
            "bizService": "주문",
            "registerDate": "2019-11-21T10:58:57.000+09",
            "updateDate": "2023-10-27T17:24:47.000+09"
        },
        {
            "messagebaseformId": "CC001D",
            "formName": "출고desc",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "유통/커머스",
            "bizService": "출고",
            "registerDate": "2019-11-21T10:57:29.000+09",
            "updateDate": "2023-10-27T17:21:50.000+09"
        },
        {
            "messagebaseformId": "FF002D",
            "formName": "입금desc",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "입금",
            "registerDate": "2019-11-21T10:55:30.000+09",
            "updateDate": "2023-10-27T17:29:26.000+09"
        },
        {
            "messagebaseformId": "GG002D",
            "formName": "인증desc",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "일반",
            "bizService": "인증",
            "registerDate": "2019-11-21T10:53:31.000+09",
            "updateDate": "2023-10-27T17:34:10.000+09"
        },
        {
            "messagebaseformId": "EE001D",
            "formName": "예약desc",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "엔터테인먼트",
            "bizService": "예약",
            "registerDate": "2019-11-21T10:21:39.000+09",
            "updateDate": "2023-10-27T17:27:49.000+09"
        },
        {
            "messagebaseformId": "CC002C",
            "formName": "주문cell",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "유통/커머스",
            "bizService": "주문",
            "registerDate": "2019-11-20T22:40:12.000+09",
            "updateDate": "2023-10-27T17:25:14.000+09"
        },
        {
            "messagebaseformId": "CC001C",
            "formName": "출고cell",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "유통/커머스",
            "bizService": "출고",
            "registerDate": "2019-11-20T22:38:21.000+09",
            "updateDate": "2023-10-27T17:22:14.000+09"
        },
        {
            "messagebaseformId": "FF001D",
            "formName": "진짜승인desc",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "승인",
            "registerDate": "2019-11-16T14:16:59.000+09",
            "updateDate": "2023-10-27T17:29:01.000+09"
        },
        {
            "messagebaseformId": "FF003C",
            "formName": "출금cell",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "출금",
            "registerDate": "2019-11-16T09:17:07.000+09",
            "updateDate": "2023-10-27T17:30:36.000+09"
        },
        {
            "messagebaseformId": "FF002C",
            "formName": "입금cell",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "입금",
            "registerDate": "2019-11-16T09:13:02.000+09",
            "updateDate": "2023-10-27T17:29:56.000+09"
        },
        {
            "messagebaseformId": "GG001D",
            "formName": "회원가입desc",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "일반",
            "bizService": "회원가입",
            "registerDate": "2019-11-16T09:09:21.000+09",
            "updateDate": "2023-10-27T18:15:02.000+09"
        },
        {
            "messagebaseformId": "FF001C",
            "formName": "승인(Cell)",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "승인",
            "registerDate": "2019-11-01T00:00:00.000+09",
            "updateDate": "2023-10-27T17:28:39.000+09"
        },
        {
            "messagebaseformId": "FF003D",
            "formName": "출금(Description)",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "금융",
            "bizService": "출금",
            "registerDate": "2019-11-01T00:00:00.000+09",
            "updateDate": "2023-10-27T17:30:53.000+09"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 54
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 양식 상세 조회

## Request

## 템플릿 유형의 상세 내용을 조회합니다.<br>

> 템플릿 유형의 상세 내용을 조회합니다.  \
> \
> params, formattedString을 이용하여 템플릿 작성시 사용합니다.  \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"MessagebaseformId":{"name":"messagebaseformId","in":"path","schema":{"type":"string"},"required":true,"description":"messagebaseform ID Path parameter 입니다."}}},"paths":{"/messagebase/messagebaseform/{messagebaseformId}":{"get":{"summary":"템플릿 유형의 상세 내용을 조회합니다.\n","description":"템플릿 유형의 상세 내용을 조회합니다.  \n\nparams, formattedString을 이용하여 템플릿 작성시 사용합니다.  \n  + **계정 권한 : 마스터, 매니저, 대행사**\n","parameters":[{"$ref":"#/components/parameters/MessagebaseformId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>템플릿 생성을 위한 양식 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="202">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>messagebaseformId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>템플릿 양식 ID 입니다.</td></tr><tr><td><strong><code>formName</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>템플릿 양식명 입니다.</td></tr><tr><td><strong><code>cardType</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td><p>카드종류를 구분합니다. 향후 추가될 수 있습니다.</p><ul><li>Description</li><li>Cell</li><li>Free</li></ul></td></tr><tr><td><strong><code>bizCondition</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>양식을 사용할 수 있는 대상 업태의 목록입니다.</td></tr><tr><td><strong><code>bizCategory</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>Description, Cell의 유형그룹 입니다.</td></tr><tr><td><strong><code>bizService</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>Description, Cell의 세부 유형 입니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 양식 등록일시 입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 양식 수정일시 입니다.</td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>productCode</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>메시지 상품종류 구분값입니다.<br>"sms", "lms", "mms", "tmplt", "itmpl"</td></tr><tr><td><strong><code>spec</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>양식의 레이아웃 구조가 리치카드인지 오픈리치카드인지 구분합니다.<br>"richcard", "openrichcard"<br><br>AOS/iOS 26 통합 지원 규격이 추가되었습니다.<br>"richcardPlus"</td></tr><tr><td><a href="#guideinfo-object"><mark style="color:blue;"><strong><code>guideInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 작성에 필요한 가이드 정보를 제공하기 위하여 양식 정의 시 포함되는 정보입니다. 리치카드의 경우 messagebaseInfo에서 제공됩니다.</td></tr><tr><td><a href="#policyinfo-object"><mark style="color:blue;"><strong><code>policyInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>리치카드, 오픈리치카드에 포함된 content(title, description, media, button) 에 대한 검증 정책 저장을 위한 객체입니다.</td></tr><tr><td><a href="#params-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>params</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>템플릿의 개별 파라미터를 검수하기 위한 대상 파라미터 정보 객체입니다. 크기 관련 필드는 &#x3C;=0 인 경우 체크하지 않습니다.</td></tr><tr><td><strong><code>formattedString</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>GSMA 및 TTA RCS 규격이며 JSON 형식으로 정의된 템플릿의 레이아웃 데이터입니다.</td></tr></tbody></table>

{% hint style="info" %}
GSMA RCC.07-v11.0 참조\
<https://www.gsma.com/solutions-and-impact/technologies/networks/wp-content/uploads/2019/10/RCC.07-v11.0.pdf>
{% endhint %}

{% hint style="info" %}
TTAK.KO-06.0410/R7 참조

<https://committee.tta.or.kr/data/standard_view.jsp?secondDepthCode=PG1105&firstDepthCode=TC011&pk_num=TTAK.KO-06.0410/R7&commit_code=PG1105>
{% endhint %}

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>typeName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">guideInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="111">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>maxLineCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>max 라인수</td></tr><tr><td><strong><code>maxDisplayText</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼명 글자수</td></tr><tr><td><strong><code>maxDescriptionSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>카드별 max 본문 글자수</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 권고 가로 사이즈 단위는 Pixel</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 권고 세로 사이즈 단위는 Pixel</td></tr><tr><td><a href="#detailinfo-object"><mark style="color:blue;"><strong><code>detailInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td><p>리치카드 메시지 상품별 1라인당 글자수, 타이틀 라인수 및 버튼 수에 따라 메시지가 잘려 보이지 않는 최대 라인수 정보를 제공합니다.</p><p>메시지가 수신된 단말에 따라 상이할 수 있으나 리치카드 RCS메시지 발송 시 권장사항으로 참고하시기 바랍니다.</p><p>LMS와 MMS 12종 총 13종에 대해 개별 제공됩니다.</p></td></tr></tbody></table>

### <mark style="color:blue;">detailInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>productCardType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>상품 카드 종류</td></tr><tr><td><strong><code>releaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>정보 제공 일자(내용 수정시 일시 변경)</td></tr><tr><td><strong><code>summary</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>요약 정보</td></tr><tr><td><strong><code>charactersPerLine</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>각 항목 별 권장 라인당 글자수</td></tr><tr><td><strong><code>combinations</code></strong></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>디스크립션 권장 라인수 조합</td></tr></tbody></table>

### <mark style="color:blue;">policyInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="224">필드명</th><th width="102">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="88">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonsAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>MaaP FE /message의 buttons 사용 유무</p><ul><li>true : buttons 필드 사용</li><li>false : buttons 에 값이 들어오면 실패 처리</li></ul></td></tr><tr><td><strong><code>adHeaderAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>header에 광고 인입 허가 여부</p><ul><li>true : 광고인입 허용(MaaP FE /message의 header 체크안함)</li><li>false : 광고인입 불허(MaaP FE /message이 header가 1(광고) 이면 실패 처리)</li></ul></td></tr><tr><td><strong><code>adBodyAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>광고 문구 허용 여부</p><ul><li>true : 본문 광고 문구를 체크하지 않음.</li><li>false : 본문이 "(광고)"로 시작하면 실패 처리</li></ul></td></tr><tr><td><strong><code>cardCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>카드 개수</td></tr><tr><td><strong><code>maxTitleSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>개별 타이틀 글자 최대 수. 사용하지 않음.</td></tr><tr><td><strong><code>maxButtonCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼 최대 개수</td></tr><tr><td><strong><code>maxDescriptionSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td><ul><li>RichCard인 경우(Carousel포함) Description들의 글자수 총합.</li><li>OpenRichCard인 경우 변수부 글자수 총합. &#x3C;=0 인 경우 사용하지 않음.</li></ul></td></tr><tr><td><strong><code>maxMediaSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>Byte단위 미디어 크기 총합의 최대 크기, &#x3C;=0 인 경우 사용하지 않음.</td></tr></tbody></table>

### <mark style="color:blue;">params</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="155">필드명</th><th width="152">타입</th><th width="87" align="center">길이</th><th width="108" align="center">필수여부</th><th width="82">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>param</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>검수 파라미터명. (영문, 한글, 숫자, '_' 만 사용)</td></tr><tr><td><strong><code>isMandatory</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>필수여부.</p><ul><li>true인 경우 중계사에서 메시지 전송 요청 시 해당 필드가 없는 경우 MaaP FE에서 실패처리한다.</li><li>false인 경우는 해당 필드가 없는 경우도 메시지 전송이 되도록 MaaP FE에서 적절하게 처리한다.</li></ul></td></tr><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>기술검사타입을 지정합니다.</p><ul><li>string: 문자열 검사 대상</li><li>file: 파일 검사 대상</li><li>button: formattedString 내 button 제어 대상</li><li>layout: formattedString 내 button외 제어 대상</li></ul></td></tr><tr><td><strong><code>contentType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>컨텐츠 유형, PolicyInfo 정책을 검사하는데 사용됩니다.</p><ul><li>title: 메시지 상품 제한 글자수에 포함되지 않는 유형</li><li>description: 메시지 상품 제한 글자수에 포함되며 템플릿 등록 문장 패턴 검사 대상</li><li>maapfile: 메시지 내 표시되는 이미지/영상 등의 fileId 지정 대상</li><li>cell: 메시지 상품 제한 글자수에 포함되며 템플릿 등록 문장 패턴 검사 제외</li><li>displayText: Suggested Actions 규격의 버튼명 </li><li>url: URL 형식 체크 대상</li><li>etc: 템플릿 등록 시 버튼 Action 중 URL을 제외한 나머지 Action 내  사용자 지정 변수</li><li>buttonName: Button 위젯의 버튼명</li><li>visibility: 메시지 표시 영역 별 표시 제어 영역</li><li>notice: 메시지 상품 제한 글자수에 포함되지 않는 유형</li></ul></td></tr><tr><td><strong><code>strSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>글자 최대 크기, type이 string인 경우</td></tr><tr><td><strong><code>fileSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>파일 최대 크기, type이 file인 경우.</td></tr><tr><td><strong><code>strRegx</code></strong></td><td>string</td><td align="center">65535</td><td align="center"></td><td></td><td><p>java regular expression, null 인경우 사용하지 않음. 예)</p><ol><li>숫자만 : '^[0-9]*$'</li><li>영문자만 : '[a-zA-Z]*$'</li><li>한글만 : '^[가-힣]*$'</li><li>영어 &#x26; 숫자만 : '^[a-zA-Z0-9]*$'</li><li>E-Mail : '^[a-zA-Z0-9]+@[a-zA-Z0-9]+$'</li><li>휴대폰 : '^01(?:0|1|[6-9])-(?:\d{3}|\d{4})-\d{4}$'</li><li>일반전화 : '^\d{2,3}-\d{3,4}-\d{4}$'</li><li>주민등록번호 : '\d{6}-[1-4]\d{6}'</li><li>IP 주소 : '([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3})'</li></ol></td></tr><tr><td><strong><code>verification</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>문장 패턴 정의 (SKT향) "안녕하세요", "님 ", "원입니다."</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 해상도 가로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 해상도 세로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)</td></tr><tr><td><strong><code>couplingId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>파라미터 간 함께 처리되어야 하는 경우 동일한 값을 부여 즉, 같은 값의 couplingId가 지정되는 경우 지정된 파라미터는 모두 조건을 만족해야 정상 발송 처리됨</td></tr><tr><td><strong><code>inputText</code></strong></td><td>string</td><td align="center">65535</td><td align="center"></td><td></td><td>템플릿 등록시 사용자 입력한 원본 문장(고정부 &#x26; 변수부)을 제공합니다. 단, cell방식의 타이틀 선택형은 제공되지 않습니다.</td></tr><tr><td><strong><code>relationId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>param과 관계가 있는 param을 의미합니다. 주로 현재 param이 입력되지 않을 경우 메시지 상에 노출여부와 연관된 visibility에 지정된 param을 표시합니다. 메시지 발송시 이통MaaP FE에서 핸들링하는 것으로 템플릿 등록이나 메시지 발송 param과는 무관하며, 참조 용도로 제공됩니다.</td></tr><tr><td><strong><code>setViewAll</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>true</td><td><p></p><p>viewAll(모두보기) 활성화 여부를 지정합니다.</p><p>messagebaseform.params의 각 Object 내 setViewAll이 포함된 Object에서만 사용 가능하며, 사용될 수 없는 Object에서 사용 시 무시됩니다.</p><p>활성화 여부만 선택 가능하며, 활성화 시 viewAll의 글자수는 RBC 내부 로직에 의해 지정됩니다.</p><ul><li>true: 메시지 내 대상 파라미터 viewAll(모두보기) 활성화</li><li>false: 메시지 내 대상 파라미터 viewAll(모두보기) 비활성화</li></ul><p>※ viewAll은 메시지 내 문자열이 표시되는 영역에 설정된 글자수 이상이 입력된 경우, 대상 영역을 '모두보기 >' 표시와 함께 접힌 상태로 표시하는 메시지 규격입니다.</p><p></p></td></tr><tr><td><strong><code>viewAll</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>150</td><td><p></p><p>viewAll(모두보기) 접힘 글자수 기준값을 지정합니다.</p><p>messagebaseform.params의 각 Object 내 viewAll이 포함된 Object에서만 사용 가능하며, 사용될 수 없는 Object에서 사용 시 무시됩니다.</p><ul><li>유효값: 150(default), 300</li><li>유효값 이외 수치가 입력되는 경우 default로 처리됩니다.</li></ul></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200 - 타이틀자유형-스타일" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "TATA001C",
            "formName": "테마 강조형A 스타일",
            "cardType": "cell",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "타이틀 자유형",
            "bizService": "타이틀 자유형",
            "registerDate": "2022-06-28T15:28:58.000+09",
            "updateDate": "2023-03-21T16:20:08.000+09",
            "mediaUrl": [],
            "productCode": "tmplt",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 90,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 0,
                "maxButtonCount": 2,
                "maxDescriptionSize": 90,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": false,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "cell1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell10",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell11",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell12",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell13",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell14",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell15",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell16",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell17",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell18",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell19",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell20",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell4",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell5",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell6",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell7",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell8",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "cell9",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 8,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "text"
                                                        ]
                                                    },
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "textAlignment": "textStart",
                                                    "text": "{{title1}}",
                                                    "textColor": "#232323",
                                                    "textSize": "19dp",
                                                    "weight": "1"
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "text"
                                                        ]
                                                    },
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "textAlignment": "textEnd",
                                                    "text": "{{title2}}",
                                                    "textColor": "#0094ff",
                                                    "textSize": "19dp",
                                                    "weight": "1",
                                                    "visibility": "visible"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "3dp",
                                            "widget": "View",
                                            "background": "#232323",
                                            "visibility": "visible",
                                            "marginTop": "10dp",
                                            "marginBottom": "12dp"
                                        },
                                        {
                                            "width": "match",
                                            "height": "content",
                                            "widget": "LinearLayout",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell1}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell2}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell3}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell4}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell5}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell6}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell7}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell8}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell9}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell10}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell11}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell12}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell13}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell14}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell15}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell16}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell17}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell18}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell19}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        },
                                                        {
                                                            "widgetPolicy": {
                                                                "allowedAttributes": [
                                                                    "text",
                                                                    "textAlignment",
                                                                    "textColor",
                                                                    "textSize",
                                                                    "textStyle"
                                                                ]
                                                            },
                                                            "text": "{{cell20}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "visibility"
                                                        ]
                                                    },
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "gone",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        },
                        "suggestions": [
                            {}
                        ]
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 타이틀자유형-서술" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "TATA001D",
            "formName": "테마 강조형A 서술",
            "cardType": "description",
            "bizCondition": [
                "all"
            ],
            "bizCategory": "타이틀 자유형",
            "bizService": "타이틀 자유형",
            "registerDate": "2022-06-28T15:20:39.000+09",
            "updateDate": "2023-03-21T16:20:31.000+09",
            "mediaUrl": [],
            "productCode": "tmplt",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 90,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 0,
                "maxButtonCount": 2,
                "maxDescriptionSize": 90,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": false,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 8,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 20,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "text"
                                                        ]
                                                    },
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "textAlignment": "textStart",
                                                    "text": "{{title1}}",
                                                    "textColor": "#232323",
                                                    "textSize": "19dp",
                                                    "weight": "1"
                                                },
                                                {
                                                    "widgetPolicy": {
                                                        "allowedAttributes": [
                                                            "text"
                                                        ]
                                                    },
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "textAlignment": "textEnd",
                                                    "text": "{{title2}}",
                                                    "textColor": "#0094ff",
                                                    "textSize": "19dp",
                                                    "weight": "1",
                                                    "visibility": "visible"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "3dp",
                                            "widget": "View",
                                            "background": "#232323",
                                            "visibility": "visible",
                                            "marginTop": "10dp",
                                            "marginBottom": "12dp"
                                        },
                                        {
                                            "widgetPolicy": {
                                                "allowedAttributes": [
                                                    "text"
                                                ]
                                            },
                                            "widget": "TextView",
                                            "width": "match",
                                            "height": "content",
                                            "text": "{{description}}",
                                            "textColor": "#232323",
                                            "textSize": "16dp"
                                        }
                                    ]
                                }
                            ]
                        },
                        "suggestions": [
                            {}
                        ]
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 이미지&타이틀 강조형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "ITHITS",
            "formName": "이미지 & 타이틀 강조형 (1:1)",
            "cardType": "Highlighted Image n Title",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:53:46.000+09",
            "updateDate": "2022-10-12T09:46:19.000+09",
            "mediaUrl": [],
            "productCode": "itmpl",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 150,
                "imageWidth": "900",
                "imageHeight": "900",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "media",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 900,
                    "imageHeight": 900,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mediaUrl",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subDesc1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 33,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "sub1",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subDesc2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 33,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "sub2",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subDesc3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 33,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "sub3",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subTitle1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 4,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "sub1",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subTitle2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 4,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "sub2",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subTitle3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 4,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "sub3",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 30,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "horizontal",
                                    "children": [
                                        {
                                            "widget": "ImageView",
                                            "width": "match",
                                            "height": "content",
                                            "scaleType": "fitXY",
                                            "mediaUrl": "{{media}}",
                                            "click": {
                                                "action": {
                                                    "urlAction": {
                                                        "openUrl": {
                                                            "url": "{{mediaUrl}}"
                                                        }
                                                    },
                                                    "displayText": "메인이미지",
                                                    "postback": {
                                                        "data": "set_by_chatbot_open_url"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "TextView",
                                            "width": "match",
                                            "height": "content",
                                            "textStyle": "bold",
                                            "text": "{{title}}",
                                            "textColor": "#232323",
                                            "textSize": "17dp",
                                            "marginBottom": "16dp",
                                            "visibility": "{{titleVsblty}}"
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "60dp",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{subTitle1}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "marginLeft": "16dp",
                                                            "text": "{{subDesc1}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp",
                                                            "weight": "1"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "visibility": "{{subVsblty2}}",
                                                    "marginTop": "6dp",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "60dp",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{subTitle2}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "marginLeft": "16dp",
                                                            "text": "{{subDesc2}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp",
                                                            "weight": "1"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "visibility": "{{subVsblty3}}",
                                                    "marginTop": "6dp",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "60dp",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{subTitle3}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "marginLeft": "16dp",
                                                            "text": "{{subDesc3}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp",
                                                            "weight": "1"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName1}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "marginTop": "16dp",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty1}}"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty2}}",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 이미지강조형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "ITHIMS",
            "formName": "이미지 강조형 (1:1)",
            "cardType": "Highlighted Image",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:58:20.000+09",
            "updateDate": "2023-07-18T16:16:34.000+09",
            "mediaUrl": [],
            "productCode": "itmpl",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 150,
                "imageWidth": "900",
                "imageHeight": "900",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 150,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 900,
                    "imageHeight": 900,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mediaUrl",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 30,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "horizontal",
                                    "children": [
                                        {
                                            "widget": "ImageView",
                                            "width": "match",
                                            "height": "content",
                                            "scaleType": "fitXY",
                                            "mediaUrl": "{{media}}",
                                            "click": {
                                                "action": {
                                                    "urlAction": {
                                                        "openUrl": {
                                                            "url": "{{mediaUrl}}"
                                                        }
                                                    },
                                                    "displayText": "메인이미지",
                                                    "postback": {
                                                        "data": "set_by_chatbot_open_url"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "background": "#F2F2F2",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{title}}",
                                                    "textColor": "#232323",
                                                    "textSize": "17dp",
                                                    "marginBottom": "10dp",
                                                    "visibility": "{{titleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#232323",
                                                    "textSize": "16dp",
                                                    "weight": "1"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName1}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "marginTop": "16dp",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty1}}"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty2}}",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 썸네일형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "ITTBNH",
            "formName": "썸네일형 (가로)",
            "cardType": "Thumbnail",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T18:04:01.000+09",
            "updateDate": "2022-10-12T09:47:26.000+09",
            "mediaUrl": [],
            "productCode": "itmpl",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 150,
                "imageWidth": "900",
                "imageHeight": "560",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 150,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 900,
                    "imageHeight": 560,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mediaUrl",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subMedia1",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subMedia2",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subMedia3",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subMediaUrl1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subMediaUrl2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subMediaUrl3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 30,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "horizontal",
                                    "children": [
                                        {
                                            "widget": "ImageView",
                                            "width": "match",
                                            "height": "content",
                                            "scaleType": "fitXY",
                                            "mediaUrl": "{{media}}",
                                            "click": {
                                                "action": {
                                                    "urlAction": {
                                                        "openUrl": {
                                                            "url": "{{mediaUrl}}"
                                                        }
                                                    },
                                                    "displayText": "메인이미지",
                                                    "postback": {
                                                        "data": "set_by_chatbot_open_url"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{title}}",
                                                    "textColor": "#232323",
                                                    "textSize": "17dp",
                                                    "marginBottom": "10dp",
                                                    "visibility": "{{titleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#232323",
                                                    "textSize": "16dp",
                                                    "weight": "1"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "marginTop": "16dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "0dp",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "background": "#ffd400",
                                                            "width": "match",
                                                            "height": "content",
                                                            "corner_radius": "4dp",
                                                            "scaleType": "fitCenter",
                                                            "mediaUrl": "{{subMedia1}}",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": "{{subMediaUrl1}}"
                                                                        }
                                                                    },
                                                                    "displayText": "서브이미지1",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "0dp",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "weight": "1",
                                                    "marginLeft": "10dp",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "background": "#ffd400",
                                                            "width": "match",
                                                            "height": "content",
                                                            "corner_radius": "4dp",
                                                            "scaleType": "fitCenter",
                                                            "mediaUrl": "{{subMedia2}}",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": "{{subMediaUrl2}}"
                                                                        }
                                                                    },
                                                                    "displayText": "서브이미지2",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "0dp",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "weight": "1",
                                                    "marginLeft": "10dp",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "background": "#ffd400",
                                                            "width": "match",
                                                            "height": "content",
                                                            "corner_radius": "4dp",
                                                            "scaleType": "fitCenter",
                                                            "mediaUrl": "{{subMedia3}}",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": "{{subMediaUrl3}}"
                                                                        }
                                                                    },
                                                                    "displayText": "서브이미지3",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName1}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "marginTop": "16dp",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty1}}"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty2}}",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - SNS형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "ITSNSH",
            "formName": "SNS형 (중간버튼)",
            "cardType": "SNS",
            "bizCondition": [
                "all"
            ],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2022-10-11T17:53:07.000+09",
            "updateDate": "2022-10-12T09:47:56.000+09",
            "mediaUrl": [],
            "productCode": "itmpl",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 150,
                "imageWidth": "900",
                "imageHeight": "560",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 150,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 900,
                    "imageHeight": 560,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mediaUrl",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 30,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{title}}",
                                                    "textColor": "#232323",
                                                    "textSize": "17dp",
                                                    "marginBottom": "10dp",
                                                    "visibility": "{{titleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#232323",
                                                    "textSize": "16dp",
                                                    "weight": "1"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName1}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "marginTop": "16dp",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty1}}"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty2}}",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "horizontal",
                                    "children": [
                                        {
                                            "widget": "ImageView",
                                            "width": "match",
                                            "height": "content",
                                            "scaleType": "fitXY",
                                            "mediaUrl": "{{media}}",
                                            "click": {
                                                "action": {
                                                    "urlAction": {
                                                        "openUrl": {
                                                            "url": "{{mediaUrl}}"
                                                        }
                                                    },
                                                    "displayText": "메인이미지",
                                                    "postback": {
                                                        "data": "set_by_chatbot_open_url"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 슬라이드형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "ITCRM3",
            "formName": "슬라이드형",
            "cardType": "carousel medium",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-11-27T10:25:34.000+09",
            "updateDate": "2023-11-29T13:06:08.000+09",
            "mediaUrl": [],
            "productCode": "itmpl",
            "spec": "richcard",
            "guideInfo": {
                "maxLineCount": 4,
                "maxDisplayText": 13,
                "maxDescriptionSize": 60,
                "imageWidth": "696",
                "imageHeight": "1296",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 3,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "description2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "description3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media1",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media2",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "media3",
                    "isMandatory": true,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": 0,
                    "strRegx": "",
                    "verification": [],
                    "imageWidth": 0,
                    "imageHeight": 0,
                    "couplingId": "",
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "richcardMessage": {
                        "message": {
                            "generalPurposeCardCarousel": {
                                "layout": {
                                    "cardWidth": "MEDIUM_WIDTH"
                                },
                                "content": [
                                    {
                                        "description": "{{description1}}",
                                        "media": {
                                            "mediaUrl": "{{media1}}",
                                            "height": "MEDIUM_HEIGHT"
                                        },
                                        "title": "{{title1}}"
                                    },
                                    {
                                        "description": "{{description2}}",
                                        "media": {
                                            "mediaUrl": "{{media2}}",
                                            "height": "MEDIUM_HEIGHT"
                                        },
                                        "title": "{{title2}}"
                                    },
                                    {
                                        "description": "{{description3}}",
                                        "media": {
                                            "mediaUrl": "{{media3}}",
                                            "height": "MEDIUM_HEIGHT"
                                        },
                                        "title": "{{title3}}"
                                    }
                                ],
                                "zoomAllowed": false
                            }
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - LMS형-기본" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "CLL00004",
            "formName": "LMS 템플릿 기본형",
            "cardType": "descriptionNew",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-10-19T22:25:32.000+09",
            "updateDate": "2024-06-21T14:49:36.000+09",
            "mediaUrl": [],
            "productCode": "lms",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty"
                },
                {
                    "param": "mTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleVsblty"
                },
                {
                    "param": "mTitleMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleMediaVsblty"
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "{{mTitleVsblty}}",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "ImageView",
                                                    "width": "24dp",
                                                    "height": "24dp",
                                                    "corner_radius": "4dp",
                                                    "scaleType": "fitXY",
                                                    "marginRight": "4dp",
                                                    "visibility": "{{mTitleMediaVsblty}}",
                                                    "mediaUrl": "{{mTitleMedia}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{mTitle}}",
                                                    "textColor": "#1e1e1e",
                                                    "textAlignment": "textStart",
                                                    "textSize": "19dp"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "2dp",
                                            "widget": "View",
                                            "marginTop": "6dp",
                                            "background": "#1e1e1e"
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{descVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "150"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName1}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty1}}"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName2}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty2}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - LMS형-명세서" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "CLL00001",
            "formName": "LMS 템플릿 명세서형 타이틀 강조",
            "cardType": "descriptionNew",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-10-19T22:18:25.000+09",
            "updateDate": "2024-06-21T15:54:12.000+09",
            "mediaUrl": [],
            "productCode": "lms",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 2,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 17,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "cellLeft1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty1"
                },
                {
                    "param": "cellLeft10",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty10"
                },
                {
                    "param": "cellLeft11",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty11"
                },
                {
                    "param": "cellLeft12",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty12"
                },
                {
                    "param": "cellLeft13",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty13"
                },
                {
                    "param": "cellLeft14",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty14"
                },
                {
                    "param": "cellLeft15",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty15"
                },
                {
                    "param": "cellLeft2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty2"
                },
                {
                    "param": "cellLeft3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty3"
                },
                {
                    "param": "cellLeft4",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty4"
                },
                {
                    "param": "cellLeft5",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty5"
                },
                {
                    "param": "cellLeft6",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty6"
                },
                {
                    "param": "cellLeft7",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty7"
                },
                {
                    "param": "cellLeft8",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty8"
                },
                {
                    "param": "cellLeft9",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty9"
                },
                {
                    "param": "cellRight1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty1"
                },
                {
                    "param": "cellRight10",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty10"
                },
                {
                    "param": "cellRight11",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty11"
                },
                {
                    "param": "cellRight12",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty12"
                },
                {
                    "param": "cellRight13",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty13"
                },
                {
                    "param": "cellRight14",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty14"
                },
                {
                    "param": "cellRight15",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty15"
                },
                {
                    "param": "cellRight2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty2"
                },
                {
                    "param": "cellRight3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty3"
                },
                {
                    "param": "cellRight4",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty4"
                },
                {
                    "param": "cellRight5",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty5"
                },
                {
                    "param": "cellRight6",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty6"
                },
                {
                    "param": "cellRight7",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty7"
                },
                {
                    "param": "cellRight8",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty8"
                },
                {
                    "param": "cellRight9",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty9"
                },
                {
                    "param": "cellTitle1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellTitleVsblty1"
                },
                {
                    "param": "cellTitle2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellTitleVsblty2"
                },
                {
                    "param": "description",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty"
                },
                {
                    "param": "mTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleVsblty"
                },
                {
                    "param": "mTitleMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleMediaVsblty"
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "{{mTitleVsblty}}",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{mTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "24dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "48dp",
                                                    "height": "48dp",
                                                    "orientation": "horizontal",
                                                    "corner_radius": "4dp",
                                                    "marginLeft": "8dp",
                                                    "visibility": "{{mTitleMediaVsblty}}",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "width": "match",
                                                            "height": "match",
                                                            "scaleType": "fitXY",
                                                            "mediaUrl": "{{mTitleMedia}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{descVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "100"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "background": "#f2f2f2",
                                            "corner_radius": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{cellVsblty1}}",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellTitleVsblty1}}",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{cellTitle1}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "17dp",
                                                            "marginBottom": "4dp"
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "background": "#1e1e1e",
                                                            "marginBottom": "1dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft1}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty1}}",
                                                                    "text": "{{cellRight1}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty1}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty2}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "1dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft2}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty2}}",
                                                                    "text": "{{cellRight2}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty2}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty3}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft3}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty3}}",
                                                                    "text": "{{cellRight3}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty3}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty4}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft4}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty4}}",
                                                                    "text": "{{cellRight4}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty4}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty5}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft5}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty5}}",
                                                                    "text": "{{cellRight5}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty5}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty6}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft6}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty6}}",
                                                                    "text": "{{cellRight6}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty6}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty7}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft7}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty7}}",
                                                                    "text": "{{cellRight7}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty7}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty8}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft8}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty8}}",
                                                                    "text": "{{cellRight8}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty8}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty9}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft9}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty9}}",
                                                                    "text": "{{cellRight9}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty9}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty10}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft10}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty10}}",
                                                                    "text": "{{cellRight10}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty10}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "background": "#f2f2f2",
                                            "corner_radius": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{cellVsblty11}}",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellTitleVsblty2}}",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{cellTitle2}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "17dp",
                                                            "marginBottom": "4dp"
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "background": "#1e1e1e",
                                                            "marginBottom": "1dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft11}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty11}}",
                                                                    "text": "{{cellRight11}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty11}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty12}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "1dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft12}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty12}}",
                                                                    "text": "{{cellRight12}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty12}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty13}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft13}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty13}}",
                                                                    "text": "{{cellRight13}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty13}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty14}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft14}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty14}}",
                                                                    "text": "{{cellRight14}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty14}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty15}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft15}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty15}}",
                                                                    "text": "{{cellRight15}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty15}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName1}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty1}}"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName2}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty2}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 테이블아이템 강조형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "CLT00001",
            "formName": "테이블 아이템 강조",
            "cardType": "descriptionNew",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-10-19T22:28:17.000+09",
            "updateDate": "2024-06-21T14:48:30.000+09",
            "mediaUrl": [],
            "productCode": "tmplt",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 1,
                "maxDisplayText": 17,
                "maxDescriptionSize": 90,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 0,
                "maxButtonCount": 2,
                "maxDescriptionSize": 90,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": false,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "cellLeft1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty1"
                },
                {
                    "param": "cellLeft2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty2"
                },
                {
                    "param": "cellLeft3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty3"
                },
                {
                    "param": "cellLeft4",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty4"
                },
                {
                    "param": "cellLeft5",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellVsblty5"
                },
                {
                    "param": "cellRight1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty1"
                },
                {
                    "param": "cellRight2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty2"
                },
                {
                    "param": "cellRight3",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty3"
                },
                {
                    "param": "cellRight4",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty4"
                },
                {
                    "param": "cellRight5",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellRightVsblty5"
                },
                {
                    "param": "cellTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "cellTitleVsblty"
                },
                {
                    "param": "itemDesc",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 18,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "itemDescVsblty"
                },
                {
                    "param": "itemMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "itemMediaVsblty"
                },
                {
                    "param": "itemTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 14,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "itemVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "4dp",
                                    "orientation": "vertical"
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "marginBottom": "2dp",
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "visibility": "{{itemVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "text": "{{itemDesc}}",
                                                            "textColor": "#949494",
                                                            "visibility": "{{itemDescVsblty}}",
                                                            "textSize": "14dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "2dp",
                                                            "textStyle": "bold",
                                                            "text": "{{itemTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "24dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "56dp",
                                                    "height": "56dp",
                                                    "orientation": "horizontal",
                                                    "corner_radius": "4dp",
                                                    "marginLeft": "8dp",
                                                    "visibility": "{{itemMediaVsblty}}",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "width": "match",
                                                            "height": "match",
                                                            "scaleType": "fitXY",
                                                            "mediaUrl": "{{itemMedia}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "background": "#f2f2f2",
                                            "corner_radius": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{cellVsblty1}}",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellTitleVsblty}}",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{cellTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "17dp",
                                                            "marginBottom": "4dp"
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "background": "#1e1e1e",
                                                            "marginBottom": "1dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft1}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty1}}",
                                                                    "text": "{{cellRight1}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty1}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty2}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "1dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft2}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty2}}",
                                                                    "text": "{{cellRight2}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty2}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty3}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft3}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty3}}",
                                                                    "text": "{{cellRight3}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty3}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty4}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft4}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty4}}",
                                                                    "text": "{{cellRight4}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty4}}"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "{{cellVsblty5}}",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft5}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "{{cellRightVsblty5}}",
                                                                    "text": "{{cellRight5}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "{{cellLineVsblty5}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName1}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty1}}"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName2}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty2}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 기본형 아이템강조" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "CLT00002",
            "formName": "기본형 아이템 강조",
            "cardType": "descriptionNew",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-10-19T22:29:38.000+09",
            "updateDate": "2024-07-16T13:40:51.000+09",
            "mediaUrl": [],
            "productCode": "tmplt",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 90,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 14,
                "maxButtonCount": 2,
                "maxDescriptionSize": 90,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": false,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 90,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty"
                },
                {
                    "param": "itemDesc",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 18,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "itemDescVsblty"
                },
                {
                    "param": "itemMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "itemMediaVsblty"
                },
                {
                    "param": "itemTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 20,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "itemVsblty"
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "4dp",
                                    "orientation": "vertical"
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "marginBottom": "2dp",
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "visibility": "{{itemVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "text": "{{itemDesc}}",
                                                            "textColor": "#949494",
                                                            "visibility": "{{itemDescVsblty}}",
                                                            "textSize": "14dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "2dp",
                                                            "textStyle": "bold",
                                                            "text": "{{itemTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "24dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "56dp",
                                                    "height": "56dp",
                                                    "orientation": "horizontal",
                                                    "corner_radius": "4dp",
                                                    "marginLeft": "8dp",
                                                    "visibility": "{{itemMediaVsblty}}",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "width": "match",
                                                            "height": "match",
                                                            "scaleType": "fitXY",
                                                            "mediaUrl": "{{itemMedia}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{descVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "150"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName1}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty1}}"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName2}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty2}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - LMS 템플릿 문단형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "CLL00002",
            "formName": "LMS 템플릿 문단형",
            "cardType": "descriptionNew",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-10-19T22:20:54.000+09",
            "updateDate": "2024-06-21T14:49:21.000+09",
            "mediaUrl": [],
            "productCode": "lms",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 17,
                "maxButtonCount": 4,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty1"
                },
                {
                    "param": "description2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty2"
                },
                {
                    "param": "mTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleVsblty"
                },
                {
                    "param": "mTitleMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleMediaVsblty"
                },
                {
                    "param": "title1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty1"
                },
                {
                    "param": "title2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty2"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "{{mTitleVsblty}}",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "ImageView",
                                                    "width": "24dp",
                                                    "height": "24dp",
                                                    "corner_radius": "4dp",
                                                    "scaleType": "fitXY",
                                                    "marginRight": "4dp",
                                                    "visibility": "{{mTitleMediaVsblty}}",
                                                    "mediaUrl": "{{mTitleMedia}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{mTitle}}",
                                                    "textColor": "#1e1e1e",
                                                    "textAlignment": "textStart",
                                                    "textSize": "19dp"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "2dp",
                                            "widget": "View",
                                            "marginTop": "6dp",
                                            "background": "#1e1e1e"
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{descVsblty1}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title1}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty1}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description1}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "100"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "8dp",
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "weight": 1.0,
                                                    "width": "content",
                                                    "height": "36dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "text": "{{btnName1}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty1}}"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "weight": 1.0,
                                                    "width": "content",
                                                    "height": "36dp",
                                                    "marginLeft": "8dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty2}}"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{descVsblty2}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title2}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty2}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description2}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "100"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "8dp",
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "weight": 1.0,
                                                    "width": "content",
                                                    "height": "36dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "text": "{{btnName3}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty3}}"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "weight": 1.0,
                                                    "width": "content",
                                                    "height": "36dp",
                                                    "marginLeft": "8dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "text": "{{btnName4}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "{{btnVsblty4}}"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - LMS 템플릿 기본형 타이틀 강조" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseformId": "CLL00003",
            "formName": "LMS 템플릿 기본형 타이틀 강조",
            "cardType": "descriptionNew",
            "bizCondition": [],
            "bizCategory": null,
            "bizService": null,
            "registerDate": "2023-10-19T22:24:24.000+09",
            "updateDate": "2024-06-21T14:49:30.000+09",
            "mediaUrl": [],
            "productCode": "lms",
            "spec": "openrichcard",
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 17,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty"
                },
                {
                    "param": "mTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleVsblty"
                },
                {
                    "param": "mTitleMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleMediaVsblty"
                },
                {
                    "param": "title",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "{{mTitleVsblty}}",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{mTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "24dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "48dp",
                                                    "height": "48dp",
                                                    "orientation": "horizontal",
                                                    "corner_radius": "4dp",
                                                    "marginLeft": "8dp",
                                                    "visibility": "{{mTitleMediaVsblty}}",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "width": "match",
                                                            "height": "match",
                                                            "scaleType": "fitXY",
                                                            "mediaUrl": "{{mTitleMedia}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "{{descVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "150"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName1}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty1}}"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "{{btnName2}}",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "{{btnVsblty2}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 양식 로고 이미지 조회

## Request

## RBC에서 템플릿용으로 제공되는 기본 로고 이미지 정보를 조회합니다.<br>

> RBC에서 템플릿용으로 제공되는 기본 로고 이미지 정보를 조회합니다.  \
> \
> 조회된 이미지 파일 ID를 템플릿 등록 시 사용할 수 있습니다.  \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"MessagebaseformId":{"name":"messagebaseformId","in":"path","schema":{"type":"string"},"required":true,"description":"messagebaseform ID Path parameter 입니다."}}},"paths":{"/messagebase/messagebaseform/{messagebaseformId}/logo":{"get":{"summary":"RBC에서 템플릿용으로 제공되는 기본 로고 이미지 정보를 조회합니다.\n","description":"RBC에서 템플릿용으로 제공되는 기본 로고 이미지 정보를 조회합니다.  \n\n조회된 이미지 파일 ID를 템플릿 등록 시 사용할 수 있습니다.  \n  + **계정 권한 : 마스터, 매니저, 대행사**\n","parameters":[{"$ref":"#/components/parameters/MessagebaseformId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>로고 이미지 파일 ID 입니다.</td></tr><tr><td><strong><code>fileUrl</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>로고 이미지 파일 URL 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>로고 이미지 파일 이름 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
      {
        "fileId": "",
        "fileUrl": "",
        "fileName": ""
      }    
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 목록 조회

## Request

## 브랜드에 등록된 템플릿을 조회합니다.<br>

> 브랜드에 등록된 템플릿을 조회합니다. 템플릿 별 승인 상태를 확인할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/brand/{brandId}/messagebase":{"get":{"summary":"브랜드에 등록된 템플릿을 조회합니다.\n","description":"브랜드에 등록된 템플릿을 조회합니다. 템플릿 별 승인 상태를 확인할 수 있습니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>Messagebase 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="208">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 ID</td></tr><tr><td><strong><code>tmpltName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록시 입력된 템플릿 명칭입니다.</td></tr><tr><td><strong><code>messagebaseformId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿의 원형인 템플릿 양식 ID 입니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿이 등록되어 있는 브랜드 ID 입니다. 공통으로 사용하는 템플릿인 경우 'common'으로 표시됩니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>템플릿의 상태를 표시합니다.</p><ul><li>ready : 사용</li><li>pause : 사용중지</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>템플릿의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 템플릿 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 템플릿은 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 템플릿 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 템플릿 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 템플릿은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 템플릿 변경 승인요청 직후 검수 이전 상태입니다.</li><li>검수시작(수정) : 승인된 템플릿 변경으로 승인요청된 템플릿 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 템플릿 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 수정 계정 ID</td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test20240620",
            "tmpltName": "SNS형 (중간버튼)",
            "messagebaseformId": "ITCRM3",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:33:23.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:33:23.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test2024062010",
            "tmpltName": "이미지 강조형 (1:1)",
            "messagebaseformId": "ITHIMS",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:22:36.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:22:36.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test2024062006",
            "tmpltName": "SNS형 (중간버튼)",
            "messagebaseformId": "ITSNSH",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:17:01.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:17:01.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2024062004",
            "tmpltName": "썸네일형 (가로)",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:11:34.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:11:34.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test2024062002",
            "tmpltName": "이미지 강조형 (1:1)",
            "messagebaseformId": "ITHITS",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:08:06.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:08:06.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test2024062001",
            "tmpltName": "이미지 & 타이틀 강조형 (1:1)",
            "messagebaseformId": "ITHITS",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:01:14.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:01:14.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2022072606",
            "tmpltName": "테마 강조형A 서술",
            "messagebaseformId": "TATA001C",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-19T11:11:39.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-19T11:11:39.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2024061905",
            "tmpltName": "테마 강조형A 서술",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-19T11:06:48.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-19T11:06:48.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test202406183",
            "tmpltName": "테스트-출고(Cell)",
            "messagebaseformId": "CC001C",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": null,
            "registerDate": "2024-06-19T10:12:05.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-19T10:12:05.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2024061901",
            "tmpltName": "인증desc",
            "messagebaseformId": "GG002D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": null,
            "registerDate": "2024-06-19T10:06:02.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-19T10:06:02.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-60JruEbrS2kBP55tU9SLWW3p5",
            "tmpltName": "승인내역",
            "messagebaseformId": "FF001C",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-18T18:03:47.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-18T18:03:47.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-3p807611jWP61Rn1BlBMPA095",
            "tmpltName": "승인번호템플릿",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-18T17:47:44.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-18T17:47:44.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2022072604",
            "tmpltName": "테마 강조형A 서술",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": null,
            "registerDate": "2024-06-18T17:38:07.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-18T17:38:07.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 13
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 상세 조회

## Request

## 브랜드에 등록된 지정 템플릿 상세 내역을 조회합니다.<br>

> 브랜드에 등록된 지정 템플릿 상세 내역을 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"MessagebaseId":{"name":"messagebaseId","in":"path","schema":{"type":"string"},"required":true,"description":"messagebase ID Path parameter 입니다."}}},"paths":{"/brand/{brandId}/messagebase/{messagebaseId}":{"get":{"summary":"브랜드에 등록된 지정 템플릿 상세 내역을 조회합니다.\n","description":"브랜드에 등록된 지정 템플릿 상세 내역을 조회합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/MessagebaseId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>Messagebase 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="212">필드명</th><th width="145">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="97">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>템플릿 ID</td></tr><tr><td><strong><code>tmpltName</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>템플릿 등록시 입력된 템플릿 명칭입니다.</td></tr><tr><td><strong><code>messagebaseformId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>템플릿의 원형인 템플릿 양식 ID 입니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>템플릿이 등록되어 있는 브랜드 ID 입니다. 공통으로 사용하는 템플릿인 경우 'common'으로 표시됩니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿의 상태를 표시합니다.<br>ready : 사용 pause : 사용중지</td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>템플릿의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 템플릿 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 템플릿은 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 템플릿 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 템플릿 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 템플릿은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 템플릿 변경 승인요청 직후 검수 이전 상태입니다.</li><li>검수시작(수정) : 승인된 템플릿 변경으로 승인요청된 템플릿 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 템플릿 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>템플릿 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>템플릿 수정 계정 ID</td></tr><tr><td><strong><code>productCode</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>메시지 상품 종류 구분값입니다.<br>"sms", "lms", "mms", "tmplt", "itmpl"</td></tr><tr><td><strong><code>spec</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃 구조가 리치카드인지 오픈리치카드인지 구분합니다.</p><p>"richcard", "openrichcard"<br><br>AOS/iOS 26 통합 지원 규격이 추가되었습니다.<br>"richcardPlus"</p></td></tr><tr><td><strong><code>cardType</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td><p>카드종류를 구분합니다. 향후 추가될 수 있습니다.</p><ul><li>standalone</li><li>standalone horizontal</li><li>standalone media top - carousel</li><li>carousel medium</li><li>carousel small</li><li>Highlighted Image n Title</li><li>Highlighted Image</li><li>Thumbnail</li><li>SNS</li><li>Description</li><li>Cell</li><li>Free</li></ul></td></tr><tr><td><strong><code>agencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>템플릿을 대행사가 등록한 경우, 등록한 대행사ID 입니다.</td></tr><tr><td><strong><code>inputText</code></strong></td><td>string</td><td align="center">300</td><td align="center"></td><td></td><td>정보성 텍스트 템플릿 서술(Description)인 경우, 템플릿 등록시 입력한 원본 문장을 제공합니다.</td></tr><tr><td><strong><code>attribute</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>통계용 속성 정보 제공 목적의 필드이며, messagebaseform의 [bizCondition, bizCategory, bizService] 로 구성된 배열입니다.</td></tr><tr><td><a href="#guideinfo-object"><mark style="color:blue;"><strong><code>guideInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 작성에 필요한 가이드 정보를 제공하기 위하여 양식 정의 시 포함되는 정보입니다. 리치카드의 경우 messagebaseInfo에서 제공됩니다.</td></tr><tr><td><a href="#policyinfo-object"><mark style="color:blue;"><strong><code>policyInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>리치카드, 오픈리치카드에 포함된 content(title, description, media, button) 에 대한 검증 정책 저장을 위한 객체입니다.</td></tr><tr><td><a href="#params-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>params</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>템플릿의 개별 파라미터를 검수하기 위한 대상 파라미터 정보 객체입니다. 크기 관련 필드는 &#x3C;=0 인 경우 체크하지 않습니다.</td></tr><tr><td><a href="#files-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>files</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 템플릿용 파일 등록 정보입니다.</td></tr><tr><td><strong><code>formattedString</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>GSMA 및 TTA RCS 규격이며 JSON 형식으로 정의된 템플릿의 레이아웃 데이터입니다.</td></tr></tbody></table>

{% hint style="info" %}
GSMA RCC.07-v11.0 참조\
<https://www.gsma.com/solutions-and-impact/technologies/networks/wp-content/uploads/2019/10/RCC.07-v11.0.pdf>
{% endhint %}

{% hint style="info" %}
TTAK.KO-06.0410/R7 참조

<https://committee.tta.or.kr/data/standard_view.jsp?secondDepthCode=PG1105&firstDepthCode=TC011&pk_num=TTAK.KO-06.0410/R7&commit_code=PG1105>
{% endhint %}

### <mark style="color:blue;">guideInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="111">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>maxLineCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>max 라인수</td></tr><tr><td><strong><code>maxDisplayText</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼명 글자수</td></tr><tr><td><strong><code>maxDescriptionSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>카드별 max 본문 글자수</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 권고 가로 사이즈 단위는 Pixel</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 권고 세로 사이즈 단위는 Pixel</td></tr><tr><td><a href="#detailinfo-object"><mark style="color:blue;"><strong><code>detailInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td><p>리치카드 메시지 상품별 1라인당 글자수, 타이틀 라인수 및 버튼 수에 따라 메시지가 잘려 보이지 않는 최대 라인수 정보를 제공합니다.</p><p>메시지가 수신된 단말에 따라 상이할 수 있으나 리치카드 RCS메시지 발송 시 권장사항으로 참고하시기 바랍니다.</p><p>LMS와 MMS 12종 총 13종에 대해 개별 제공됩니다.</p></td></tr></tbody></table>

### <mark style="color:blue;">detailInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>productCardType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>상품 카드 종류</td></tr><tr><td><strong><code>releaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>정보 제공 일자(내용 수정시 일시 변경)</td></tr><tr><td><strong><code>summary</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>요약 정보</td></tr><tr><td><strong><code>charactersPerLine</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>각 항목 별 권장 라인당 글자수</td></tr><tr><td><strong><code>combinations</code></strong></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>디스크립션 권장 라인수 조합</td></tr></tbody></table>

### <mark style="color:blue;">policyInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="224">필드명</th><th width="102">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="88">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonsAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>MaaP FE /message의 buttons 사용 유무 -</p><ul><li>true : buttons 필드 사용</li><li>false : buttons 에 값이 들어오면 실패 처리</li></ul></td></tr><tr><td><strong><code>adHeaderAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>header에 광고 인입 허가 여부</p><ul><li>true : 광고인입 허용(MaaP FE /message의 header 체크안함)</li><li>false : 광고인입 불허(MaaP FE /message이 header가 1(광고) 이면 실패 처리)</li></ul></td></tr><tr><td><strong><code>adBodyAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td><p>광고 문구 허용 여부</p><ul><li>true : 본문 광고 문구를 체크하지 않음.</li><li>false : 본문이 "(광고)"로 시작하면 실패 처리</li></ul></td></tr><tr><td><strong><code>cardCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>카드 개수</td></tr><tr><td><strong><code>maxTitleSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>개별 타이틀 글자 최대 수. 사용하지 않음.</td></tr><tr><td><strong><code>maxButtonCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼 최대 개수</td></tr><tr><td><strong><code>maxDescriptionSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td><ul><li>RichCard인 경우(Carousel포함) Description들의 글자수 총합.</li><li>OpenRichCard인 경우 변수부 글자수 총합. &#x3C;=0 인 경우 사용하지 않음.</li></ul></td></tr><tr><td><strong><code>maxMediaSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>Byte단위 미디어 크기 총합의 최대 크기, &#x3C;=0 인 경우 사용하지 않음.</td></tr></tbody></table>

### <mark style="color:blue;">params</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="155">필드명</th><th width="152">타입</th><th width="87" align="center">길이</th><th width="108" align="center">필수여부</th><th width="82">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>param</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>검수 파라미터명. (영문, 한글, 숫자, '_' 만 사용)</td></tr><tr><td><strong><code>isMandatory</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>필수여부.</p><ul><li>true인 경우 중계사에서 메시지 전송 요청 시 해당 필드가 없는 경우 MaaP FE에서 실패처리한다.</li><li>false인 경우는 해당 필드가 없는 경우도 메시지 전송이 되도록 MaaP FE에서 적절하게 처리한다.</li></ul></td></tr><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>기술검사타입을 지정합니다.</p><ul><li>string: 문자열 검사 대상</li><li>file: 파일 검사 대상</li><li>button: formattedString 내 button 제어 대상</li><li>layout: formattedString 내 button외 제어 대상</li></ul></td></tr><tr><td><strong><code>contentType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>컨텐츠 유형, PolicyInfo 정책을 검사하는데 사용됩니다.</p><ul><li>title: 메시지 상품 제한 글자수에 포함되지 않는 유형</li><li>description: 메시지 상품 제한 글자수에 포함되며 템플릿 등록 문장 패턴 검사 대상</li><li>maapfile: 메시지 내 표시되는 이미지/영상 등의 fileId 지정 대상</li><li>cell: 메시지 상품 제한 글자수에 포함되며 템플릿 등록 문장 패턴 검사 제외</li><li>displayText: Suggested Actions 규격의 버튼명 </li><li>url: URL 형식 체크 대상</li><li>etc: 템플릿 등록 시 버튼 Action 중 URL을 제외한 나머지 Action 내  사용자 지정 변수</li><li>buttonName: Button 위젯의 버튼명</li><li>visibility: 메시지 표시 영역 별 표시 제어 영역</li><li>notice: 메시지 상품 제한 글자수에 포함되지 않는 유형</li></ul></td></tr><tr><td><strong><code>strSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>글자 최대 크기, type이 string인 경우</td></tr><tr><td><strong><code>fileSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>파일 최대 크기, type이 file인 경우.</td></tr><tr><td><strong><code>strRegx</code></strong></td><td>string</td><td align="center">65535</td><td align="center"></td><td></td><td><p>java regular expression, null 인경우 사용하지 않음. 예)</p><ol><li>숫자만 : '^[0-9]*$'</li><li>영문자만 : '[a-zA-Z]*$'</li><li>한글만 : '^[가-힣]*$'</li><li>영어 &#x26; 숫자만 : '^[a-zA-Z0-9]*$'</li><li>E-Mail : '^[a-zA-Z0-9]+@[a-zA-Z0-9]+$'</li><li>휴대폰 : '^01(?:0|1|[6-9])-(?:\d{3}|\d{4})-\d{4}$'</li><li>일반전화 : '^\d{2,3}-\d{3,4}-\d{4}$'</li><li>주민등록번호 : '\d{6}-[1-4]\d{6}'</li><li>IP 주소 : '([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3})'</li></ol></td></tr><tr><td><strong><code>verification</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>문장 패턴 정의 (SKT향)<br>"안녕하세요", "님 ", "원입니다."</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 해상도 가로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 해상도 세로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)</td></tr><tr><td><strong><code>couplingId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>파라미터 간 함께 처리되어야 하는 경우 동일한 값을 부여 즉, 같은 값의 couplingId가 지정되는 경우 지정된 파라미터는 모두 조건을 만족해야 정상 발송 처리됨</td></tr><tr><td><strong><code>inputText</code></strong></td><td>string</td><td align="center">65535</td><td align="center"></td><td></td><td>템플릿 등록시 사용자 입력한 원본 문장(고정부 &#x26; 변수부)을 제공합니다. 단, cell방식의 타이틀 선택형은 제공되지 않습니다.</td></tr><tr><td><strong><code>relationId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>param과 관계가 있는 param을 의미합니다. 주로 현재 param이 입력되지 않을 경우 메시지 상에 노출여부와 연관된 visibility에 지정된 param을 표시합니다. 메시지 발송시 이통MaaP FE에서 핸들링하는 것으로 템플릿 등록이나 메시지 발송 param과는 무관하며, 참조 용도로 제공됩니다.</td></tr><tr><td><strong><code>setViewAll</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>true</td><td><p></p><p>viewAll 설정 여부를 지정합니다. </p><p></p><p>viewAll(모두보기) 활성화 여부를 지정합니다.</p><p>messagebaseform.params의 각 Object 내 setViewAll이 포함된 Object에서만 사용 가능하며, 사용될 수 없는 Object에서 사용 시 무시됩니다.</p><p>활성화 여부만 선택 가능하며, 활성화 시 viewAll의 글자수는 RBC 내부 로직에 의해 지정됩니다.</p><ul><li>true: 메시지 내 대상 파라미터 viewAll(모두보기) 활성화</li><li>false: 메시지 내 대상 파라미터 viewAll(모두보기) 비활성화</li></ul><p>※ viewAll은 메시지 내 문자열이 표시되는 영역에 설정된 글자수 이상이 입력된 경우, 대상 영역을 '모두보기 >' 표시와 함께 접힌 상태로 표시하는 메시지 규격입니다.</p></td></tr><tr><td><strong><code>viewAll</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>150</td><td><p></p><p>viewAll(모두보기) 접힘 글자수 기준값을 지정합니다.</p><p>messagebaseform.params의 각 Object 내 viewAll이 포함된 Object에서만 사용 가능하며, 사용될 수 없는 Object에서 사용 시 무시됩니다.</p><ul><li>유효값: 150(default), 300</li><li>유효값 이외 수치가 입력되는 경우 default로 처리됩니다.</li></ul></td></tr></tbody></table>

### <mark style="color:blue;">files</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="100">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="94">기본값</th><th>설명</th></tr></thead><tbody><tr><td>fileId</td><td>string</td><td align="center">64</td><td align="center">O</td><td></td><td>등록된 파일의 ID 입니다.</td></tr><tr><td>url</td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>등록된 파일의 URL 정보 입니다.</td></tr><tr><td>fileName</td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr><tr><td>imageWidth</td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 가로 크기 입니다.</td></tr><tr><td>imageHeight</td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 세로 크기 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200 - 타이틀자유형-스타일" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "UBR.61hBmMP164-test2024062105",
            "tmpltName": "타이틀자유형-스타일",
            "messagebaseformId": "TATA001C",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:16:08.000+09",
            "approvalDate": "2024-07-10T11:24:26.000+09",
            "updateDate": "2024-07-10T11:24:26.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "tmplt",
            "spec": "openrichcard",
            "cardType": "cell",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                "타이틀 자유형",
                "타이틀 자유형"
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 90,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 0,
                "maxButtonCount": 2,
                "maxDescriptionSize": 86,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": false,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "5",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "c4",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "cell",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "지점번호",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "etc",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "textAlignment": "textStart",
                                                    "text": "제목",
                                                    "textColor": "#232323",
                                                    "textSize": "19dp",
                                                    "weight": "1"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "textAlignment": "textEnd",
                                                    "text": "",
                                                    "textColor": "#0094ff",
                                                    "textSize": "19dp",
                                                    "weight": "1",
                                                    "visibility": "gone"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "3dp",
                                            "widget": "View",
                                            "background": "#232323",
                                            "visibility": "visible",
                                            "marginTop": "10dp",
                                            "marginBottom": "12dp"
                                        },
                                        {
                                            "width": "match",
                                            "height": "content",
                                            "widget": "LinearLayout",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "text": "{{1}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "18dp",
                                                            "textColor": "#232329",
                                                            "textAlignment": "textStart",
                                                            "textStyle": "bold"
                                                        },
                                                        {
                                                            "text": "{{2}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "text": "{{3}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "20dp",
                                                            "textColor": "#122329",
                                                            "textAlignment": "textEnd",
                                                            "textStyle": "bold"
                                                        },
                                                        {
                                                            "text": "{{c4}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textEnd"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "1dp",
                                                    "widget": "View",
                                                    "background": "#232323",
                                                    "visibility": "visible",
                                                    "marginTop": "12dp",
                                                    "marginBottom": "12dp"
                                                },
                                                {
                                                    "width": "match",
                                                    "height": "content",
                                                    "widget": "LinearLayout",
                                                    "visibility": "visible",
                                                    "orientation": "horizontal",
                                                    "children": [
                                                        {
                                                            "text": "{{5}}",
                                                            "width": "match",
                                                            "height": "content",
                                                            "weight": 1.0,
                                                            "widget": "TextView",
                                                            "textSize": "16dp",
                                                            "textColor": "#232323",
                                                            "textAlignment": "textStart"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#EAEAEA",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "고객센터",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "dialerAction": {
                                                                "dialPhoneNumber": {
                                                                    "phoneNumber": "1522{{지점번호}}"
                                                                }
                                                            },
                                                            "displayText": "고객센터",
                                                            "postback": {
                                                                "data": "set_by_chatbot_dial_phone_number"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible",
                                                    "marginTop": "12dp"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#EAEAEA",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "gone",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 타이틀자유형-서술" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "UBR.61hBmMP164-test2024061905",
            "tmpltName": "타이틀자유형-서술",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:16:47.000+09",
            "approvalDate": "2024-07-10T11:36:21.000+09",
            "updateDate": "2024-07-10T11:36:21.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "tmplt",
            "spec": "openrichcard",
            "cardType": "description",
            "agencyId": null,
            "inputText": "내일 서울 낮 기온은 {{내일기온}}도로 오늘보다 {{온도차이}}도 정도 더 높겠습니다.",
            "attribute": [
                "인터넷/컴퓨터",
                "타이틀 자유형",
                "타이틀 자유형"
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 90,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 0,
                "maxButtonCount": 2,
                "maxDescriptionSize": 90,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": false,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(내일 서울 낮 기온은 ).+(도로 오늘보다 ).+(도 정도 더 높겠습니다\\.)$",
                    "verification": [
                        "내일 서울 낮 기온은 ",
                        "도로 오늘보다 ",
                        "도 정도 더 높겠습니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "내일 서울 낮 기온은 {{내일기온}}도로 오늘보다 {{온도차이}}도 정도 더 높겠습니다.",
                    "relationId": null
                },
                {
                    "param": "지점번호",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "etc",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "textAlignment": "textStart",
                                                    "text": "제목",
                                                    "textColor": "#232323",
                                                    "textSize": "19dp",
                                                    "weight": "1"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "textAlignment": "textEnd",
                                                    "text": "",
                                                    "textColor": "#0094ff",
                                                    "textSize": "19dp",
                                                    "weight": "1",
                                                    "visibility": "gone"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "3dp",
                                            "widget": "View",
                                            "background": "#232323",
                                            "visibility": "visible",
                                            "marginTop": "10dp",
                                            "marginBottom": "12dp"
                                        },
                                        {
                                            "widget": "TextView",
                                            "width": "match",
                                            "height": "content",
                                            "text": "{{description}}",
                                            "textColor": "#232323",
                                            "textSize": "16dp"
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#EAEAEA",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "url 연결_수정",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "displayText": "url 연결_수정",
                                                            "postback": {
                                                                "data": "set_by_chatbot_open_url"
                                                            },
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": "https://phoneppu.com"
                                                                }
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible",
                                                    "marginTop": "12dp"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#EAEAEA",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "고객센터",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "dialerAction": {
                                                                "dialPhoneNumber": {
                                                                    "phoneNumber": "1522{{지점번호}}"
                                                                }
                                                            },
                                                            "displayText": "고객센터",
                                                            "postback": {
                                                                "data": "set_by_chatbot_dial_phone_number"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 이미지&타이틀 강조형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "IBR.61hBmMP164-test2024062001",
            "tmpltName": "이미지&타이틀 강조형",
            "messagebaseformId": "ITHITS",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:17:21.000+09",
            "approvalDate": "2024-07-10T12:59:46.000+09",
            "updateDate": "2024-07-10T12:59:46.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "itmpl",
            "spec": "openrichcard",
            "cardType": "Highlighted Image n Title",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 150,
                "imageWidth": "900",
                "imageHeight": "900",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "abvc",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "subDesc1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 33,
                    "fileSize": null,
                    "strRegx": "^(최근 여행업계에는 다시 ‘봄’이 찾아온 모습이다\\.)$",
                    "verification": [
                        "최근 여행업계에는 다시 ‘봄’이 찾아온 모습이다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "최근 여행업계에는 다시 ‘봄’이 찾아온 모습이다.",
                    "relationId": null
                },
                {
                    "param": "subDesc2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 33,
                    "fileSize": null,
                    "strRegx": "^(제주도는 내국인 관광객 1000만 명을 돌파했다\\.)$",
                    "verification": [
                        "제주도는 내국인 관광객 1000만 명을 돌파했다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "제주도는 내국인 관광객 1000만 명을 돌파했다.",
                    "relationId": null
                },
                {
                    "param": "subDesc3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 33,
                    "fileSize": null,
                    "strRegx": "^.+(의 긍정적인 부분은 이 숫자 역시 빠르게 회복 중이라는 것)$",
                    "verification": [
                        "",
                        "의 긍정적인 부분은 이 숫자 역시 빠르게 회복 중이라는 것"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{이것}}의 긍정적인 부분은 이 숫자 역시 빠르게 회복 중이라는 것",
                    "relationId": null
                },
                {
                    "param": "subTitle1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 4,
                    "fileSize": null,
                    "strRegx": "^(이벤트)$",
                    "verification": [
                        "이벤트"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "이벤트",
                    "relationId": null
                },
                {
                    "param": "subTitle2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 4,
                    "fileSize": null,
                    "strRegx": "^(여행업계)$",
                    "verification": [
                        "여행업계"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "여행업계",
                    "relationId": null
                },
                {
                    "param": "subTitle3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 4,
                    "fileSize": null,
                    "strRegx": "^(가을여행)$",
                    "verification": [
                        "가을여행"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "가을여행",
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": "^(메리어트 창립 95주년을 맞아 한국을 찾았다\\.)$",
                    "verification": [
                        "메리어트 창립 95주년을 맞아 한국을 찾았다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "메리어트 창립 95주년을 맞아 한국을 찾았다.",
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "horizontal",
                                    "children": [
                                        {
                                            "widget": "ImageView",
                                            "width": "match",
                                            "height": "content",
                                            "scaleType": "fitXY",
                                            "mediaUrl": "maapfile://LT-logo.common-Efehqa",
                                            "click": {
                                                "action": {
                                                    "urlAction": {
                                                        "openUrl": {
                                                            "url": "https://post.naver.com/viewer/postView.naver?memberNo=49797427&volumeNo=34609427&abvc={{abvc}}"
                                                        }
                                                    },
                                                    "displayText": "메인이미지",
                                                    "postback": {
                                                        "data": "set_by_chatbot_open_url"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "TextView",
                                            "width": "match",
                                            "height": "content",
                                            "textStyle": "bold",
                                            "text": "{{title}}",
                                            "textColor": "#232323",
                                            "textSize": "17dp",
                                            "marginBottom": "16dp",
                                            "visibility": "visible"
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "60dp",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{subTitle1}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "marginLeft": "16dp",
                                                            "text": "{{subDesc1}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp",
                                                            "weight": "1"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "visibility": "visible",
                                                    "marginTop": "6dp",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "60dp",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{subTitle2}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "marginLeft": "16dp",
                                                            "text": "{{subDesc2}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp",
                                                            "weight": "1"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "visibility": "visible",
                                                    "marginTop": "6dp",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "60dp",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{subTitle3}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "marginLeft": "16dp",
                                                            "text": "{{subDesc3}}",
                                                            "textColor": "#232323",
                                                            "textSize": "16dp",
                                                            "weight": "1"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName1}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "marginTop": "16dp",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "gone",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 이미지강조형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "IBR.61hBmMP164-test2024062010",
            "tmpltName": "이미지강조형",
            "messagebaseformId": "ITHIMS",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:17:38.000+09",
            "approvalDate": "2024-07-10T13:04:41.000+09",
            "updateDate": "2024-07-10T13:04:41.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "itmpl",
            "spec": "openrichcard",
            "cardType": "Highlighted Image",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 150,
                "imageWidth": "900",
                "imageHeight": "900",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 150,
                    "fileSize": null,
                    "strRegx": "^(코로나19 사태 이전의 수요를 회복한 것을 넘어 더욱 성장했다는 점에서 큰 의미가 있다\\. 앞으로의 전망도 밝다\\. 최근의 상황을 봤을 때 4분기에는 코로나19 사태 이후 처음으로 객실 예약률이 ).+(%가 넘을 것으로 예측된다\\.)$",
                    "verification": [
                        "코로나19 사태 이전의 수요를 회복한 것을 넘어 더욱 성장했다는 점에서 큰 의미가 있다. 앞으로의 전망도 밝다. 최근의 상황을 봤을 때 4분기에는 코로나19 사태 이후 처음으로 객실 예약률이 ",
                        "%가 넘을 것으로 예측된다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "코로나19 사태 이전의 수요를 회복한 것을 넘어 더욱 성장했다는 점에서 큰 의미가 있다. 앞으로의 전망도 밝다. 최근의 상황을 봤을 때 4분기에는 코로나19 사태 이후 처음으로 객실 예약률이 {{퍼센트}}%가 넘을 것으로 예측된다.",
                    "relationId": null
                },
                {
                    "param": "shop",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": "^(한국 시장의 2022년 3분기 예측)$",
                    "verification": [
                        "한국 시장의 2022년 3분기 예측"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "한국 시장의 2022년 3분기 예측",
                    "relationId": null
                },
                {
                    "param": "복사텍스트",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "etc",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "horizontal",
                                    "children": [
                                        {
                                            "widget": "ImageView",
                                            "width": "match",
                                            "height": "content",
                                            "scaleType": "fitXY",
                                            "mediaUrl": "maapfile://LT-logo.common-Efehqa",
                                            "click": {
                                                "action": {
                                                    "urlAction": {
                                                        "openUrl": {
                                                            "url": "https://www.kurly.com/{{shop}}/event/kurlyEvent.php?htmid=event%2Fjoin%2Fjoin&%243p=a_custom_741527000799871056&%24deeplink_path=home&%24android_passive_deepview=false&%24ios_passive_deepview=false&~tags=3004&~stage=2210&~campaign=1000072629&~keyword=non_time_B_101412&utm_source=3004&utm_medium=2210&utm_campaign=1000072629&utm_content=non_time_B_101412&_branch_match_id=1037612873204479401&_branch_referrer=H4sIAAAAAAAAA32P3W6EIBSEnwYvFdCV2oQ0bXb3oi9BWKQLVX4iKNm3L2h71aYJyeGbM0wGFaMPz00zrcv8qLn39azt1Kj3KBLp57O4vQDctZ5yJtYQnWGkQydMIIRkGJ4Igqe%2Byo5RSl9eMs%2BjosoZWVRux8XpMYsh6E2y4tq0TPSDz2F3aBf%2B2ebLfONiYrkdVaUqaF8BvuaTUqqP0sKZzEE5n4fcpI157qtLgdorD9qrikaPoD3%2FGD6dtt%2BjAuQS%2BT3QFsKuQMgkKcYIFhLceK7vliJYfo17PBR5ko%2FklpFaZ1nURrI3hiDqEK7WaFhw6yLkkVjYyFGv5sgs%2FFforjsbc8HfqV%2BPT9huqQEAAA%3D%3D"
                                                        }
                                                    },
                                                    "displayText": "메인이미지",
                                                    "postback": {
                                                        "data": "set_by_chatbot_open_url"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "background": "#F2F2F2",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{title}}",
                                                    "textColor": "#232323",
                                                    "textSize": "17dp",
                                                    "marginBottom": "10dp",
                                                    "visibility": "visible"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#232323",
                                                    "textSize": "16dp",
                                                    "weight": "1"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "서울역",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "marginTop": "16dp",
                                                    "click": {
                                                        "action": {
                                                            "mapAction": {
                                                                "showLocation": {
                                                                    "location": {
                                                                        "latitude": "14133843.9742104",
                                                                        "longitude": "4516756.2469226",
                                                                        "label": "서울역"
                                                                    },
                                                                    "fallbackUrl": "https://info.korail.com/info/index.do"
                                                                }
                                                            },
                                                            "displayText": "서울역",
                                                            "postback": {
                                                                "data": "set_by_chatbot_show_location"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "복사하기",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "clipboardAction": {
                                                                "copyToClipboard": {
                                                                    "text": "{{복사텍스트}} 되었습니다."
                                                                }
                                                            },
                                                            "displayText": "복사하기",
                                                            "postback": {
                                                                "data": "set_by_chatbot_copy_to_clipboard"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 썸네일형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "IBR.61hBmMP164-test2024062004",
            "tmpltName": "썸네일형",
            "messagebaseformId": "ITTBNH",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T13:47:40.000+09",
            "approvalDate": "2024-07-10T13:48:14.000+09",
            "updateDate": "2024-07-10T13:48:14.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "itmpl",
            "spec": "openrichcard",
            "cardType": "Thumbnail",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 150,
                "imageWidth": "900",
                "imageHeight": "560",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "articleId1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "articleId2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 150,
                    "fileSize": null,
                    "strRegx": "^(2018년부터 오픈한 호텔이 ).+(개에 달한다\\. 그리고 내년 초까지 ).+( 등에 총 5개의 신규 호텔이 문을 연다\\. 이렇게 되면 총 18개의 호텔을 한국에서 운영하게 된다\\.)$",
                    "verification": [
                        "2018년부터 오픈한 호텔이 ",
                        "개에 달한다. 그리고 내년 초까지 ",
                        " 등에 총 5개의 신규 호텔이 문을 연다. 이렇게 되면 총 18개의 호텔을 한국에서 운영하게 된다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "2018년부터 오픈한 호텔이 {{오픈개수}}개에 달한다. 그리고 내년 초까지 {{신규도시}} 등에 총 5개의 신규 호텔이 문을 연다. 이렇게 되면 총 18개의 호텔을 한국에서 운영하게 된다.",
                    "relationId": null
                },
                {
                    "param": "URL1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "URL2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "url",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "horizontal",
                                    "children": [
                                        {
                                            "widget": "ImageView",
                                            "width": "match",
                                            "height": "content",
                                            "scaleType": "fitXY",
                                            "mediaUrl": "maapfile://LT-logo.common-34FDUE",
                                            "click": {
                                                "action": {
                                                    "urlAction": {
                                                        "openUrl": {
                                                            "url": "https://www.paris.co.kr/{{URL1}}/{{URL2}}"
                                                        }
                                                    },
                                                    "displayText": "메인이미지",
                                                    "postback": {
                                                        "data": "set_by_chatbot_open_url"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{title}}",
                                                    "textColor": "#232323",
                                                    "textSize": "17dp",
                                                    "marginBottom": "10dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#232323",
                                                    "textSize": "16dp",
                                                    "weight": "1"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "marginTop": "16dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "0dp",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "background": "#ffd400",
                                                            "width": "match",
                                                            "height": "content",
                                                            "corner_radius": "4dp",
                                                            "scaleType": "fitCenter",
                                                            "mediaUrl": "maapfile://BLG-BR.61hBmMP164-7S9B",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": "https://n.news.naver.com/article/016/{{articleId1}}"
                                                                        }
                                                                    },
                                                                    "displayText": "서브이미지1",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "0dp",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "weight": "1",
                                                    "marginLeft": "10dp",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "background": "#ffd400",
                                                            "width": "match",
                                                            "height": "content",
                                                            "corner_radius": "4dp",
                                                            "scaleType": "fitCenter",
                                                            "mediaUrl": "maapfile://BLG-BR.61hBmMP164-7S9B",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": "https://n.news.naver.com/article/050/{{articleId2}}"
                                                                        }
                                                                    },
                                                                    "displayText": "서브이미지2",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "0dp",
                                                    "height": "content",
                                                    "orientation": "horizontal",
                                                    "weight": "1",
                                                    "marginLeft": "10dp",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "background": "#ffd400",
                                                            "width": "match",
                                                            "height": "content",
                                                            "corner_radius": "4dp",
                                                            "scaleType": "fitCenter",
                                                            "mediaUrl": "maapfile://BLG-BR.61hBmMP164-7S9B",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "서브이미지3",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName1}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "marginTop": "16dp",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "gone",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - SNS형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "IBR.61hBmMP164-test2024062006",
            "tmpltName": "SNS형",
            "messagebaseformId": "ITSNSH",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:18:09.000+09",
            "approvalDate": "2024-07-10T13:05:28.000+09",
            "updateDate": "2024-07-10T13:05:28.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "itmpl",
            "spec": "openrichcard",
            "cardType": "SNS",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 16,
                "maxDescriptionSize": 150,
                "imageWidth": "900",
                "imageHeight": "560",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 150,
                    "fileSize": null,
                    "strRegx": "^(앞으로 ').+(김밥', ').+(떡볶이'등 ').+('이라는 단어를 상품명 앞에 붙일 수 없을 것으로 보인다\\.)$",
                    "verification": [
                        "앞으로 '",
                        "김밥', '",
                        "떡볶이'등 '",
                        "'이라는 단어를 상품명 앞에 붙일 수 없을 것으로 보인다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "앞으로 '{{금지단어}}김밥', '{{금지단어}}떡볶이'등 '{{금지단어}}'이라는 단어를 상품명 앞에 붙일 수 없을 것으로 보인다.",
                    "relationId": null
                },
                {
                    "param": "title",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": "^(상품명에 '마약' 이름 못쓴다\\.)$",
                    "verification": [
                        "상품명에 '마약' 이름 못쓴다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "상품명에 '마약' 이름 못쓴다.",
                    "relationId": null
                },
                {
                    "param": "이벤트설명",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "etc",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "padding": "20dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{title}}",
                                                    "textColor": "#232323",
                                                    "textSize": "17dp",
                                                    "marginBottom": "10dp",
                                                    "visibility": "visible"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#232323",
                                                    "textSize": "16dp",
                                                    "weight": "1"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "호텔 숙박 이벤트를 실시합니다",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "marginTop": "16dp",
                                                    "click": {
                                                        "action": {
                                                            "calendarAction": {
                                                                "createCalendarEvent": {
                                                                    "startTime": "2022-09-01T00:00:00.000+09",
                                                                    "endTime": "2022-09-30T00:00:00.000+09",
                                                                    "title": "호텔 숙박 이벤트를 실시합니다!",
                                                                    "description": "{{이벤트설명}}"
                                                                }
                                                            },
                                                            "displayText": "호텔 숙박 이벤트를 실시합니다",
                                                            "postback": {
                                                                "data": "set_by_chatbot_create_calendar_event"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "width": "match",
                                                    "height": "42dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#0094ff",
                                                    "textSize": "16dp",
                                                    "text": "현재위치를 보내드립니다",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "mapAction": {
                                                                "requestLocationPush": {}
                                                            },
                                                            "displayText": "현재위치를 보내드립니다",
                                                            "postback": {
                                                                "data": "set_by_chatbot_request_location_push"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible",
                                                    "marginTop": "8dp"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "horizontal",
                                    "children": [
                                        {
                                            "widget": "ImageView",
                                            "width": "match",
                                            "height": "content",
                                            "scaleType": "fitXY",
                                            "mediaUrl": "maapfile://LT-logo.common-34FDUE",
                                            "click": {
                                                "action": {
                                                    "urlAction": {
                                                        "openUrl": {
                                                            "url": "http://rcsbizcenter.com"
                                                        }
                                                    },
                                                    "displayText": "메인이미지",
                                                    "postback": {
                                                        "data": "set_by_chatbot_open_url"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 슬라이드형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "IBR.61hBmMP164-test20240620",
            "tmpltName": "슬라이드형",
            "messagebaseformId": "ITCRM3",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:18:25.000+09",
            "approvalDate": "2024-07-10T13:06:20.000+09",
            "updateDate": "2024-07-10T13:06:20.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "itmpl",
            "spec": "richcard",
            "cardType": "carousel medium",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 4,
                "maxDisplayText": 13,
                "maxDescriptionSize": 60,
                "imageWidth": "696",
                "imageHeight": "1296",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 3,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 500,
                "maxMediaSize": 1048576,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(내용 1번이 들어갑니다\\.)$",
                    "verification": [
                        "내용 1번이 들어갑니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "내용 1번이 들어갑니다.",
                    "relationId": null
                },
                {
                    "param": "description2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(제 2장, 설명: ).+$",
                    "verification": [
                        "제 2장, 설명: ",
                        ""
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "제 2장, 설명: {{desc2}}",
                    "relationId": null
                },
                {
                    "param": "description3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(제 3장, 설명)$",
                    "verification": [
                        "제 3장, 설명"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "제 3장, 설명",
                    "relationId": null
                },
                {
                    "param": "title2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(제 2장, ).+$",
                    "verification": [
                        "제 2장, ",
                        ""
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "제 2장, {{ttl2}}",
                    "relationId": null
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "richcardMessage": {
                        "message": {
                            "generalPurposeCardCarousel": {
                                "layout": {
                                    "cardWidth": "MEDIUM_WIDTH"
                                },
                                "content": [
                                    {
                                        "description": "{{description1}}",
                                        "media": {
                                            "mediaUrl": "maapfile://LT-logo.common-34FDUE",
                                            "height": "MEDIUM_HEIGHT"
                                        },
                                        "title": "",
                                        "suggestions": [
                                            {
                                                "action": {
                                                    "dialerAction": {
                                                        "dialPhoneNumber": {
                                                            "phoneNumber": "15221601"
                                                        }
                                                    },
                                                    "displayText": "고객센터1",
                                                    "postback": {
                                                        "data": "set_by_chatbot_dial_phone_number"
                                                    }
                                                }
                                            }
                                        ]
                                    },
                                    {
                                        "description": "{{description2}}",
                                        "media": {
                                            "mediaUrl": "maapfile://LT-logo.common-34FDUE",
                                            "height": "MEDIUM_HEIGHT"
                                        },
                                        "title": "{{title2}}"
                                    },
                                    {
                                        "description": "{{description3}}",
                                        "media": {
                                            "mediaUrl": "maapfile://LT-logo.common-34FDUE",
                                            "height": "MEDIUM_HEIGHT"
                                        },
                                        "title": ""
                                    }
                                ],
                                "zoomAllowed": false
                            }
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - LMS형-기본" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "LBR.61hBmMP164-test2024062109",
            "tmpltName": "LMS형-기본",
            "messagebaseformId": "CLL00004",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:18:41.000+09",
            "approvalDate": "2024-07-10T13:07:07.000+09",
            "updateDate": "2024-07-10T13:07:07.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "lms",
            "spec": "openrichcard",
            "cardType": "descriptionNew",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": "^(내용만 입력합니다\\.\n).+(님 안녕하세요\\.\n동해물과 백두산이 ).+( 하느님이 보우하사 우리 나라 만세\\!\\!\n).+(\n동일한 변수를 반복해서 써 봅니다\\.\n).+$",
                    "verification": [
                        "내용만 입력합니다.\n",
                        "님 안녕하세요.\n동해물과 백두산이 ",
                        " 하느님이 보우하사 우리 나라 만세!!\n",
                        "\n동일한 변수를 반복해서 써 봅니다.\n",
                        ""
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "내용만 입력합니다.\n{{1}}님 안녕하세요.\n동해물과 백두산이 {{2}} 하느님이 보우하사 우리 나라 만세!!\n{{2}}\n동일한 변수를 반복해서 써 봅니다.\n{{2}}",
                    "relationId": "descVsblty"
                },
                {
                    "param": "mTitle",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": "^(움직이는 아이콘\\!:수박:)$",
                    "verification": [
                        "움직이는 아이콘!:수박:"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "움직이는 아이콘!:수박:",
                    "relationId": "mTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "visible",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "ImageView",
                                                    "width": "24dp",
                                                    "height": "24dp",
                                                    "corner_radius": "4dp",
                                                    "scaleType": "fitXY",
                                                    "marginRight": "4dp",
                                                    "visibility": "gone",
                                                    "mediaUrl": "{{mTitleMedia}}"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{mTitle}}",
                                                    "textColor": "#1e1e1e",
                                                    "textAlignment": "textStart",
                                                    "textSize": "19dp"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "2dp",
                                            "widget": "View",
                                            "marginTop": "6dp",
                                            "background": "#1e1e1e"
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "150"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "URL 버튼 입니다.",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": "https://www.rcsbizcenter.com"
                                                                        }
                                                                    },
                                                                    "displayText": "URL 버튼 입니다.",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "visible"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "gone"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - LMS형-명세서" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "LBR.61hBmMP164-test2024062110",
            "tmpltName": "LMS형-명세서",
            "messagebaseformId": "CLL00001",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:18:57.000+09",
            "approvalDate": "2024-07-10T13:08:13.000+09",
            "updateDate": "2024-07-10T13:08:13.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "lms",
            "spec": "openrichcard",
            "cardType": "descriptionNew",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 2,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 17,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "cellLeft1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(납부정보)$",
                    "verification": [
                        "납부정보"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "납부정보",
                    "relationId": "cellVsblty1"
                },
                {
                    "param": "cellLeft2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(자동납부)$",
                    "verification": [
                        "자동납부"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "자동납부",
                    "relationId": "cellVsblty2"
                },
                {
                    "param": "cellLeft3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(승인예정일)$",
                    "verification": [
                        "승인예정일"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "승인예정일",
                    "relationId": "cellVsblty3"
                },
                {
                    "param": "cellLeft4",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(통신요금)$",
                    "verification": [
                        "통신요금"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "통신요금",
                    "relationId": "cellVsblty4"
                },
                {
                    "param": "cellLeft5",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(부가사용금액)$",
                    "verification": [
                        "부가사용금액"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "부가사용금액",
                    "relationId": "cellVsblty5"
                },
                {
                    "param": "cellLeft6",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(납부하실금액)$",
                    "verification": [
                        "납부하실금액"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "납부하실금액",
                    "relationId": "cellVsblty6"
                },
                {
                    "param": "cellRight2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+(\\}\\})$",
                    "verification": [
                        "",
                        "}}"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{place}}}}",
                    "relationId": "cellRightVsblty2"
                },
                {
                    "param": "cellRight3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+(월).+(일)$",
                    "verification": [
                        "",
                        "월",
                        "일"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{Month}}월{{day}}일",
                    "relationId": "cellRightVsblty3"
                },
                {
                    "param": "cellRight4",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+$",
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{amount1}}",
                    "relationId": "cellRightVsblty4"
                },
                {
                    "param": "cellRight5",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+$",
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{amount2}}",
                    "relationId": "cellRightVsblty5"
                },
                {
                    "param": "cellRight6",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+$",
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{vat}}",
                    "relationId": "cellRightVsblty6"
                },
                {
                    "param": "mTitle",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": "^(청구서함)$",
                    "verification": [
                        "청구서함"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "청구서함",
                    "relationId": "mTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "visible",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{mTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "24dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "48dp",
                                                    "height": "48dp",
                                                    "orientation": "horizontal",
                                                    "corner_radius": "4dp",
                                                    "marginLeft": "8dp",
                                                    "visibility": "gone",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "width": "match",
                                                            "height": "match",
                                                            "scaleType": "fitXY",
                                                            "mediaUrl": "{{mTitleMedia}}"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "gone",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "100"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "background": "#f2f2f2",
                                            "corner_radius": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "gone",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{cellTitle1}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "17dp",
                                                            "marginBottom": "4dp"
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "background": "#1e1e1e",
                                                            "marginBottom": "1dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft1}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "visible"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "1dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft2}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight2}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft3}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight3}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft4}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight4}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft5}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight5}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft6}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight6}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "background": "#f2f2f2",
                                            "corner_radius": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "gone",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "gone",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{cellTitle2}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "17dp",
                                                            "marginBottom": "4dp"
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "background": "#1e1e1e",
                                                            "marginBottom": "1dp"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "청구서함바로가기",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": "https://www-qa.rcsbizcenter.com/"
                                                                        }
                                                                    },
                                                                    "displayText": "청구서함바로가기",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "visible"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "gone"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 테이블아이템 강조형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "UBR.61hBmMP164-test2024062116",
            "tmpltName": "테이블아이템 강조형",
            "messagebaseformId": "CLT00001",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "검수완료",
            "approvalReason": "",
            "registerDate": "2024-07-10T11:19:35.000+09",
            "approvalDate": "2024-07-10T13:09:02.000+09",
            "updateDate": "2024-07-10T13:09:02.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "tmplt",
            "spec": "openrichcard",
            "cardType": "descriptionNew",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 1,
                "maxDisplayText": 17,
                "maxDescriptionSize": 90,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 0,
                "maxButtonCount": 2,
                "maxDescriptionSize": 90,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": false,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "cellLeft1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(누적)$",
                    "verification": [
                        "누적"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "누적",
                    "relationId": "cellVsblty1"
                },
                {
                    "param": "cellLeft2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(일시불)$",
                    "verification": [
                        "일시불"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "일시불",
                    "relationId": "cellVsblty2"
                },
                {
                    "param": "cellLeft3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(할부)$",
                    "verification": [
                        "할부"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "할부",
                    "relationId": "cellVsblty3"
                },
                {
                    "param": "cellLeft4",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^(합계)$",
                    "verification": [
                        "합계"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "합계",
                    "relationId": "cellVsblty4"
                },
                {
                    "param": "cellRight1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+$",
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{누적금액}}",
                    "relationId": "cellRightVsblty1"
                },
                {
                    "param": "cellRight2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+$",
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{일시불금액}}",
                    "relationId": "cellRightVsblty2"
                },
                {
                    "param": "cellRight3",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+$",
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{할부금}}",
                    "relationId": "cellRightVsblty3"
                },
                {
                    "param": "cellRight4",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": "^.+$",
                    "verification": [],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "{{합계총액}}",
                    "relationId": "cellRightVsblty4"
                },
                {
                    "param": "itemTitle",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 14,
                    "fileSize": null,
                    "strRegx": "^(명세서)$",
                    "verification": [
                        "명세서"
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "명세서",
                    "relationId": "itemVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "4dp",
                                    "orientation": "vertical"
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "marginBottom": "2dp",
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "text": "{{itemDesc}}",
                                                            "textColor": "#949494",
                                                            "visibility": "gone",
                                                            "textSize": "14dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "2dp",
                                                            "textStyle": "bold",
                                                            "text": "{{itemTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "24dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "56dp",
                                                    "height": "56dp",
                                                    "orientation": "horizontal",
                                                    "corner_radius": "4dp",
                                                    "marginLeft": "8dp",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "width": "match",
                                                            "height": "match",
                                                            "scaleType": "fitXY",
                                                            "mediaUrl": "maapfile://LT-messagebase.common-2k8ydI"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "background": "#f2f2f2",
                                            "corner_radius": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "gone",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{cellTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "17dp",
                                                            "marginBottom": "4dp"
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "background": "#1e1e1e",
                                                            "marginBottom": "1dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "4dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft1}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight1}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "visible"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "1dp",
                                                            "orientation": "horizontal",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft2}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight2}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft3}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight3}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        },
                                                        {
                                                            "width": "match",
                                                            "height": "1dp",
                                                            "widget": "View",
                                                            "marginTop": "4dp",
                                                            "background": "#949494",
                                                            "visibility": "visible"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "LinearLayout",
                                                            "width": "match",
                                                            "height": "content",
                                                            "orientation": "horizontal",
                                                            "marginTop": "4dp",
                                                            "children": [
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "text": "{{cellLeft4}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "1",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textStart"
                                                                },
                                                                {
                                                                    "widget": "TextView",
                                                                    "width": "0dp",
                                                                    "height": "match",
                                                                    "textStyle": "normal",
                                                                    "marginLeft": "12dp",
                                                                    "visibility": "visible",
                                                                    "text": "{{cellRight4}}",
                                                                    "textColor": "#1e1e1e",
                                                                    "textSize": "15dp",
                                                                    "weight": "2",
                                                                    "gravity": "top",
                                                                    "textAlignment": "textEnd"
                                                                }
                                                            ]
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "gone"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "gone"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - 기본형 아이템 강조" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "UBR.61hBmMP164-i0sCoYzlVirYbXgL3l91Z68hc",
            "tmpltName": "기본형 아이템 강조",
            "messagebaseformId": "CLT00002",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2024-07-25T15:58:14.000+09",
            "approvalDate": "2024-07-25T16:04:38.000+09",
            "updateDate": "2024-07-25T16:04:28.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "tmplt",
            "spec": "openrichcard",
            "cardType": "descriptionNew",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 90,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 14,
                "maxButtonCount": 2,
                "maxDescriptionSize": 90,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": false,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 90,
                    "fileSize": null,
                    "strRegx": "^(내용입니다\\.)$",
                    "verification": [
                        "내용입니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "내용입니다.",
                    "relationId": "descVsblty"
                },
                {
                    "param": "itemTitle",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 20,
                    "fileSize": null,
                    "strRegx": "^(\b제목입니다\\.)$",
                    "verification": [
                        "\b제목입니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "\b제목입니다.",
                    "relationId": "itemVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "4dp",
                                    "orientation": "vertical"
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "marginBottom": "2dp",
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "normal",
                                                            "text": "{{itemDesc}}",
                                                            "textColor": "#949494",
                                                            "visibility": "gone",
                                                            "textSize": "14dp"
                                                        },
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "marginTop": "2dp",
                                                            "textStyle": "bold",
                                                            "text": "{{itemTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "24dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "56dp",
                                                    "height": "56dp",
                                                    "orientation": "horizontal",
                                                    "corner_radius": "4dp",
                                                    "marginLeft": "8dp",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "width": "match",
                                                            "height": "match",
                                                            "scaleType": "fitXY",
                                                            "mediaUrl": "maapfile://LT-messagebase.common-DdWk6s"
                                                        }
                                                    ]
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "150"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "전화걸기-112",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "dialerAction": {
                                                                        "dialPhoneNumber": {
                                                                            "phoneNumber": "112"
                                                                        }
                                                                    },
                                                                    "displayText": "전화걸기-112",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_dial_phone_number"
                                                                    }
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "visible"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "gone"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - LMS 템플릿 문단형" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "LBR.61hBmMP164-hnvwCQtXDs7BUbyO5no1gJ0iO",
            "tmpltName": "LMS 템플릿 문단형",
            "messagebaseformId": "CLL00002",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2024-07-25T16:25:56.000+09",
            "approvalDate": "2024-07-25T16:26:49.000+09",
            "updateDate": "2024-07-25T16:26:42.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "lms",
            "spec": "openrichcard",
            "cardType": "descriptionNew",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 17,
                "maxButtonCount": 4,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": "^(첫번째 문단 내용입니다\\.)$",
                    "verification": [
                        "첫번째 문단 내용입니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "첫번째 문단 내용입니다.",
                    "relationId": "descVsblty1"
                },
                {
                    "param": "description2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": "^(두번째 문단 내용입니다\\.)$",
                    "verification": [
                        "두번째 문단 내용입니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "두번째 문단 내용입니다.",
                    "relationId": "descVsblty2"
                },
                {
                    "param": "mTitle",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": "^(제목입니다\\.)$",
                    "verification": [
                        "제목입니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "제목입니다.",
                    "relationId": "mTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "visible",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "ImageView",
                                                    "width": "24dp",
                                                    "height": "24dp",
                                                    "corner_radius": "4dp",
                                                    "scaleType": "fitXY",
                                                    "marginRight": "4dp",
                                                    "visibility": "visible",
                                                    "mediaUrl": "maapfile://LT-messagebase.common-DdWk6s"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "text": "{{mTitle}}",
                                                    "textColor": "#1e1e1e",
                                                    "textAlignment": "textStart",
                                                    "textSize": "19dp"
                                                }
                                            ]
                                        },
                                        {
                                            "width": "match",
                                            "height": "2dp",
                                            "widget": "View",
                                            "marginTop": "6dp",
                                            "background": "#1e1e1e"
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title1}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description1}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "100"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "8dp",
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "weight": 1.0,
                                                    "width": "content",
                                                    "height": "36dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "text": "첫번째URL",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": "https://www.rcsbizcenter.com/"
                                                                }
                                                            },
                                                            "displayText": "첫번째URL",
                                                            "postback": {
                                                                "data": "set_by_chatbot_open_url"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "weight": 1.0,
                                                    "width": "content",
                                                    "height": "36dp",
                                                    "marginLeft": "8dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "text": "",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "gone"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title2}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description2}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "100"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "8dp",
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "children": [
                                                {
                                                    "widget": "Button",
                                                    "weight": 1.0,
                                                    "width": "content",
                                                    "height": "36dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "text": "두번째URL",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": "https://www.rcsbizcenter.com/"
                                                                }
                                                            },
                                                            "displayText": "두번째URL",
                                                            "postback": {
                                                                "data": "set_by_chatbot_open_url"
                                                            }
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "visible"
                                                },
                                                {
                                                    "widget": "Button",
                                                    "weight": 1.0,
                                                    "width": "content",
                                                    "height": "36dp",
                                                    "marginLeft": "8dp",
                                                    "background": "#E4E4E4",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "text": "",
                                                    "textStyle": "normal",
                                                    "textAlignment": "center",
                                                    "click": {
                                                        "action": {
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            },
                                                            "displayText": "dummy"
                                                        }
                                                    },
                                                    "corner_radius": "8dp",
                                                    "visibility": "gone"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200 - LMS 템플릿 기본형 타이틀 강조" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "LBR.61hBmMP164-8nR1Oag3dl9GU7JA4cQvL5RQi",
            "tmpltName": "LMS 템플릿 기본형 타이틀 강조",
            "messagebaseformId": "CLL00003",
            "brandId": "BR.61hBmMP164",
            "status": "ready",
            "approvalResult": "승인",
            "approvalReason": "승인완료",
            "registerDate": "2024-07-25T16:16:07.000+09",
            "approvalDate": "2024-07-25T16:22:07.000+09",
            "updateDate": "2024-07-25T16:22:05.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "productCode": "lms",
            "spec": "openrichcard",
            "cardType": "descriptionNew",
            "agencyId": null,
            "inputText": null,
            "attribute": [
                "인터넷/컴퓨터",
                null,
                null
            ],
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            },
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 17,
                "maxButtonCount": 2,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": false,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "params": [
                {
                    "param": "description",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": "^(내용입니다\\.)$",
                    "verification": [
                        "내용입니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "내용입니다.",
                    "relationId": "descVsblty"
                },
                {
                    "param": "mTitle",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": "^(제목입니다\\.)$",
                    "verification": [
                        "제목입니다."
                    ],
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": "제목입니다.",
                    "relationId": "mTitleVsblty"
                }
            ],
            "formattedString": {
                "RCSMessage": {
                    "trafficType": "advertisement",
                    "openrichcardMessage": {
                        "card": "open_rich_card",
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "scaleAllowed": true,
                        "layout": {
                            "widget": "LinearLayout",
                            "width": "match",
                            "height": "content",
                            "orientation": "vertical",
                            "background": "#F2F2F2",
                            "children": [
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "marginTop": "14dp",
                                    "paddingLeft": "14dp",
                                    "paddingRight": "14dp",
                                    "orientation": "vertical",
                                    "visibility": "visible",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "horizontal",
                                            "gravity": "bottom",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "weight": "1",
                                                    "children": [
                                                        {
                                                            "widget": "TextView",
                                                            "width": "match",
                                                            "height": "content",
                                                            "textStyle": "bold",
                                                            "text": "{{mTitle}}",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "24dp"
                                                        }
                                                    ]
                                                },
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "48dp",
                                                    "height": "48dp",
                                                    "orientation": "horizontal",
                                                    "corner_radius": "4dp",
                                                    "marginLeft": "8dp",
                                                    "visibility": "visible",
                                                    "children": [
                                                        {
                                                            "widget": "ImageView",
                                                            "width": "match",
                                                            "height": "match",
                                                            "scaleType": "fitXY",
                                                            "mediaUrl": "maapfile://LT-messagebase.common-DdWk6s"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "content",
                                    "orientation": "vertical",
                                    "paddingLeft": "10dp",
                                    "paddingRight": "10dp",
                                    "children": [
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "marginTop": "6dp",
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "visibility": "visible",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "bold",
                                                    "marginBottom": "6dp",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "17dp",
                                                    "visibility": "gone"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "width": "match",
                                                    "height": "content",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "textSize": "15dp",
                                                    "viewAll": "150"
                                                }
                                            ]
                                        },
                                        {
                                            "widget": "LinearLayout",
                                            "width": "match",
                                            "height": "content",
                                            "orientation": "vertical",
                                            "padding": "4dp",
                                            "children": [
                                                {
                                                    "widget": "LinearLayout",
                                                    "width": "match",
                                                    "height": "content",
                                                    "orientation": "vertical",
                                                    "children": [
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "\bRCS Biz Center",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": "https://www.rcsbizcenter.com/"
                                                                        }
                                                                    },
                                                                    "displayText": "\bRCS Biz Center",
                                                                    "postback": {
                                                                        "data": "set_by_chatbot_open_url"
                                                                    }
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "visible"
                                                        },
                                                        {
                                                            "widget": "Button",
                                                            "width": "match",
                                                            "height": "36dp",
                                                            "marginTop": "8dp",
                                                            "background": "#E4E4E4",
                                                            "textColor": "#1e1e1e",
                                                            "textSize": "15dp",
                                                            "text": "",
                                                            "textStyle": "normal",
                                                            "textAlignment": "center",
                                                            "click": {
                                                                "action": {
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    },
                                                                    "displayText": "dummy"
                                                                }
                                                            },
                                                            "corner_radius": "8dp",
                                                            "visibility": "gone"
                                                        }
                                                    ]
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp",
                                    "orientation": "vertical"
                                }
                            ]
                        }
                    }
                }
            }
        }
    ],
    "status": 200
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 등록 요청

초기 텍스트 템플릿에서만 제한적으로 사용 가능한 API 이므로 템플릿 등록 v2 API 사용을 권장합니다.

## Request

브랜드 내에서 사용할 텍스트 템플릿을 등록합니다.\
POST /brand/{brandId}/v2/messagebase 를 이용하면 모든 유형의 템플릿을 등록할 수 있습니다.<br>
-----------------------------------------------------------------------

> 브랜드 내에서 사용할 텍스트 템플릿을 등록합니다.  \
> 등록된 템플릿은 RCS Biz Center 운영자의 승인 후 사용 가능합니다.  \
> 템플릿 등록 시 사용되는 messagebaseformId의 formattedString을 이용하여 템플릿의 formattedString을 등록해야 합니다.\
> \
> \*\*\[템플릿 등록을 위한 formattedString 처리 방법]\*\*  \
> \#1. messagebaseform 리스트 조회  \
> \#2. 템플릿 생성 시 사용하고자 하는 messagebaseformId 상세 조회를 통해 formattedString 확인(messagebaseform의 formattedString은 수시 업데이트 될 수 있음)  \
> \#3. Messagebaseform formattedString 의 각 widget Object 의 widgetPolicy.allowedAttributes 에 지정된 key의 value만 수정할 수 있음(이외 수정 시 오류)  \
> \#4. Cell의 경우, ROOT.regMessagebases\[0].formattedString.RCSMessage.openrichcardMessage.layout.children\[1].children 내 object 단위 제거 할 수 있음  \
> &#x20; 단, 1개 이상의 Object(LinearLayout)는 존재해야 함  \
> \#5. Cell의 경우, ROOT.regMessagebases\[0].formattedString.RCSMessage.openrichcardMessage.layout.children\[1].children\[n].children 내 Object(TextView) 2개 중 1개는 삭제 가능함   \
> \#6. 타이틀 자유형(구 테마 강조형A) 제목 좌측 영역은 고정문자열 8자까지 허용(변수 사용 불가)  \
> \#7. 타이틀 자유형(구 테마 강조형A) 제목 우측 영역에 해당하는 ROOT.formattedString.RCSMessage.openrichcardMessage.layout.children\[0].children\[0].children\[1] 삭제 가능  \
> \#8. 타이틀 자유형(구 테마 강조형A) 제목 우측 영역에 해당하는 ROOT.formattedString.RCSMessage.openrichcardMessage.layout.children\[0].children\[0].children\[1].text 값(value)은 템플릿 내 정의된 변수만 입력 가능(예시 참조)  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형)\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegMessagebaseInfo":{"description":"템플릿 등록 정보 객체입니다.  \n\n템플릿 등록시 지정된 messagebaseform의 widgetPolicy 의 속성만 수정/삭제가 가능합니다.  \n\nformattedString에 템플릿이 정의되며 지정된 형식에 맞게 등록되어야 합니다.  \n\nformattedString 내 suggestions에 추가 가능한 버튼 Action은 다음 링크에서 확인 가능합니다.  \n\n**[버튼 Action 목록 Link](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)**\n","type":"object","required":["messagebaseformId","tmpltName","brandId","custTmpltId"],"properties":{"messagebaseformId":{"description":"maxLength: 10 - 템플릿 양식 ID\n","type":"string","maxLength":10},"custTmpltId":{"description":"maxLength: 25 - 사용자 지정 템플릿ID로 영문/숫자 25자 이내만 가능\n","type":"string","maxLength":25},"tmpltName":{"description":"maxLength: 40 - 템플릿명\n","type":"string","maxLength":40},"brandId":{"description":"maxLength: 13 - 브랜드ID\n","type":"string","maxLength":13},"agencyId":{"description":"maxLength: 20 - 대행사ID\n","type":"string","maxLength":20},"formattedString":{"$ref":"#/components/schemas/RegRCSMessage"}}},"RegRCSMessage":{"description":"TTA RCS 오픈리치카드 규격이며 JSON 형식으로 정의된 템플릿의 레이아웃 데이터입니다.\n","type":"object","properties":{"RCSMessage":{"type":"object","properties":{"trafficType":{"type":"string","enum":["advertisment"]}},"allOf":[{"$ref":"#/components/schemas/OpenrichcardMessage"}]}}},"OpenrichcardMessage":{"description":"TTA TTAK.KO-06.0410/R7 부록D 오픈리치카드 스키마 참조","type":"object","properties":{"openrichcardMessage":{"type":"object","properties":{"card":{"type":"string","enum":["open_rich_card"]},"copyAllowed":{"description":"set true to allow text copy of card text","type":"boolean"},"zoomAllowed":{"description":"메시지 확대/축소 가능 여부","type":"boolean"},"scaleAllowed":{"description":"이미지 비율 맞춤 활성화 여부","type":"boolean"},"layout":{"oneOf":[{"$ref":"#/components/schemas/view"},{"$ref":"#/components/schemas/linear_layout"},{"$ref":"#/components/schemas/text_view"},{"$ref":"#/components/schemas/image_view"}]},"suggestions":{"description":"Suggested replies and/or suggested actions for a chatbot message, send from chatbot platform to client.","type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/action"}]},"minItems":1,"maxItems":11}},"required":["card","layout"]}}},"view":{"allOf":[{"$ref":"#/components/schemas/Views"},{"properties":{"widget":{"type":"string","enum":["View"]},"width":{"$ref":"#/components/schemas/width_height"},"height":{"$ref":"#/components/schemas/width_height"},"widgetPolicy":{"$ref":"#/components/schemas/widgetPolicy"}},"required":["widget","width","height"]}]},"Views":{"type":"object","properties":{"weight":{"type":"number"},"visibility":{"$ref":"#/components/schemas/visibility"},"background":{"$ref":"#/components/schemas/color"},"corner_radius":{"$ref":"#/components/schemas/dimen"},"padding":{"$ref":"#/components/schemas/offset"},"paddingTop":{"$ref":"#/components/schemas/offset"},"paddingLeft":{"$ref":"#/components/schemas/offset"},"paddingRight":{"$ref":"#/components/schemas/offset"},"paddingBottom":{"$ref":"#/components/schemas/offset"},"margin":{"$ref":"#/components/schemas/offset"},"marginTop":{"$ref":"#/components/schemas/offset"},"marginBottom":{"$ref":"#/components/schemas/offset"},"marginLeft":{"$ref":"#/components/schemas/offset"},"marginRight":{"$ref":"#/components/schemas/offset"},"click":{"oneOf":[{"$ref":"#/components/schemas/reply"},{"$ref":"#/components/schemas/action"}]}}},"visibility":{"type":"string","enum":["visible","invisible","gone"]},"color":{"type":"string","pattern":"bot_color|#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})"},"dimen":{"type":"string","pattern":"[0-9]+dp"},"offset":{"type":"string","pattern":"-?[0-9]+dp"},"reply":{"description":"Definition of a suggested reply.","type":"object","properties":{"reply":{"allOf":[{"$ref":"#/components/schemas/suggestion"}]}},"required":["reply"]},"suggestion":{"description":"Common base definition for suggested replies and suggested actions.","type":"object","properties":{"displayText":{"type":"string","minLength":1,"maxLength":25,"description":"maxLength: 25, minLength: 1\n"},"postback":{"description":"Definition of data to be posted back from UE to chatbot.\n","type":"object","properties":{"data":{"type":"string","maxLength":2048,"description":"maxLength: 2048\n"}},"required":["data"]}},"required":["displayText","postback"]},"action":{"description":"Common base definition of a suggested action.","type":"object","properties":{"action":{"type":"object","allOf":[{"$ref":"#/components/schemas/suggestion"},{"oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"},{"$ref":"#/components/schemas/mapAction"},{"$ref":"#/components/schemas/calendarAction"},{"$ref":"#/components/schemas/composeAction"},{"$ref":"#/components/schemas/clipboardAction"},{"$ref":"#/components/schemas/localBrowserAction"}]}]}},"required":["action"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]},"mapAction":{"description":"Suggested actions for interacting with a location on a map.","properties":{"mapAction":{"type":"object","oneOf":[{"properties":{"showLocation":{"description":"Shows a given location on a map.","type":"object","properties":{"location":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"label":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"}},"required":["latitude","longitude"]},"fallbackUrl":{"type":"string","format":"uri"}},"required":["location"]}},"required":["showLocation"]},{"properties":{"requestLocationPush":{"description":"One-time request to send a geo location push from UE to\nchatbot","type":"object","properties":{"currentLocation":{"description":"set true to send current location without location\nselection","type":"boolean"}}}},"required":["requestLocationPush"]}]}},"required":["mapAction"]},"calendarAction":{"description":"Suggested actions for interacting with a calendar event.","properties":{"calendarAction":{"type":"object","oneOf":[{"properties":{"createCalendarEvent":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"title":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"},"description":{"type":"string","minLength":1,"maxLength":500,"description":"maxLength: 500, minLength: 1\n"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["startTime","endTime","title"]}},"required":["createCalendarEvent"]}]}},"required":["calendarAction"]},"composeAction":{"description":"Suggested actions for composing draft messages.","properties":{"composeAction":{"type":"object","oneOf":[{"properties":{"composeTextMessage":{"description":"Compose a draft text message.","type":"object","properties":{"phoneNumber":{"type":"string"},"text":{"type":"string","maxLength":100,"description":"maxLength: 100\n"}},"required":["phoneNumber","text"]}},"required":["composeTextMessage"]},{"properties":{"composeRecordingMessage":{"description":"Compose a draft message with a media recording.","type":"object","properties":{"phoneNumber":{"type":"string"},"type":{"type":"string","enum":["AUDIO","VIDEO"]}}}},"required":["composeRecordingMessage"]}]}},"required":["composeAction"]},"clipboardAction":{"description":"Text to be copied to clipboard.","properties":{"clipboardAction":{"type":"object","oneOf":[{"properties":{"copyToClipboard":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"]}},"required":["copyToClipboard"]}]}},"required":["clipboardAction"]},"localBrowserAction":{"description":"(템플릿 버튼 등록 불가)Suggested actions using Internal Web browser to interact a\nwebsite or deep app link.","properties":{"localBrowserAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"isHalfView":{"description":"set true to show Internal Web browser in vertical half\nsize of screen","type":"boolean","default":false},"postParameter":{"description":"parameters to be sent as POST method when open url","type":"object"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["localBrowserAction"]},"width_height":{"type":"string","pattern":"match|content|[0-9]+dp"},"widgetPolicy":{"description":"오픈리치카드를 구성하는 Property 중 템플릿 정의시 변경 가능한 속성 정보 객체입니다.   \n\n클라이언트가 변경할 수 있는 속성 리스트를 widget별 표시합니다.  \n\n클라이언트에서 템플릿 정의 시 사용하는 openrichcard용 messagebaseform 에 정의되며 템플릿 정의시 widgetPolicy에 표시된 속성만 클라이언트에서 수정/삭제가 가능합니다.\n","type":"object","required":["allowedAttributes"],"properties":{"allowedAttributes":{"type":"array","items":{"type":"string"}}}},"linear_layout":{"allOf":[{"$ref":"#/components/schemas/Views"},{"properties":{"widget":{"type":"string","enum":["LinearLayout"]},"orientation":{"type":"string","enum":["vertical","horizontal"]},"gravity":{"$ref":"#/components/schemas/gravity"},"children":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/view"},{"$ref":"#/components/schemas/linear_layout"},{"$ref":"#/components/schemas/text_view"},{"$ref":"#/components/schemas/image_view"}]}},"width":{"$ref":"#/components/schemas/width_height"},"height":{"$ref":"#/components/schemas/width_height"}},"required":["widget","width","height","orientation"]}]},"gravity":{"type":"string","pattern":"((\\|)?(bottom|center|center_horizontal|center_vertical|clip_horizontal|clip_vertical|end|fill|fill_horizontal|fill_vertical|left|right|start|top))+"},"text_view":{"allOf":[{"$ref":"#/components/schemas/Views"},{"properties":{"widget":{"type":"string","enum":["TextView"]},"text":{"type":"string","minLength":0,"maxLength":2000,"description":"maxLength: 2000, minLength: 0\n"},"textAlignment":{"type":"string","pattern":"((\\|)?(center|gravity|inherit|textEnd|textStart|viewEnd|viewStart))+"},"textStyle":{"type":"string","pattern":"((\\|)?(bold|normal))*"},"textColor":{"$ref":"#/components/schemas/color"},"textSize":{"$ref":"#/components/schemas/dimen"},"width":{"$ref":"#/components/schemas/width_height"},"height":{"$ref":"#/components/schemas/width_height"},"widgetPolicy":{"$ref":"#/components/schemas/widgetPolicy"}},"required":["widget","width","height"]}]},"image_view":{"allOf":[{"$ref":"#/components/schemas/Views"},{"properties":{"widget":{"type":"string","enum":["ImageView"]},"mediaUrl":{"type":"string","format":"uri"},"mediaContentType":{"type":"string"},"mediaFileSize":{"description":"minimum: 0 - Media file size in bytes\n","type":"integer","minimum":0},"scaleType":{"type":"string","enum":["center","centerCrop","centerInside","fitCenter","fitEnd","fitStart","fitXY","matrix"]},"width":{"$ref":"#/components/schemas/dimen"},"height":{"$ref":"#/components/schemas/dimen"},"widgetPolicy":{"$ref":"#/components/schemas/widgetPolicy"}},"required":["widget","width","height","mediaUrl","mediaContentType","mediaFileSize"]}]}}},"paths":{"/brand/{brandId}/messagebase":{"post":{"summary":"브랜드 내에서 사용할 텍스트 템플릿을 등록합니다.\nPOST /brand/{brandId}/v2/messagebase 를 이용하면 모든 유형의 템플릿을 등록할 수 있습니다.\n","description":"브랜드 내에서 사용할 텍스트 템플릿을 등록합니다.  \n등록된 템플릿은 RCS Biz Center 운영자의 승인 후 사용 가능합니다.  \n템플릿 등록 시 사용되는 messagebaseformId의 formattedString을 이용하여 템플릿의 formattedString을 등록해야 합니다.\n\n**[템플릿 등록을 위한 formattedString 처리 방법]**  \n#1. messagebaseform 리스트 조회  \n#2. 템플릿 생성 시 사용하고자 하는 messagebaseformId 상세 조회를 통해 formattedString 확인(messagebaseform의 formattedString은 수시 업데이트 될 수 있음)  \n#3. Messagebaseform formattedString 의 각 widget Object 의 widgetPolicy.allowedAttributes 에 지정된 key의 value만 수정할 수 있음(이외 수정 시 오류)  \n#4. Cell의 경우, ROOT.regMessagebases[0].formattedString.RCSMessage.openrichcardMessage.layout.children[1].children 내 object 단위 제거 할 수 있음  \n  단, 1개 이상의 Object(LinearLayout)는 존재해야 함  \n#5. Cell의 경우, ROOT.regMessagebases[0].formattedString.RCSMessage.openrichcardMessage.layout.children[1].children[n].children 내 Object(TextView) 2개 중 1개는 삭제 가능함   \n#6. 타이틀 자유형(구 테마 강조형A) 제목 좌측 영역은 고정문자열 8자까지 허용(변수 사용 불가)  \n#7. 타이틀 자유형(구 테마 강조형A) 제목 우측 영역에 해당하는 ROOT.formattedString.RCSMessage.openrichcardMessage.layout.children[0].children[0].children[1] 삭제 가능  \n#8. 타이틀 자유형(구 테마 강조형A) 제목 우측 영역에 해당하는 ROOT.formattedString.RCSMessage.openrichcardMessage.layout.children[0].children[0].children[1].text 값(value)은 템플릿 내 정의된 변수만 입력 가능(예시 참조)  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형)**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"regMessagebases":{"type":"array","items":{"$ref":"#/components/schemas/RegMessagebaseInfo"},"maxItems":1000,"minItems":1}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% hint style="warning" %}
**지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형) -** messagebaseformId 확인하세요.
{% endhint %}

{% tabs %}
{% tab title="타이틀자유형-스타일" %}

```
{
  "regMessagebases": [
    {
      "brandId": "BR.u720xwadx0",
      "custTmpltId": "test2024062101",
      "messagebaseformId": "TATA001C",
      "tmpltName": "타이틀자유형-스타일",
      "agencyId": "",
      "formattedString": {
        "RCSMessage": {
          "trafficType": "advertisement",
          "openrichcardMessage": {
            "card": "open_rich_card",
            "version": "1.0.0",
            "zoomAllowed": true,
            "scaleAllowed": true,
            "layout": {
              "widget": "LinearLayout",
              "width": "match",
              "height": "content",
              "orientation": "vertical",
              "children": [
                {
                  "widget": "LinearLayout",
                  "width": "match",
                  "height": "content",
                  "orientation": "vertical",
                  "padding": "20dp",
                  "children": [
                    {
                      "widget": "LinearLayout",
                      "width": "match",
                      "height": "content",
                      "orientation": "horizontal",
                      "visibility": "visible",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text"
                            ]
                          },
                          "widget": "TextView",
                          "width": "match",
                          "height": "content",
                          "textStyle": "bold",
                          "textAlignment": "textStart",
                          "text": "제목",
                          "textColor": "#232323",
                          "textSize": "19dp",
                          "weight": "1"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text"
                            ]
                          },
                          "widget": "TextView",
                          "width": "match",
                          "height": "content",
                          "textStyle": "bold",
                          "textAlignment": "textEnd",
                          "text": "{{cell20}}",
                          "textColor": "#0094ff",
                          "textSize": "19dp",
                          "weight": "1",
                          "visibility": "visible"
                        }
                      ]
                    },
                    {
                      "width": "match",
                      "height": "3dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "visible",
                      "marginTop": "10dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "orientation": "vertical",
                      "children": [
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell1}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell2}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell3}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell4}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell5}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell6}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell7}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell8}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell9}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell10}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell11}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell12}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell13}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell14}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell15}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell16}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell17}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell18}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        },
                        {
                          "width": "match",
                          "height": "content",
                          "widget": "LinearLayout",
                          "visibility": "visible",
                          "orientation": "horizontal",
                          "children": [
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "총합",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textStart"
                            },
                            {
                              "widgetPolicy": {
                                "allowedAttributes": [
                                  "text",
                                  "textAlignment",
                                  "textColor",
                                  "textSize",
                                  "textStyle"
                                ]
                              },
                              "text": "{{cell20}}",
                              "width": "match",
                              "height": "content",
                              "weight": 1,
                              "widget": "TextView",
                              "textSize": "16dp",
                              "textColor": "#232323",
                              "textAlignment": "textEnd"
                            }
                          ]
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "visibility"
                            ]
                          },
                          "width": "match",
                          "height": "1dp",
                          "widget": "View",
                          "background": "#232323",
                          "visibility": "gone",
                          "marginTop": "12dp",
                          "marginBottom": "12dp"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            "suggestions": [
              {}
            ]
          }
        }
      }
    }
  ]
}
```

{% endtab %}

{% tab title="타이틀자유형-서술" %}

```
{
  "regMessagebases": [
    {
      "brandId": "BR.u720xwadx0",
      "custTmpltId": "test2022072604",
      "messagebaseformId": "TATA001D",
      "tmpltName": "타이틀자유형-서술",
      "agencyId": "",
      "formattedString": {
        "RCSMessage": {
          "trafficType": "advertisement",
          "openrichcardMessage": {
            "card": "open_rich_card",
            "version": "1.0.0",
            "zoomAllowed": true,
            "scaleAllowed": true,
            "suggestions": [
              {}
            ],
            "layout": {
              "widget": "LinearLayout",
              "width": "match",
              "height": "content",
              "orientation": "vertical",
              "children": [
                {
                  "widget": "LinearLayout",
                  "width": "match",
                  "height": "content",
                  "orientation": "vertical",
                  "padding": "20dp",
                  "children": [
                    {
                      "widget": "LinearLayout",
                      "width": "match",
                      "height": "content",
                      "orientation": "horizontal",
                      "visibility": "visible",
                      "children": [
                        {
                          "widget": "TextView",
                          "width": "match",
                          "height": "content",
                          "textStyle": "bold",
                          "textAlignment": "textStart",
                          "text": "제목입니다.",
                          "textColor": "#232323",
                          "textSize": "19dp",
                          "weight": "1"
                        },
                        {
                          "widget": "TextView",
                          "width": "match",
                          "height": "content",
                          "textStyle": "bold",
                          "textAlignment": "textEnd",
                          "text": "",
                          "textColor": "#0094ff",
                          "textSize": "19dp",
                          "weight": "1",
                          "visibility": "gone"
                        }
                      ]
                    },
                    {
                      "width": "match",
                      "height": "3dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "visible",
                      "marginTop": "10dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "widget": "TextView",
                      "width": "match",
                      "height": "content",
                      "text": "{{description}}입니다.",
                      "textColor": "#232323",
                      "textSize": "16dp"
                    },
                    {
                      "widget": "LinearLayout",
                      "width": "match",
                      "height": "content",
                      "orientation": "vertical",
                      "children": [
                        {
                          "widget": "Button",
                          "width": "match",
                          "height": "42dp",
                          "background": "#EAEAEA",
                          "textColor": "#0094ff",
                          "textSize": "16dp",
                          "text": "{{btnName1}}",
                          "textStyle": "normal",
                          "textAlignment": "center",
                          "click": {
                            "action": {
                              "urlAction": {
                                "openUrl": {
                                  "url": ""
                                }
                              },
                              "displayText": "dummy"
                            }
                          },
                          "corner_radius": "8dp",
                          "visibility": "gone",
                          "marginTop": "12dp"
                        },
                        {
                          "widget": "Button",
                          "width": "match",
                          "height": "42dp",
                          "background": "#EAEAEA",
                          "textColor": "#0094ff",
                          "textSize": "16dp",
                          "text": "{{btnName2}}",
                          "textStyle": "normal",
                          "textAlignment": "center",
                          "click": {
                            "action": {
                              "urlAction": {
                                "openUrl": {
                                  "url": ""
                                }
                              },
                              "displayText": "dummy"
                            }
                          },
                          "corner_radius": "8dp",
                          "visibility": "gone",
                          "marginTop": "8dp"
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          }
        }
      }
    }
  ]
}
```

{% endtab %}

{% tab title="타이틀선택형-출고" %}

```
{
  "regMessagebases": [
    {
      "brandId": "BR.u720xwadx0",
      "custTmpltId": "test202406183",
      "messagebaseformId": "CC001C",
      "tmpltName": "타이틀선택형-출고",
      "agencyId": "",
      "formattedString": {
        "RCSMessage": {
          "trafficType": "advertisement",
          "openrichcardMessage": {
            "card": "open_rich_card",
            "layout": {
              "width": "284dp",
              "height": "content",
              "widget": "LinearLayout",
              "children": [
                {
                  "width": "content",
                  "height": "content",
                  "widget": "ImageView",
                  "mediaUrl": "maapfile://LT-messagebase.common-xpoKfv",
                  "paddingTop": "16dp",
                  "marginBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "children": [
                        {
                          "text": "{{1}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textStart"
                        },
                        {
                          "text": "{{2}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textEnd"
                        }
                      ],
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "paddingBottom": "8dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "children": [
                        {
                          "text": "{{3}}3",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textStart"
                        },
                        {
                          "text": "{{4}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textEnd"
                        }
                      ],
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "paddingBottom": "8dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "children": [
                        {
                          "text": "{{5}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textStart"
                        },
                        {
                          "text": "{{6}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textEnd"
                        }
                      ],
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "paddingBottom": "8dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "children": [
                        {
                          "text": "{{7}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textStart"
                        }
                      ],
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "paddingBottom": "8dp"
                    }
                  ],
                  "orientation": "vertical",
                  "paddingBottom": "8dp"
                }
              ],
              "background": "#ffffff",
              "orientation": "vertical",
              "paddingLeft": "16dp",
              "paddingRight": "16dp"
            },
            "suggestions": [],
            "zoomAllowed": "true"
          }
        }
      }
    }
  ]
}
```

{% endtab %}

{% tab title="타이틀선택형-승인" %}

```
{
  "regMessagebases": [
    {
      "brandId": "BR.u720xwadx0",
      "custTmpltId": "test202406182",
      "messagebaseformId": "FF001C",
      "tmpltName": "타이틀선택형-승인",
      "agencyId": "",
      "formattedString": {
        "RCSMessage": {
          "trafficType": "advertisement",
          "openrichcardMessage": {
            "card": "open_rich_card",
            "layout": {
              "width": "284dp",
              "height": "content",
              "widget": "LinearLayout",
              "children": [
                {
                  "width": "content",
                  "height": "content",
                  "widget": "ImageView",
                  "mediaUrl": "maapfile://LT-messagebase.common-9hEGL3",
                  "paddingTop": "16dp",
                  "marginBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "children": [
                        {
                          "text": "금액",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textStart"
                        },
                        {
                          "text": "{{금액}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textEnd"
                        }
                      ],
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "paddingBottom": "8dp"
                    },
                    {
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#c0c0c0",
                      "visibility": "visible",
                      "marginBottom": "8dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "children": [
                        {
                          "text": "결제처",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textStart"
                        },
                        {
                          "text": "{{결제처}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textEnd"
                        }
                      ],
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "paddingBottom": "8dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "children": [
                        {
                          "text": "일시",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textStart"
                        },
                        {
                          "text": "{{일시}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textEnd"
                        }
                      ],
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "paddingBottom": "8dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "children": [
                        {
                          "text": "결제정보",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textStart"
                        },
                        {
                          "text": "{{결제정보}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "14dp",
                          "textColor": "#404040",
                          "textAlignment": "textEnd"
                        }
                      ],
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "paddingBottom": "8dp"
                    }
                  ],
                  "orientation": "vertical",
                  "paddingBottom": "8dp"
                }
              ],
              "background": "#ffffff",
              "orientation": "vertical",
              "paddingLeft": "16dp",
              "paddingRight": "16dp"
            },
            "zoomAllowed": true,
            "suggestions": [
              {
                "action": {
                  "dialerAction": {
                    "dialPhoneNumber": {
                      "phoneNumber": "070822401234"
                    }
                  },
                  "displayText": "결제정보확인",
                  "postback": {
                    "data": "set_by_chatbot_dial_phone_number"
                  }
                }
              }
            ]
          }
        }
      }
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 템플릿ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="82">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="89">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>등록된 템플릿ID(= messagebaseId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseId": "UBR.u720xwadx0-test2022072604"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64106",
        "message": "Invalid messagebaseId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64318",
        "message": "Invalid formattedString format - cannot modify except specified key or value, check: mediaUrl"
    },
    "status": 400
}

{
    "error": {
        "code": "64318",
        "message": "Invalid formattedString format - non-variable sentences required"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 승인 요청 취소

## Request

## 지정된 템플릿의 승인요청을 취소합니다.<br>

> 지정된 템플릿의 승인요청을 취소합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿\*\*\
> \
> 각 상태별 취소 요청 동작은 다음과 같습니다.  \
> \
> &#x20; \+ \*\*승인대기 : 저장 상태로 변경\*\*          \
> &#x20; \+ \*\*승인대기(수정) : 직전 승인 상태 및 데이터로 롤백\*\*\
> &#x20; \+ \*\*반려(수정) : 직전 승인 상태 및 데이터로 롤백\*\*\
> &#x20; \+ \*\*이외의 경우 에러 리턴\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"MessagebaseId":{"name":"messagebaseId","in":"path","schema":{"type":"string"},"required":true,"description":"messagebase ID Path parameter 입니다."}}},"paths":{"/brand/{brandId}/messagebase/{messagebaseId}/cancel":{"put":{"summary":"지정된 템플릿의 승인요청을 취소합니다.\n","description":"지정된 템플릿의 승인요청을 취소합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿**\n\n각 상태별 취소 요청 동작은 다음과 같습니다.  \n\n  + **승인대기 : 저장 상태로 변경**          \n  + **승인대기(수정) : 직전 승인 상태 및 데이터로 롤백**\n  + **반려(수정) : 직전 승인 상태 및 데이터로 롤백**\n  + **이외의 경우 에러 리턴**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/MessagebaseId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 템플릿ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="188">필드명</th><th width="100">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td>messagebaseId</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록된 템플릿ID(= messagebaseId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseId": "UBR.u720xwadx0-test202406182"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 수정

초기 텍스트 템플릿에서만 제한적으로 사용 가능한 API 이므로 템플릿 수정 v2 API 사용을 권장합니다.

## Request

지정 템플릿을 업데이트 합니다.\
PUT /brand/{brandId}/v2/messagebase/{messagebaseId} 를 이용하면 모든 유형의 템플릿을 수정할 수 있습니다.<br>
--------------------------------------------------------------------------------------

> 지정 템플릿을 업데이트 합니다.  \
> 템플릿의 업데이트는 승인상태에 따라 처리 여부가 결정됩니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형)\*\*\
> &#x20; \+ \*\*수정 가능 상태 : 저장, 반려, 반려(수정), 승인\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"MessagebaseId":{"name":"messagebaseId","in":"path","schema":{"type":"string"},"required":true,"description":"messagebase ID Path parameter 입니다."}},"schemas":{"RegMessagebaseInfo":{"description":"템플릿 등록 정보 객체입니다.  \n\n템플릿 등록시 지정된 messagebaseform의 widgetPolicy 의 속성만 수정/삭제가 가능합니다.  \n\nformattedString에 템플릿이 정의되며 지정된 형식에 맞게 등록되어야 합니다.  \n\nformattedString 내 suggestions에 추가 가능한 버튼 Action은 다음 링크에서 확인 가능합니다.  \n\n**[버튼 Action 목록 Link](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)**\n","type":"object","required":["messagebaseformId","tmpltName","brandId","custTmpltId"],"properties":{"messagebaseformId":{"description":"maxLength: 10 - 템플릿 양식 ID\n","type":"string","maxLength":10},"custTmpltId":{"description":"maxLength: 25 - 사용자 지정 템플릿ID로 영문/숫자 25자 이내만 가능\n","type":"string","maxLength":25},"tmpltName":{"description":"maxLength: 40 - 템플릿명\n","type":"string","maxLength":40},"brandId":{"description":"maxLength: 13 - 브랜드ID\n","type":"string","maxLength":13},"agencyId":{"description":"maxLength: 20 - 대행사ID\n","type":"string","maxLength":20},"formattedString":{"$ref":"#/components/schemas/RegRCSMessage"}}},"RegRCSMessage":{"description":"TTA RCS 오픈리치카드 규격이며 JSON 형식으로 정의된 템플릿의 레이아웃 데이터입니다.\n","type":"object","properties":{"RCSMessage":{"type":"object","properties":{"trafficType":{"type":"string","enum":["advertisment"]}},"allOf":[{"$ref":"#/components/schemas/OpenrichcardMessage"}]}}},"OpenrichcardMessage":{"description":"TTA TTAK.KO-06.0410/R7 부록D 오픈리치카드 스키마 참조","type":"object","properties":{"openrichcardMessage":{"type":"object","properties":{"card":{"type":"string","enum":["open_rich_card"]},"copyAllowed":{"description":"set true to allow text copy of card text","type":"boolean"},"zoomAllowed":{"description":"메시지 확대/축소 가능 여부","type":"boolean"},"scaleAllowed":{"description":"이미지 비율 맞춤 활성화 여부","type":"boolean"},"layout":{"oneOf":[{"$ref":"#/components/schemas/view"},{"$ref":"#/components/schemas/linear_layout"},{"$ref":"#/components/schemas/text_view"},{"$ref":"#/components/schemas/image_view"}]},"suggestions":{"description":"Suggested replies and/or suggested actions for a chatbot message, send from chatbot platform to client.","type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/action"}]},"minItems":1,"maxItems":11}},"required":["card","layout"]}}},"view":{"allOf":[{"$ref":"#/components/schemas/Views"},{"properties":{"widget":{"type":"string","enum":["View"]},"width":{"$ref":"#/components/schemas/width_height"},"height":{"$ref":"#/components/schemas/width_height"},"widgetPolicy":{"$ref":"#/components/schemas/widgetPolicy"}},"required":["widget","width","height"]}]},"Views":{"type":"object","properties":{"weight":{"type":"number"},"visibility":{"$ref":"#/components/schemas/visibility"},"background":{"$ref":"#/components/schemas/color"},"corner_radius":{"$ref":"#/components/schemas/dimen"},"padding":{"$ref":"#/components/schemas/offset"},"paddingTop":{"$ref":"#/components/schemas/offset"},"paddingLeft":{"$ref":"#/components/schemas/offset"},"paddingRight":{"$ref":"#/components/schemas/offset"},"paddingBottom":{"$ref":"#/components/schemas/offset"},"margin":{"$ref":"#/components/schemas/offset"},"marginTop":{"$ref":"#/components/schemas/offset"},"marginBottom":{"$ref":"#/components/schemas/offset"},"marginLeft":{"$ref":"#/components/schemas/offset"},"marginRight":{"$ref":"#/components/schemas/offset"},"click":{"oneOf":[{"$ref":"#/components/schemas/reply"},{"$ref":"#/components/schemas/action"}]}}},"visibility":{"type":"string","enum":["visible","invisible","gone"]},"color":{"type":"string","pattern":"bot_color|#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})"},"dimen":{"type":"string","pattern":"[0-9]+dp"},"offset":{"type":"string","pattern":"-?[0-9]+dp"},"reply":{"description":"Definition of a suggested reply.","type":"object","properties":{"reply":{"allOf":[{"$ref":"#/components/schemas/suggestion"}]}},"required":["reply"]},"suggestion":{"description":"Common base definition for suggested replies and suggested actions.","type":"object","properties":{"displayText":{"type":"string","minLength":1,"maxLength":25,"description":"maxLength: 25, minLength: 1\n"},"postback":{"description":"Definition of data to be posted back from UE to chatbot.\n","type":"object","properties":{"data":{"type":"string","maxLength":2048,"description":"maxLength: 2048\n"}},"required":["data"]}},"required":["displayText","postback"]},"action":{"description":"Common base definition of a suggested action.","type":"object","properties":{"action":{"type":"object","allOf":[{"$ref":"#/components/schemas/suggestion"},{"oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"},{"$ref":"#/components/schemas/mapAction"},{"$ref":"#/components/schemas/calendarAction"},{"$ref":"#/components/schemas/composeAction"},{"$ref":"#/components/schemas/clipboardAction"},{"$ref":"#/components/schemas/localBrowserAction"}]}]}},"required":["action"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]},"mapAction":{"description":"Suggested actions for interacting with a location on a map.","properties":{"mapAction":{"type":"object","oneOf":[{"properties":{"showLocation":{"description":"Shows a given location on a map.","type":"object","properties":{"location":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"label":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"}},"required":["latitude","longitude"]},"fallbackUrl":{"type":"string","format":"uri"}},"required":["location"]}},"required":["showLocation"]},{"properties":{"requestLocationPush":{"description":"One-time request to send a geo location push from UE to\nchatbot","type":"object","properties":{"currentLocation":{"description":"set true to send current location without location\nselection","type":"boolean"}}}},"required":["requestLocationPush"]}]}},"required":["mapAction"]},"calendarAction":{"description":"Suggested actions for interacting with a calendar event.","properties":{"calendarAction":{"type":"object","oneOf":[{"properties":{"createCalendarEvent":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"title":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"},"description":{"type":"string","minLength":1,"maxLength":500,"description":"maxLength: 500, minLength: 1\n"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["startTime","endTime","title"]}},"required":["createCalendarEvent"]}]}},"required":["calendarAction"]},"composeAction":{"description":"Suggested actions for composing draft messages.","properties":{"composeAction":{"type":"object","oneOf":[{"properties":{"composeTextMessage":{"description":"Compose a draft text message.","type":"object","properties":{"phoneNumber":{"type":"string"},"text":{"type":"string","maxLength":100,"description":"maxLength: 100\n"}},"required":["phoneNumber","text"]}},"required":["composeTextMessage"]},{"properties":{"composeRecordingMessage":{"description":"Compose a draft message with a media recording.","type":"object","properties":{"phoneNumber":{"type":"string"},"type":{"type":"string","enum":["AUDIO","VIDEO"]}}}},"required":["composeRecordingMessage"]}]}},"required":["composeAction"]},"clipboardAction":{"description":"Text to be copied to clipboard.","properties":{"clipboardAction":{"type":"object","oneOf":[{"properties":{"copyToClipboard":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"]}},"required":["copyToClipboard"]}]}},"required":["clipboardAction"]},"localBrowserAction":{"description":"(템플릿 버튼 등록 불가)Suggested actions using Internal Web browser to interact a\nwebsite or deep app link.","properties":{"localBrowserAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"isHalfView":{"description":"set true to show Internal Web browser in vertical half\nsize of screen","type":"boolean","default":false},"postParameter":{"description":"parameters to be sent as POST method when open url","type":"object"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["localBrowserAction"]},"width_height":{"type":"string","pattern":"match|content|[0-9]+dp"},"widgetPolicy":{"description":"오픈리치카드를 구성하는 Property 중 템플릿 정의시 변경 가능한 속성 정보 객체입니다.   \n\n클라이언트가 변경할 수 있는 속성 리스트를 widget별 표시합니다.  \n\n클라이언트에서 템플릿 정의 시 사용하는 openrichcard용 messagebaseform 에 정의되며 템플릿 정의시 widgetPolicy에 표시된 속성만 클라이언트에서 수정/삭제가 가능합니다.\n","type":"object","required":["allowedAttributes"],"properties":{"allowedAttributes":{"type":"array","items":{"type":"string"}}}},"linear_layout":{"allOf":[{"$ref":"#/components/schemas/Views"},{"properties":{"widget":{"type":"string","enum":["LinearLayout"]},"orientation":{"type":"string","enum":["vertical","horizontal"]},"gravity":{"$ref":"#/components/schemas/gravity"},"children":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/view"},{"$ref":"#/components/schemas/linear_layout"},{"$ref":"#/components/schemas/text_view"},{"$ref":"#/components/schemas/image_view"}]}},"width":{"$ref":"#/components/schemas/width_height"},"height":{"$ref":"#/components/schemas/width_height"}},"required":["widget","width","height","orientation"]}]},"gravity":{"type":"string","pattern":"((\\|)?(bottom|center|center_horizontal|center_vertical|clip_horizontal|clip_vertical|end|fill|fill_horizontal|fill_vertical|left|right|start|top))+"},"text_view":{"allOf":[{"$ref":"#/components/schemas/Views"},{"properties":{"widget":{"type":"string","enum":["TextView"]},"text":{"type":"string","minLength":0,"maxLength":2000,"description":"maxLength: 2000, minLength: 0\n"},"textAlignment":{"type":"string","pattern":"((\\|)?(center|gravity|inherit|textEnd|textStart|viewEnd|viewStart))+"},"textStyle":{"type":"string","pattern":"((\\|)?(bold|normal))*"},"textColor":{"$ref":"#/components/schemas/color"},"textSize":{"$ref":"#/components/schemas/dimen"},"width":{"$ref":"#/components/schemas/width_height"},"height":{"$ref":"#/components/schemas/width_height"},"widgetPolicy":{"$ref":"#/components/schemas/widgetPolicy"}},"required":["widget","width","height"]}]},"image_view":{"allOf":[{"$ref":"#/components/schemas/Views"},{"properties":{"widget":{"type":"string","enum":["ImageView"]},"mediaUrl":{"type":"string","format":"uri"},"mediaContentType":{"type":"string"},"mediaFileSize":{"description":"minimum: 0 - Media file size in bytes\n","type":"integer","minimum":0},"scaleType":{"type":"string","enum":["center","centerCrop","centerInside","fitCenter","fitEnd","fitStart","fitXY","matrix"]},"width":{"$ref":"#/components/schemas/dimen"},"height":{"$ref":"#/components/schemas/dimen"},"widgetPolicy":{"$ref":"#/components/schemas/widgetPolicy"}},"required":["widget","width","height","mediaUrl","mediaContentType","mediaFileSize"]}]}}},"paths":{"/brand/{brandId}/messagebase/{messagebaseId}":{"put":{"summary":"지정 템플릿을 업데이트 합니다.\nPUT /brand/{brandId}/v2/messagebase/{messagebaseId} 를 이용하면 모든 유형의 템플릿을 수정할 수 있습니다.\n","description":"지정 템플릿을 업데이트 합니다.  \n템플릿의 업데이트는 승인상태에 따라 처리 여부가 결정됩니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형)**\n  + **수정 가능 상태 : 저장, 반려, 반려(수정), 승인**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/MessagebaseId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegMessagebaseInfo"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% hint style="warning" %}
**지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형) -** messagebaseformId 확인하세요.
{% endhint %}

{% tabs %}
{% tab title="타이틀자유형-스타일" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062101",
  "messagebaseformId": "TATA001C",
  "tmpltName": "타이틀자유형-스타일",
  "agencyId": "",
  "formattedString": {
    "RCSMessage": {
      "trafficType": "advertisement",
      "openrichcardMessage": {
        "card": "open_rich_card",
        "version": "1.0.0",
        "zoomAllowed": true,
        "scaleAllowed": true,
        "layout": {
          "widget": "LinearLayout",
          "width": "match",
          "height": "content",
          "orientation": "vertical",
          "children": [
            {
              "widget": "LinearLayout",
              "width": "match",
              "height": "content",
              "orientation": "vertical",
              "padding": "20dp",
              "children": [
                {
                  "widget": "LinearLayout",
                  "width": "match",
                  "height": "content",
                  "orientation": "horizontal",
                  "visibility": "visible",
                  "children": [
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "text"
                        ]
                      },
                      "widget": "TextView",
                      "width": "match",
                      "height": "content",
                      "textStyle": "bold",
                      "textAlignment": "textStart",
                      "text": "제목",
                      "textColor": "#232323",
                      "textSize": "19dp",
                      "weight": "1"
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "text"
                        ]
                      },
                      "widget": "TextView",
                      "width": "match",
                      "height": "content",
                      "textStyle": "bold",
                      "textAlignment": "textEnd",
                      "text": "{{cell20}}",
                      "textColor": "#0094ff",
                      "textSize": "19dp",
                      "weight": "1",
                      "visibility": "visible"
                    }
                  ]
                },
                {
                  "width": "match",
                  "height": "3dp",
                  "widget": "View",
                  "background": "#232323",
                  "visibility": "visible",
                  "marginTop": "10dp",
                  "marginBottom": "12dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "orientation": "vertical",
                  "children": [
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell1}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell2}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell3}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell4}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell5}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell6}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell7}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell8}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell9}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell10}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell11}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell12}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell13}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell14}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell15}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell16}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell17}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell18}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    },
                    {
                      "width": "match",
                      "height": "content",
                      "widget": "LinearLayout",
                      "visibility": "visible",
                      "orientation": "horizontal",
                      "children": [
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "총합",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textStart"
                        },
                        {
                          "widgetPolicy": {
                            "allowedAttributes": [
                              "text",
                              "textAlignment",
                              "textColor",
                              "textSize",
                              "textStyle"
                            ]
                          },
                          "text": "{{cell20}}",
                          "width": "match",
                          "height": "content",
                          "weight": 1,
                          "widget": "TextView",
                          "textSize": "16dp",
                          "textColor": "#232323",
                          "textAlignment": "textEnd"
                        }
                      ]
                    },
                    {
                      "widgetPolicy": {
                        "allowedAttributes": [
                          "visibility"
                        ]
                      },
                      "width": "match",
                      "height": "1dp",
                      "widget": "View",
                      "background": "#232323",
                      "visibility": "gone",
                      "marginTop": "12dp",
                      "marginBottom": "12dp"
                    }
                  ]
                }
              ]
            }
          ]
        },
        "suggestions": [
          {
          }
        ]
      }
    }
  }
}
```

{% endtab %}

{% tab title="타이틀자유형-서술" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2022072604",
  "messagebaseformId": "TATA001D",
  "tmpltName": "타이틀자유형-서술",
  "agencyId": "",
  "formattedString": {
    "RCSMessage": {
      "trafficType": "advertisement",
      "openrichcardMessage": {
        "card": "open_rich_card",
        "version": "1.0.0",
        "zoomAllowed": true,
        "scaleAllowed": true,
        "suggestions": [
          {
          }
        ],
        "layout": {
          "widget": "LinearLayout",
          "width": "match",
          "height": "content",
          "orientation": "vertical",
          "children": [
            {
              "widget": "LinearLayout",
              "width": "match",
              "height": "content",
              "orientation": "vertical",
              "padding": "20dp",
              "children": [
                {
                  "widget": "LinearLayout",
                  "width": "match",
                  "height": "content",
                  "orientation": "horizontal",
                  "visibility": "visible",
                  "children": [
                    {
                      "widget": "TextView",
                      "width": "match",
                      "height": "content",
                      "textStyle": "bold",
                      "textAlignment": "textStart",
                      "text": "제목입니다.",
                      "textColor": "#232323",
                      "textSize": "19dp",
                      "weight": "1"
                    },
                    {
                      "widget": "TextView",
                      "width": "match",
                      "height": "content",
                      "textStyle": "bold",
                      "textAlignment": "textEnd",
                      "text": "",
                      "textColor": "#0094ff",
                      "textSize": "19dp",
                      "weight": "1",
                      "visibility": "gone"
                    }
                  ]
                },
                {
                  "width": "match",
                  "height": "3dp",
                  "widget": "View",
                  "background": "#232323",
                  "visibility": "visible",
                  "marginTop": "10dp",
                  "marginBottom": "12dp"
                },
                {
                  "widget": "TextView",
                  "width": "match",
                  "height": "content",
                  "text": "{{description}}입니다.",
                  "textColor": "#232323",
                  "textSize": "16dp"
                },
                {
                  "widget": "LinearLayout",
                  "width": "match",
                  "height": "content",
                  "orientation": "vertical",
                  "children": [
                    {
                      "widget": "Button",
                      "width": "match",
                      "height": "42dp",
                      "background": "#EAEAEA",
                      "textColor": "#0094ff",
                      "textSize": "16dp",
                      "text": "{{btnName1}}",
                      "textStyle": "normal",
                      "textAlignment": "center",
                      "click": {
                        "action": {
                          "urlAction": {
                            "openUrl": {
                              "url": ""
                            }
                          },
                          "displayText": "dummy"
                        }
                      },
                      "corner_radius": "8dp",
                      "visibility": "gone",
                      "marginTop": "12dp"
                    },
                    {
                      "widget": "Button",
                      "width": "match",
                      "height": "42dp",
                      "background": "#EAEAEA",
                      "textColor": "#0094ff",
                      "textSize": "16dp",
                      "text": "{{btnName2}}",
                      "textStyle": "normal",
                      "textAlignment": "center",
                      "click": {
                        "action": {
                          "urlAction": {
                            "openUrl": {
                              "url": ""
                            }
                          },
                          "displayText": "dummy"
                        }
                      },
                      "corner_radius": "8dp",
                      "visibility": "gone",
                      "marginTop": "8dp"
                    }
                  ]
                }
              ]
            }
          ]
        }
      }
    }
  }
}
```

{% endtab %}

{% tab title="타이틀선택형-출고" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test202406183",
  "messagebaseformId": "CC001C",
  "tmpltName": "타이틀선택형-출고",
  "agencyId": "",
  "formattedString": {
    "RCSMessage": {
      "trafficType": "advertisement",
      "openrichcardMessage": {
        "card": "open_rich_card",
        "layout": {
          "width": "284dp",
          "height": "content",
          "widget": "LinearLayout",
          "children": [
            {
              "width": "content",
              "height": "content",
              "widget": "ImageView",
              "mediaUrl": "maapfile://LT-messagebase.common-xpoKfv",
              "paddingTop": "16dp",
              "marginBottom": "8dp"
            },
            {
              "width": "match",
              "height": "content",
              "widget": "LinearLayout",
              "children": [
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "text": "{{1}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textStart"
                    },
                    {
                      "text": "{{2}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textEnd"
                    }
                  ],
                  "visibility": "visible",
                  "orientation": "horizontal",
                  "paddingBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "text": "{{3}}3",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textStart"
                    },
                    {
                      "text": "{{4}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textEnd"
                    }
                  ],
                  "visibility": "visible",
                  "orientation": "horizontal",
                  "paddingBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "text": "{{5}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textStart"
                    },
                    {
                      "text": "{{6}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textEnd"
                    }
                  ],
                  "visibility": "visible",
                  "orientation": "horizontal",
                  "paddingBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "text": "{{7}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textStart"
                    }
                  ],
                  "visibility": "visible",
                  "orientation": "horizontal",
                  "paddingBottom": "8dp"
                }
              ],
              "orientation": "vertical",
              "paddingBottom": "8dp"
            }
          ],
          "background": "#ffffff",
          "orientation": "vertical",
          "paddingLeft": "16dp",
          "paddingRight": "16dp"
        },
        "suggestions": [
        ],
        "zoomAllowed": "true"
      }
    }
  }
}
```

{% endtab %}

{% tab title="타이틀선택형-승인" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test202406182",
  "messagebaseformId": "FF001C",
  "tmpltName": "타이틀선택형-승인",
  "agencyId": "",
  "formattedString": {
    "RCSMessage": {
      "trafficType": "advertisement",
      "openrichcardMessage": {
        "card": "open_rich_card",
        "layout": {
          "width": "284dp",
          "height": "content",
          "widget": "LinearLayout",
          "children": [
            {
              "width": "content",
              "height": "content",
              "widget": "ImageView",
              "mediaUrl": "maapfile://LT-messagebase.common-9hEGL3",
              "paddingTop": "16dp",
              "marginBottom": "8dp"
            },
            {
              "width": "match",
              "height": "content",
              "widget": "LinearLayout",
              "children": [
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "text": "금액",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textStart"
                    },
                    {
                      "text": "{{금액}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textEnd"
                    }
                  ],
                  "visibility": "visible",
                  "orientation": "horizontal",
                  "paddingBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "1dp",
                  "widget": "View",
                  "background": "#c0c0c0",
                  "visibility": "visible",
                  "marginBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "text": "결제처",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textStart"
                    },
                    {
                      "text": "{{결제처}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textEnd"
                    }
                  ],
                  "visibility": "visible",
                  "orientation": "horizontal",
                  "paddingBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "text": "일시",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textStart"
                    },
                    {
                      "text": "{{일시}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textEnd"
                    }
                  ],
                  "visibility": "visible",
                  "orientation": "horizontal",
                  "paddingBottom": "8dp"
                },
                {
                  "width": "match",
                  "height": "content",
                  "widget": "LinearLayout",
                  "children": [
                    {
                      "text": "결제정보",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textStart"
                    },
                    {
                      "text": "{{결제정보}}",
                      "width": "match",
                      "height": "content",
                      "weight": 1,
                      "widget": "TextView",
                      "textSize": "14dp",
                      "textColor": "#404040",
                      "textAlignment": "textEnd"
                    }
                  ],
                  "visibility": "visible",
                  "orientation": "horizontal",
                  "paddingBottom": "8dp"
                }
              ],
              "orientation": "vertical",
              "paddingBottom": "8dp"
            }
          ],
          "background": "#ffffff",
          "orientation": "vertical",
          "paddingLeft": "16dp",
          "paddingRight": "16dp"
        },
        "zoomAllowed": true,
        "suggestions": [
          {
            "action": {
              "dialerAction": {
                "dialPhoneNumber": {
                  "phoneNumber": "070822401234"
                }
              },
              "displayText": "결제정보확인",
              "postback": {
                "data": "set_by_chatbot_dial_phone_number"
              }
            }
          }
        ]
      }
    }
  }
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>수정된템플릿ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="82">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="89">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정된템플릿ID(= messagebaseId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseId": "UBR.u720xwadx0-test202406182"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64106",
        "message": "Invalid messagebaseId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64318",
        "message": "Invalid formattedString format - cannot modify except specified key or value, check: mediaUrl"
    },
    "status": 400
}

{
    "error": {
        "code": "64318",
        "message": "Invalid formattedString format - non-variable sentences required"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 삭제

## Request

## 브랜드 내 지정된 템플릿을 삭제합니다.<br>

> 브랜드 내 지정된 템플릿을 삭제합니다.  \
> 템플릿의 삭제는 상태에 따라 처리 여부가 결정됩니다.  \
> 한번 삭제된 템플릿은 복원이 불가능하며 동일한 ID로 생성할 수 없습니다.\
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿\*\*\
> &#x20; \+ \*\*삭제 가능 상태 : 저장, 반려, 반려(수정), 승인\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"MessagebaseId":{"name":"messagebaseId","in":"path","schema":{"type":"string"},"required":true,"description":"messagebase ID Path parameter 입니다."}}},"paths":{"/brand/{brandId}/messagebase/{messagebaseId}":{"delete":{"summary":"브랜드 내 지정된 템플릿을 삭제합니다.\n","description":"브랜드 내 지정된 템플릿을 삭제합니다.  \n템플릿의 삭제는 상태에 따라 처리 여부가 결정됩니다.  \n한번 삭제된 템플릿은 복원이 불가능하며 동일한 ID로 생성할 수 없습니다.\n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿**\n  + **삭제 가능 상태 : 저장, 반려, 반려(수정), 승인**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/MessagebaseId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>삭제된 템플릿ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="82">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="89">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>삭제된 템플릿ID(= messagebaseId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseId": "UBR.u720xwadx0-test202406182"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64106",
        "message": "Invalid messagebaseId on path parameter"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 등록\_V2

## Request

## 브랜드 내에서 사용할 템플릿을 등록합니다. 모든 템플릿 등록이 가능합니다.<br>

> 브랜드 내에서 사용할 템플릿을 등록합니다.  \
> \
> 모든 템플릿 등록이 가능하며, 템플릿 등록 시 사용되는 messagebaseformId의 params의 각 항목 중 템플릿에\
> 표시될 내용을 입력하여 원하는 템플릿을 등록할 수 있습니다.\
> \
> 등록된 템플릿은 RCS Biz Center 운영자의 승인이 필요합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegTemplateInfo":{"description":"템플릿 등록 시 사용되는 Object 입니다.\n","type":"object","required":["brandId","messagebaseformId","custTmpltId","tmpltName","body"],"properties":{"brandId":{"description":"maxLength: 13 - 브랜드ID\n","type":"string","maxLength":13},"messagebaseformId":{"description":"maxLength: 10 - 템플릿 양식 ID\n","type":"string","maxLength":10},"custTmpltId":{"description":"maxLength: 25 - 사용자 지정 템플릿ID로 영문/숫자 25자 이내만 가능\n","type":"string","maxLength":25},"tmpltName":{"description":"maxLength: 40 - 템플릿명\n","type":"string","maxLength":40},"agencyId":{"description":"maxLength: 20 - 대행사ID\n","type":"string","maxLength":20},"body":{"description":"messagebaseform JSON의 ROOT.params[n-1] object의 type 이 file, string 인 경우, 각 속성에 맞는 데이터 Object를 사용하여 템플릿을 구성합니다.\n\nmessageabseform JSON의 ROOT.params[n-1].isMandatory 가 true 이면 템플릿 등록을 위해 필수로 등록해야 하는 요소이므로 반드시 데이터를 설정해야 템플릿 등록이 가능합니다.  \n\n변수 mTitleMedia, itemMedia 에 사용할 이미지는 브랜드 로고(logo) 등록 후 발급된 fileId를 지정해야 합니다.\n","type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/StringObject"},{"$ref":"#/components/schemas/FileObject"},{"$ref":"#/components/schemas/LineObject"}]}},"buttons":{"description":"템플릿에 버튼을 설정하는 경우 지정합니다.  \n\n이통사 발송규격에서 제공되는 buttons와 동일한 사용 방식으로 템플릿에 표시되는 버튼을 지정할수 있습니다.\n\n이미지 템플릿 슬라이드형의 경우 buttons 배열 내 object가 각 카드에 해당하며, object 하위 suggestions 배열 내에 messagebaseform의 policyInfo.maxButtonCount 지정 숫자 만큼 버튼을 등록할 수 있습니다.  \n\n지정 가능한 RCS 버튼 액션은 아래 링크의 파일을 확인해 주세요.\n\n**[버튼 Action 목록 Link](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)**\n\naction의 displayText, postback을 제외한 action 하위 항목에 다음과 같이 변수부를 지정할 수 있습니다.  \n\n  - urlAction: openUrl 하위 url 설정 값 중 URL 하위 경로만 변수 지정 가능 (예, https://www.rcsbizcenter.com/{{변수}})\n  - mapAction(좌표, 쿼리 방식): location 하위 속성의 값\n  - calendarAction: createCalendarEvent 하위 속성의 값\n  - clipboardAction: copyToClipboard 하위 속성의 값\n  - composeAction: composeTextMessage 하위 속성 값\n  - dialerAction: dialPhoneNumber 하위 속성의 값\n","type":"array","items":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/action"}}}}}}},"StringObject":{"description":"messagebaseform JSON의 ROOT.params[n-1].type이 string 인 경우, 템플릿에 등록할 Text 입력에 사용되는 Object 입니다.\n\ntype 하위 속성인 contentType의 값에 따라 입력 가능 형식에 차이가 있습니다.\n","type":"object","properties":{"param":{"type":"string","description":"maxLength: 20 \n\n  - messagebaseform JSON의 ROOT.params[n-1].param 과 동일한 값으로 템플릿 구성 Text의 표시 위치에 해당\n","maxLength":20},"value":{"type":"string","description":"param 에 지정할 Text를 입력합니다.\n\n  - messagebaseform의 ROOT.params[n-1].type이 string인 경우: 고정부와 변수부로 이루어진 문장\n  - messagebaseform의 ROOT.params[n-1].type이 string이고 ROOT.params[n-1].contentType이 url인 경우: http(s)://로 시작하는 URL 입력\n"},"setViewAll":{"type":"boolean","description":"viewAll(모두보기) 활성화 여부를 지정합니다. \n\nmessagebaseform.params의 각 Object 내 setViewAll이 포함된 Object에서만 사용 가능하며, 사용될 수 없는 Object에서 사용 시 무시됩니다. \n\n활성화 여부만 선택 가능하며, 활성화 시 viewAll의 글자수는 RBC 내부 로직에 의해 지정됩니다. \n\n* true: 메시지 내 대상 파라미터 viewAll(모두보기) 활성화 \n* false: 메시지 내 대상 파라미터 viewAll(모두보기) 비활성화\n\n> ※ viewAll은 메시지 내 문자열이 표시되는 영역에 설정된 글자수 이상이 입력된 경우, 대상 영역을 '모두보기 >' 표시와 함께 접힌 상태로 표시하는 메시지 규격입니다.  \n","default":true},"viewAll":{"type":"integer","default":150,"description":"viewAll(모두보기) 접힘 글자수 기준값을 지정합니다. \n\nmessagebaseform.params의 각 Object 내 viewAll이 포함된 Object에서만 사용 가능하며, 사용될 수 없는 Object에서 사용 시 무시됩니다. \n\n* 유효값: 150(default), 300\n* 유효값 이외 수치가 입력되는 경우 default로 처리됩니다.\n"},"decoration":{"$ref":"#/components/schemas/TextDecoration"}},"required":["param","value"]},"TextDecoration":{"description":"StringObject에서 사용되는 text 서식입니다.  \n\n서식을 지원하는 템플릿 상품인 경우 설정이 적용되며, 서식을 지원하지 않는 템플릿 상품에 설정하면 무시됩니다.\n","type":"object","properties":{"textSize":{"description":"maxLength: 6 - 글자 크기 지정시 사용합니다. \n숫자 뒤에 단위 dp를 반드시 붙여서 입력하여야 합니다.\n","type":"string","maxLength":6},"textAlignment":{"description":"문장 정렬 지정시 사용합니다. 지원하는 정렬의 종류는 다음과 같습니다.  \n\n  - textStart: 왼쪽 정렬\n  - center: 중앙 정렬\n  - textEnd: 오른쪽 정렬\n","type":"string","enum":["textStart","center","textEnd"]},"textStyle":{"description":"문장의 글자를 굵게 표현할 때 사용합니다.","type":"string","enum":["bold"]},"textColor":{"description":"maxLength: 7, minLength: 7 - 문장의 글자 색상을 지정한 색상 값으로 설정합니다.(색상코드 Hex 표현식)\n","type":"string","minLength":7,"maxLength":7}}},"FileObject":{"description":"messagebaseform JSON의 ROOT.params[n-1].type이 file 인 경우, 템플릿에 등록할 File 입력에 사용되는 Object 입니다.(현재는 이미지만 지원)\n","type":"object","properties":{"param":{"type":"string","description":"maxLength: 20 - messagebaseform JSON의 ROOT.params[n-1].param 과 동일한 값으로 템플릿 구성 File(이미지)의 표시 위치에 해당합니다.\n","maxLength":20},"value":{"type":"string","description":"maxLength: 20 - 템플릿에 지정할 File(이미지) - maapfile://{fileId} 형식으로 입력합니다.\n","maxLength":20}},"required":["param","value"]},"LineObject":{"type":"object","description":"Line을 표현할 수 있는 템플릿 상품인 경우 설정 시 적용되며 지원하지 않는 상품은 무시됩니다.  \n\n스타일 유형의 텍스트 템플릿이나 LMS 템플릿 중 테이블이 포함된 경우 Line을 지원합니다.  \n\nLineIndex는 테이블에 종속적이므로 테이블 내 행 번호 규칙을 따릅니다.  \n\n첫번째 테이블의 10개 행 사이의 lineIndex는 1 ~ 9까지 유효합니다.(마지막 행은 Line을 설정할 수 없습니다.)  \n\n두번째 테이블은 11 ~ 19, 세번째 테이블은 21 ~ 29 와 같은 방식으로 Index를 부여합니다. \n \n현재는 decoration은 지원하지 않습니다.\n","properties":{"lineIndex":{"description":"템플릿에 Line을 행별로 표시합니다. \n\n현재는 스타일(Cell) 템플릿에서 Text 행 아래 삽입되며 총 9개까지 지원합니다.  \n\nlineIndex 값은 템플릿 내의 지정 위치 값을 의미 합니다. 예를 들어 lineIndex 2는 두번째 Text 행 아래 입니다.\n","type":"integer","enum":[1,2,3,4,5,6,7,8,9,11,12,13,14,15,16,17,18,19]},"decoration":{"$ref":"#/components/schemas/LineDecoration"}},"required":["lineIndex"]},"LineDecoration":{"description":"LineObject에서 사용되는 서식입니다.  \n\n서식을 지원하는 템플릿 상품인 경우 설정이 적용되며, 서식을 지원하지 않는 템플릿 상품에 설정하면 무시됩니다.\n","type":"object","properties":{"height":{"description":"maxLength: 6 - Line의 굵기 지정시 사용합니다.  \n\n숫자 뒤에 단위 dp를 반드시 붙여서 입력하여야 합니다.\n","type":"string","maxLength":6},"background":{"description":"maxLength: 7, minLength: 7 - Line 색상을 지정한 색상 값으로 설정합니다. - 색상코드 Hex 표현식\n","type":"string","minLength":7,"maxLength":7}}},"action":{"description":"Common base definition of a suggested action.","type":"object","properties":{"action":{"type":"object","allOf":[{"$ref":"#/components/schemas/suggestion"},{"oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"},{"$ref":"#/components/schemas/mapAction"},{"$ref":"#/components/schemas/calendarAction"},{"$ref":"#/components/schemas/composeAction"},{"$ref":"#/components/schemas/clipboardAction"},{"$ref":"#/components/schemas/localBrowserAction"}]}]}},"required":["action"]},"suggestion":{"description":"Common base definition for suggested replies and suggested actions.","type":"object","properties":{"displayText":{"type":"string","minLength":1,"maxLength":25,"description":"maxLength: 25, minLength: 1\n"},"postback":{"description":"Definition of data to be posted back from UE to chatbot.\n","type":"object","properties":{"data":{"type":"string","maxLength":2048,"description":"maxLength: 2048\n"}},"required":["data"]}},"required":["displayText","postback"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]},"mapAction":{"description":"Suggested actions for interacting with a location on a map.","properties":{"mapAction":{"type":"object","oneOf":[{"properties":{"showLocation":{"description":"Shows a given location on a map.","type":"object","properties":{"location":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"label":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"}},"required":["latitude","longitude"]},"fallbackUrl":{"type":"string","format":"uri"}},"required":["location"]}},"required":["showLocation"]},{"properties":{"requestLocationPush":{"description":"One-time request to send a geo location push from UE to\nchatbot","type":"object","properties":{"currentLocation":{"description":"set true to send current location without location\nselection","type":"boolean"}}}},"required":["requestLocationPush"]}]}},"required":["mapAction"]},"calendarAction":{"description":"Suggested actions for interacting with a calendar event.","properties":{"calendarAction":{"type":"object","oneOf":[{"properties":{"createCalendarEvent":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"title":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"},"description":{"type":"string","minLength":1,"maxLength":500,"description":"maxLength: 500, minLength: 1\n"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["startTime","endTime","title"]}},"required":["createCalendarEvent"]}]}},"required":["calendarAction"]},"composeAction":{"description":"Suggested actions for composing draft messages.","properties":{"composeAction":{"type":"object","oneOf":[{"properties":{"composeTextMessage":{"description":"Compose a draft text message.","type":"object","properties":{"phoneNumber":{"type":"string"},"text":{"type":"string","maxLength":100,"description":"maxLength: 100\n"}},"required":["phoneNumber","text"]}},"required":["composeTextMessage"]},{"properties":{"composeRecordingMessage":{"description":"Compose a draft message with a media recording.","type":"object","properties":{"phoneNumber":{"type":"string"},"type":{"type":"string","enum":["AUDIO","VIDEO"]}}}},"required":["composeRecordingMessage"]}]}},"required":["composeAction"]},"clipboardAction":{"description":"Text to be copied to clipboard.","properties":{"clipboardAction":{"type":"object","oneOf":[{"properties":{"copyToClipboard":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"]}},"required":["copyToClipboard"]}]}},"required":["clipboardAction"]},"localBrowserAction":{"description":"(템플릿 버튼 등록 불가)Suggested actions using Internal Web browser to interact a\nwebsite or deep app link.","properties":{"localBrowserAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"isHalfView":{"description":"set true to show Internal Web browser in vertical half\nsize of screen","type":"boolean","default":false},"postParameter":{"description":"parameters to be sent as POST method when open url","type":"object"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["localBrowserAction"]}}},"paths":{"/brand/{brandId}/v2/messagebase":{"post":{"summary":"브랜드 내에서 사용할 템플릿을 등록합니다. 모든 템플릿 등록이 가능합니다.\n","description":"브랜드 내에서 사용할 템플릿을 등록합니다.  \n\n모든 템플릿 등록이 가능하며, 템플릿 등록 시 사용되는 messagebaseformId의 params의 각 항목 중 템플릿에\n표시될 내용을 입력하여 원하는 템플릿을 등록할 수 있습니다.\n\n등록된 템플릿은 RCS Biz Center 운영자의 승인이 필요합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegTemplateInfo"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="타이틀자유형-스타일" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062105",
  "messagebaseformId": "TATA001C",
  "tmpltName": "타이틀자유형-스타일",
  "agencyId": "",
  "body": [
    {
      "param": "title1",
      "value": "제목",
      "decoration": {
        "textStyle": "bold",
        "textSize": "18dp",
        "textAlignment": "textStart",
        "textColor": "#232329"
      }
    },
    {
        "param": "title2",
        "value": "{{2}}",
        "decoration": {
            "textStyle": "bold",
            "textSize": "18dp",
            "textAlignment": "textStart",
            "textColor": "#232329"
        }
    },
    {
      "param": "cell1",
      "value": "{{1}}"
    },
    {
      "param": "cell2",
      "value": "{{2}}"
    },
    {
      "param": "cell3",
      "value": "{{3}}"
    },
    {
      "param": "cell4",
      "value": "{{4}}"
    },      
    {
      "lineIndex": 2
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "dialerAction": {
              "dialPhoneNumber": {
                "phoneNumber": "1522{{지점번호}}"
              }
            },
            "displayText": "고객센터",
            "postback": {
              "data": "set_by_chatbot_dial_phone_number"
            }
          }
        },
        {}
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="타이틀자유형-서술" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024061905",
  "messagebaseformId": "TATA001D",
  "tmpltName": "타이틀자유형-서술",
  "agencyId": "",
  "body": [
    {
      "param": "title1",
      "value": "제목"
    },
    {
      "param": "description",
      "value": "내일 서울 낮 기온은 {{내일기온}}도로 오늘보다 {{온도차이}}도 정도 더 높겠습니다."
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "displayText": "url 연결_수정",
            "postback": {
              "data": "set_by_chatbot_open_url"
            },
            "urlAction": {
              "openUrl": {
                "url": "https://phoneppu.com"
              }
            }
          }
        },
        {
          "action": {
            "dialerAction": {
              "dialPhoneNumber": {
                "phoneNumber": "1522{{지점번호}}"
              }
            },
            "displayText": "고객센터",
            "postback": {
              "data": "set_by_chatbot_dial_phone_number"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="이미지&타이틀 강조형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062001",
  "messagebaseformId": "ITHITS",
  "tmpltName": "이미지&타이틀 강조형",
  "agencyId": "",
  "body": [
    {
      "param": "media",
      "value": "maapfile://LT-logo.common-Efehqa"
    },
    {
      "param": "mediaUrl",
      "value": "https://post.naver.com/viewer/postView.naver?memberNo=49797427&volumeNo=34609427&abvc={{abvc}}"
    },
    {
      "param": "title",
      "value": "메리어트 창립 95주년을 맞아 한국을 찾았다."
    },
    {
      "param": "subTitle1",
      "value": "이벤트"
    },
    {
      "param": "subDesc1",
      "value": "최근 여행업계에는 다시 ‘봄’이 찾아온 모습이다."
    },
    {
      "param": "subTitle2",
      "value": "여행업계"
    },
    {
      "param": "subDesc2",
      "value": "제주도는 내국인 관광객 1000만 명을 돌파했다."
    },
    {
      "param": "subTitle3",
      "value": "가을여행"
    },
    {
      "param": "subDesc3",
      "value": "{{이것}}의 긍정적인 부분은 이 숫자 역시 빠르게 회복 중이라는 것"
    }
  ]
}{
```

{% endtab %}

{% tab title="이미지강조형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062010",
  "messagebaseformId": "ITHIMS",
  "tmpltName": "이미지강조형",
  "agencyId": "",
  "body": [
    {
      "param": "media",
      "value": "maapfile://LT-logo.common-Efehqa"
    },
    {
      "param": "mediaUrl",
      "value": "https://www.kurly.com/{{shop}}/event/kurlyEvent.php?htmid=event%2Fjoin%2Fjoin&%243p=a_custom_741527000799871056&%24deeplink_path=home&%24android_passive_deepview=false&%24ios_passive_deepview=false&~tags=3004&~stage=2210&~campaign=1000072629&~keyword=non_time_B_101412&utm_source=3004&utm_medium=2210&utm_campaign=1000072629&utm_content=non_time_B_101412&_branch_match_id=1037612873204479401&_branch_referrer=H4sIAAAAAAAAA32P3W6EIBSEnwYvFdCV2oQ0bXb3oi9BWKQLVX4iKNm3L2h71aYJyeGbM0wGFaMPz00zrcv8qLn39azt1Kj3KBLp57O4vQDctZ5yJtYQnWGkQydMIIRkGJ4Igqe%2Byo5RSl9eMs%2BjosoZWVRux8XpMYsh6E2y4tq0TPSDz2F3aBf%2B2ebLfONiYrkdVaUqaF8BvuaTUqqP0sKZzEE5n4fcpI157qtLgdorD9qrikaPoD3%2FGD6dtt%2BjAuQS%2BT3QFsKuQMgkKcYIFhLceK7vliJYfo17PBR5ko%2FklpFaZ1nURrI3hiDqEK7WaFhw6yLkkVjYyFGv5sgs%2FFforjsbc8HfqV%2BPT9huqQEAAA%3D%3D"
    },
    {
      "param": "title",
      "value": "한국 시장의 2022년 3분기 예측"
    },
    {
      "param": "description",
      "value": "코로나19 사태 이전의 수요를 회복한 것을 넘어 더욱 성장했다는 점에서 큰 의미가 있다. 앞으로의 전망도 밝다. 최근의 상황을 봤을 때 4분기에는 코로나19 사태 이후 처음으로 객실 예약률이 {{퍼센트}}%가 넘을 것으로 예측된다.",
      "decoration": {}
    },
    {
      "param": "subTitle1",
      "value": "이벤트"
    },
    {
      "param": "subDesc1",
      "value": "최근 여행업계에는 다시 ‘봄’이 찾아온 모습이다."
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "mapAction": {
              "showLocation": {
                "location": {
                  "latitude": "14133843.9742104",
                  "longitude": "4516756.2469226",
                  "label": "서울역"
                },
                "fallbackUrl": "https://info.korail.com/info/index.do"
              }
            },
            "displayText": "서울역",
            "postback": {
              "data": "set_by_chatbot_show_location"
            }
          }
        },
        {
          "action": {
            "clipboardAction": {
              "copyToClipboard": {
                "text": "{{복사텍스트}} 되었습니다."
              }
            },
            "displayText": "복사하기",
            "postback": {
              "data": "set_by_chatbot_copy_to_clipboard"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="썸네일형 " %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062004",
  "messagebaseformId": "ITTBNH",
  "tmpltName": "썸네일형",
  "agencyId": "",
    "body": [
        {
            "param": "media",
            "value": "maapfile://LT-BR.kpxN0UgshA-6eyF"
        },
        {
            "param": "mediaUrl",
            "value": "https://www.paris.co.kr/{{URL1}}/{{URL2}}"
        },
        {
            "param": "title1",
            "value": "오픈호텔"
        },
        {
            "param": "description",
            "value": "2018년부터 오픈한 호텔이 {{오픈개수}}개에 달한다. 그리고 내년 초까지 {{신규도시}} 등에 총 5개의 신규 호텔이 문을 연다. 이렇게 되면 총 18개의 호텔을 한국에서 운영하게 된다."
        },
        {
            "param": "subMedia1",
            "value": "maapfile://LT-BR.kpxN0UgshA-rCLj"
        },
        {
            "param": "subMediaUrl1",
            "value": "https://n.news.naver.com/article/016/{{articleId1}}"
        },
        {
            "param": "subMedia2",
            "value": "maapfile://LT-BR.kpxN0UgshA-F8C5"
        },
        {
            "param": "subMediaUrl2",
            "value": "https://n.news.naver.com/article/050/{{articleId2}}"
        },
        {
            "param": "subMedia3",
            "value": "maapfile://LT-BR.kpxN0UgshA-HOCI"
        }
    ],
    "buttons": []
}
```

{% endtab %}

{% tab title="SNS형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062006",
  "messagebaseformId": "ITSNSH",
  "tmpltName": "SNS형",
  "agencyId": "",
  "body": [
    {
      "param": "media",
      "value": "maapfile://LT-logo.common-34FDUE"
    },
    {
      "param": "mediaUrl",
      "value": "http://rcsbizcenter.com"
    },
    {
      "param": "title",
      "value": "상품명에 '마약' 이름 못쓴다.",
      "decoration": {}
    },
    {
      "param": "description",
      "value": "앞으로 '{{금지단어}}김밥', '{{금지단어}}떡볶이'등 '{{금지단어}}'이라는 단어를 상품명 앞에 붙일 수 없을 것으로 보인다.",
      "decoration": {}
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "calendarAction": {
              "createCalendarEvent": {
                "startTime": "2022-09-01T00:00:00+09",
                "endTime": "2022-09-30T00:00:00+09",
                "title": "호텔 숙박 이벤트를 실시합니다!",
                "description": "{{이벤트설명}}"
              }
            },
            "displayText": "호텔 숙박 이벤트를 실시합니다",
            "postback": {
              "data": "set_by_chatbot_create_calendar_event"
            }
          }
        },
        {
          "action": {
            "mapAction": {
              "requestLocationPush": {}
            },
            "displayText": "현재위치를 보내드립니다",
            "postback": {
              "data": "set_by_chatbot_request_location_push"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="슬라이드형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test20240620",
  "messagebaseformId": "ITCRM3",
  "tmpltName": "슬라이드형",
  "agencyId": "",
  "body": [
    {
      "param": "media1",
      "value": "maapfile://LT-logo.common-34FDUE"
    },
    {
      "param": "description1",
      "value": "내용 1번이 들어갑니다."
    },
    {
      "param": "media2",
      "value": "maapfile://LT-logo.common-34FDUE"
    },
    {
      "param": "title2",
      "value": "제 2장, {{ttl2}}"
    },
    {
      "param": "description2",
      "value": "제 2장, 설명: {{desc2}}"
    },
    {
      "param": "media3",
      "value": "maapfile://LT-logo.common-34FDUE"
    },
    {
      "param": "description3",
      "value": "제 3장, 설명"
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {},
        {
          "action": {
            "dialerAction": {
              "dialPhoneNumber": {
                "phoneNumber": "15221601"
              }
            },
            "displayText": "고객센터1",
            "postback": {
              "data": "set_by_chatbot_dial_phone_number"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="LMS형-기본" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062109",
  "messagebaseformId": "CLL00004",
  "tmpltName": "LMS형-기본",
  "agencyId": "",
  "body": [
    {
      "param": "mTitle",
      "value": "움직이는 아이콘!:수박:"
    },
    {
      "param": "description",
      "value": "내용만 입력합니다.\n{{1}}님 안녕하세요.\n동해물과 백두산이 {{2}} 하느님이 보우하사 우리 나라 만세!!\n{{2}}\n동일한 변수를 반복해서 써 봅니다.\n{{2}}"
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.rcsbizcenter.com"
              }
            },
            "displayText": "URL 버튼 입니다.",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="LMS형-명세서" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062110",
  "messagebaseformId": "CLL00001",
  "tmpltName": "LMS형-명세서",
  "agencyId": "",
  "body": [
    {
      "param": "cellLeft1",
      "value": "납부정보"
    },
    {
      "param": "cellLeft2",
      "value": "자동납부"
    },
    {
      "param": "cellLeft3",
      "value": "승인예정일"
    },
    {
      "param": "cellLeft4",
      "value": "통신요금"
    },
    {
      "param": "cellLeft5",
      "value": "부가사용금액"
    },
    {
      "param": "cellLeft6",
      "value": "납부하실금액"
    },
    {
      "param": "cellRight2",
      "value": "{{place}}}}"
    },
    {
      "param": "cellRight3",
      "value": "{{Month}}월{{day}}일"
    },
    {
      "param": "cellRight4",
      "value": "{{amount1}}"
    },
    {
      "param": "cellRight5",
      "value": "{{amount2}}"
    },
    {
      "param": "cellRight6",
      "value": "{{vat}}"
    },
    {
      "param": "mTitle",
      "value": "청구서함"
    },
    {
      "lineIndex": 1
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www-qa.rcsbizcenter.com/"
              }
            },
            "displayText": "청구서함바로가기",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="테이블아이템 강조형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "custTmpltId": "test2024062115",
  "messagebaseformId": "CLT00001",
  "tmpltName": "테이블아이템 강조형",
  "agencyId": "",
  "body": [
    {
      "param": "itemTitle",
      "value": "명세서"
    },
    {
      "param": "itemMedia",
      "value": "LT-messagebase.common-2k8ydI"
    },
    {
      "param": "cellLeft1",
      "value": "누적"
    },
    {
      "param": "cellLeft2",
      "value": "일시불"
    },
    {
      "param": "cellLeft3",
      "value": "할부"
    },
    {
      "param": "cellLeft4",
      "value": "합계"
    },
    {
      "param": "cellRight1",
      "value": "{{누적금액}}"
    },
    {
      "param": "cellRight2",
      "value": "{{일시불금액}}"
    },
    {
      "param": "cellRight3",
      "value": "{{할부금}}"
    },
    {
      "param": "cellRight4",
      "value": "{{합계총액}}"
    },
    {
      "lineIndex": 1
    },
    {
      "lineIndex": 3
    }
  ],
  "buttons": []
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 템플릿ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="82">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="89">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>등록된 템플릿ID(= messagebaseId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseId": "UBR.u720xwadx0-test202406182"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64106",
        "message": "Invalid messagebaseId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64318",
        "message": "Invalid formattedString format - [media's value] file not logo type or not registered"
    },
    "status": 400
}

{
    "error": {
        "code": "64400",
        "message": "required 900x900,  image resolution is 280x103 (param:media, fileId:LT-messagebase.common-Zno7xg)"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 수정\_V2

## Request

## 이미 등록된 템플릿의 내용을 수정합니다.<br>

> 이미 등록된 템플릿의 내용을 수정합니다. messagebase의 ID를 유지하면서 내용을 변경하고자 하는 경우 사용이 가능합니다.\
> \
> 수정 등록된 템플릿은 RCS Biz Center 운영자의 승인이 필요합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"MessagebaseId":{"name":"messagebaseId","in":"path","schema":{"type":"string"},"required":true,"description":"messagebase ID Path parameter 입니다."}},"schemas":{"ModTemplateInfo":{"description":"템플릿 수정 시 사용되는 Object 입니다.\n","type":"object","required":["brandId","tmpltName","body"],"properties":{"brandId":{"description":"maxLength: 13 - 브랜드ID\n","type":"string","maxLength":13},"messagebaseformId":{"description":"maxLength: 10 - 템플릿 양식 ID\n","type":"string","maxLength":10},"tmpltName":{"description":"maxLength: 40 - 템플릿명\n","type":"string","maxLength":40},"agencyId":{"description":"maxLength: 20 - 대행사ID\n","type":"string","maxLength":20},"body":{"description":"messagebaseform JSON의 ROOT.params[n-1] object의 type 이 file, string 인 경우, 각 속성에 맞는 데이터 Object를 사용하여 템플릿을 구성합니다.\n\nmessageabseform JSON의 ROOT.params[n-1].isMandatory 가 true 이면 템플릿 등록을 위해 필수로 등록해야 하는 요소이므로 반드시 데이터를 설정해야 템플릿 등록이 가능합니다.\n","type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/StringObject"},{"$ref":"#/components/schemas/FileObject"},{"$ref":"#/components/schemas/LineObject"}]}},"buttons":{"description":"템플릿에 버튼을 설정하는 경우 지정합니다.  \n\n이통사 발송규격에서 제공되는 buttons와 동일한 사용 방식으로 템플릿에 표시되는 버튼을 지정할수 있습니다.\n\n이미지 템플릿 슬라이드형의 경우 buttons 배열 내 object가 각 카드에 해당하며, object 하위 suggestions 배열 내에 messagebaseform의 policyInfo.maxButtonCount 지정 숫자 만큼 버튼을 등록할 수 있습니다.\n\n지정 가능한 RCS 버튼 액션은 아래 링크의 파일을 확인해 주세요.\n\n**[버튼 Action 목록 Link](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)**\n\naction의 displayText, postback을 제외한 action 하위 항목에 다음과 같이 변수부를 지정할 수 있습니다.\n\n  - urlAction: openUrl 하위 url 설정 값 중 URL 하위 경로만 변수 지정 가능 (예, https://www.rcsbizcenter.com/{{변수}})\n  - mapAction(좌표, 쿼리 방식): location 하위 속성의 값\n  - calendarAction: createCalendarEvent 하위 속성의 값\n  - clipboardAction: copyToClipboard 하위 속성의 값\n  - composeAction: composeTextMessage 하위 속성 값\n  - dialerAction: dialPhoneNumber 하위 속성의 값\n","type":"array","items":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/action"}}}}}}},"StringObject":{"description":"messagebaseform JSON의 ROOT.params[n-1].type이 string 인 경우, 템플릿에 등록할 Text 입력에 사용되는 Object 입니다.\n\ntype 하위 속성인 contentType의 값에 따라 입력 가능 형식에 차이가 있습니다.\n","type":"object","properties":{"param":{"type":"string","description":"maxLength: 20 \n\n  - messagebaseform JSON의 ROOT.params[n-1].param 과 동일한 값으로 템플릿 구성 Text의 표시 위치에 해당\n","maxLength":20},"value":{"type":"string","description":"param 에 지정할 Text를 입력합니다.\n\n  - messagebaseform의 ROOT.params[n-1].type이 string인 경우: 고정부와 변수부로 이루어진 문장\n  - messagebaseform의 ROOT.params[n-1].type이 string이고 ROOT.params[n-1].contentType이 url인 경우: http(s)://로 시작하는 URL 입력\n"},"setViewAll":{"type":"boolean","description":"viewAll(모두보기) 활성화 여부를 지정합니다. \n\nmessagebaseform.params의 각 Object 내 setViewAll이 포함된 Object에서만 사용 가능하며, 사용될 수 없는 Object에서 사용 시 무시됩니다. \n\n활성화 여부만 선택 가능하며, 활성화 시 viewAll의 글자수는 RBC 내부 로직에 의해 지정됩니다. \n\n* true: 메시지 내 대상 파라미터 viewAll(모두보기) 활성화 \n* false: 메시지 내 대상 파라미터 viewAll(모두보기) 비활성화\n\n> ※ viewAll은 메시지 내 문자열이 표시되는 영역에 설정된 글자수 이상이 입력된 경우, 대상 영역을 '모두보기 >' 표시와 함께 접힌 상태로 표시하는 메시지 규격입니다.  \n","default":true},"viewAll":{"type":"integer","default":150,"description":"viewAll(모두보기) 접힘 글자수 기준값을 지정합니다. \n\nmessagebaseform.params의 각 Object 내 viewAll이 포함된 Object에서만 사용 가능하며, 사용될 수 없는 Object에서 사용 시 무시됩니다. \n\n* 유효값: 150(default), 300\n* 유효값 이외 수치가 입력되는 경우 default로 처리됩니다.\n"},"decoration":{"$ref":"#/components/schemas/TextDecoration"}},"required":["param","value"]},"TextDecoration":{"description":"StringObject에서 사용되는 text 서식입니다.  \n\n서식을 지원하는 템플릿 상품인 경우 설정이 적용되며, 서식을 지원하지 않는 템플릿 상품에 설정하면 무시됩니다.\n","type":"object","properties":{"textSize":{"description":"maxLength: 6 - 글자 크기 지정시 사용합니다. \n숫자 뒤에 단위 dp를 반드시 붙여서 입력하여야 합니다.\n","type":"string","maxLength":6},"textAlignment":{"description":"문장 정렬 지정시 사용합니다. 지원하는 정렬의 종류는 다음과 같습니다.  \n\n  - textStart: 왼쪽 정렬\n  - center: 중앙 정렬\n  - textEnd: 오른쪽 정렬\n","type":"string","enum":["textStart","center","textEnd"]},"textStyle":{"description":"문장의 글자를 굵게 표현할 때 사용합니다.","type":"string","enum":["bold"]},"textColor":{"description":"maxLength: 7, minLength: 7 - 문장의 글자 색상을 지정한 색상 값으로 설정합니다.(색상코드 Hex 표현식)\n","type":"string","minLength":7,"maxLength":7}}},"FileObject":{"description":"messagebaseform JSON의 ROOT.params[n-1].type이 file 인 경우, 템플릿에 등록할 File 입력에 사용되는 Object 입니다.(현재는 이미지만 지원)\n","type":"object","properties":{"param":{"type":"string","description":"maxLength: 20 - messagebaseform JSON의 ROOT.params[n-1].param 과 동일한 값으로 템플릿 구성 File(이미지)의 표시 위치에 해당합니다.\n","maxLength":20},"value":{"type":"string","description":"maxLength: 20 - 템플릿에 지정할 File(이미지) - maapfile://{fileId} 형식으로 입력합니다.\n","maxLength":20}},"required":["param","value"]},"LineObject":{"type":"object","description":"Line을 표현할 수 있는 템플릿 상품인 경우 설정 시 적용되며 지원하지 않는 상품은 무시됩니다.  \n\n스타일 유형의 텍스트 템플릿이나 LMS 템플릿 중 테이블이 포함된 경우 Line을 지원합니다.  \n\nLineIndex는 테이블에 종속적이므로 테이블 내 행 번호 규칙을 따릅니다.  \n\n첫번째 테이블의 10개 행 사이의 lineIndex는 1 ~ 9까지 유효합니다.(마지막 행은 Line을 설정할 수 없습니다.)  \n\n두번째 테이블은 11 ~ 19, 세번째 테이블은 21 ~ 29 와 같은 방식으로 Index를 부여합니다. \n \n현재는 decoration은 지원하지 않습니다.\n","properties":{"lineIndex":{"description":"템플릿에 Line을 행별로 표시합니다. \n\n현재는 스타일(Cell) 템플릿에서 Text 행 아래 삽입되며 총 9개까지 지원합니다.  \n\nlineIndex 값은 템플릿 내의 지정 위치 값을 의미 합니다. 예를 들어 lineIndex 2는 두번째 Text 행 아래 입니다.\n","type":"integer","enum":[1,2,3,4,5,6,7,8,9,11,12,13,14,15,16,17,18,19]},"decoration":{"$ref":"#/components/schemas/LineDecoration"}},"required":["lineIndex"]},"LineDecoration":{"description":"LineObject에서 사용되는 서식입니다.  \n\n서식을 지원하는 템플릿 상품인 경우 설정이 적용되며, 서식을 지원하지 않는 템플릿 상품에 설정하면 무시됩니다.\n","type":"object","properties":{"height":{"description":"maxLength: 6 - Line의 굵기 지정시 사용합니다.  \n\n숫자 뒤에 단위 dp를 반드시 붙여서 입력하여야 합니다.\n","type":"string","maxLength":6},"background":{"description":"maxLength: 7, minLength: 7 - Line 색상을 지정한 색상 값으로 설정합니다. - 색상코드 Hex 표현식\n","type":"string","minLength":7,"maxLength":7}}},"action":{"description":"Common base definition of a suggested action.","type":"object","properties":{"action":{"type":"object","allOf":[{"$ref":"#/components/schemas/suggestion"},{"oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"},{"$ref":"#/components/schemas/mapAction"},{"$ref":"#/components/schemas/calendarAction"},{"$ref":"#/components/schemas/composeAction"},{"$ref":"#/components/schemas/clipboardAction"},{"$ref":"#/components/schemas/localBrowserAction"}]}]}},"required":["action"]},"suggestion":{"description":"Common base definition for suggested replies and suggested actions.","type":"object","properties":{"displayText":{"type":"string","minLength":1,"maxLength":25,"description":"maxLength: 25, minLength: 1\n"},"postback":{"description":"Definition of data to be posted back from UE to chatbot.\n","type":"object","properties":{"data":{"type":"string","maxLength":2048,"description":"maxLength: 2048\n"}},"required":["data"]}},"required":["displayText","postback"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]},"mapAction":{"description":"Suggested actions for interacting with a location on a map.","properties":{"mapAction":{"type":"object","oneOf":[{"properties":{"showLocation":{"description":"Shows a given location on a map.","type":"object","properties":{"location":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"label":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"}},"required":["latitude","longitude"]},"fallbackUrl":{"type":"string","format":"uri"}},"required":["location"]}},"required":["showLocation"]},{"properties":{"requestLocationPush":{"description":"One-time request to send a geo location push from UE to\nchatbot","type":"object","properties":{"currentLocation":{"description":"set true to send current location without location\nselection","type":"boolean"}}}},"required":["requestLocationPush"]}]}},"required":["mapAction"]},"calendarAction":{"description":"Suggested actions for interacting with a calendar event.","properties":{"calendarAction":{"type":"object","oneOf":[{"properties":{"createCalendarEvent":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"title":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"},"description":{"type":"string","minLength":1,"maxLength":500,"description":"maxLength: 500, minLength: 1\n"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["startTime","endTime","title"]}},"required":["createCalendarEvent"]}]}},"required":["calendarAction"]},"composeAction":{"description":"Suggested actions for composing draft messages.","properties":{"composeAction":{"type":"object","oneOf":[{"properties":{"composeTextMessage":{"description":"Compose a draft text message.","type":"object","properties":{"phoneNumber":{"type":"string"},"text":{"type":"string","maxLength":100,"description":"maxLength: 100\n"}},"required":["phoneNumber","text"]}},"required":["composeTextMessage"]},{"properties":{"composeRecordingMessage":{"description":"Compose a draft message with a media recording.","type":"object","properties":{"phoneNumber":{"type":"string"},"type":{"type":"string","enum":["AUDIO","VIDEO"]}}}},"required":["composeRecordingMessage"]}]}},"required":["composeAction"]},"clipboardAction":{"description":"Text to be copied to clipboard.","properties":{"clipboardAction":{"type":"object","oneOf":[{"properties":{"copyToClipboard":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"]}},"required":["copyToClipboard"]}]}},"required":["clipboardAction"]},"localBrowserAction":{"description":"(템플릿 버튼 등록 불가)Suggested actions using Internal Web browser to interact a\nwebsite or deep app link.","properties":{"localBrowserAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"isHalfView":{"description":"set true to show Internal Web browser in vertical half\nsize of screen","type":"boolean","default":false},"postParameter":{"description":"parameters to be sent as POST method when open url","type":"object"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["localBrowserAction"]}}},"paths":{"/brand/{brandId}/v2/messagebase/{messagebaseId}":{"put":{"summary":"이미 등록된 템플릿의 내용을 수정합니다.\n","description":"이미 등록된 템플릿의 내용을 수정합니다. messagebase의 ID를 유지하면서 내용을 변경하고자 하는 경우 사용이 가능합니다.\n\n수정 등록된 템플릿은 RCS Biz Center 운영자의 승인이 필요합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/MessagebaseId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModTemplateInfo"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="타이틀자유형-스타일" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "TATA001C",
  "tmpltName": "타이틀자유형-스타일",
  "agencyId": "",
  "body": [
    {
      "param": "title1",
      "value": "제목1",
      "decoration": {
        "textStyle": "bold",
        "textSize": "18dp",
        "textAlignment": "textStart",
        "textColor": "#232329"
      }
    }, 
    {
        "param": "title2",
        "value": "{{2}}",
        "decoration": {
            "textStyle": "bold",
            "textSize": "18dp",
            "textAlignment": "textStart",
            "textColor": "#232329"
        }
    },
    {
      "param": "cell1",
      "value": "{{1}}"
    },
    {
      "param": "cell2",
      "value": "{{2}}"
    },
    {
      "param": "cell3",
      "value": "{{3}}"
    },
    {
      "param": "cell4",
      "value": "{{4}}"
    },      
    {
      "lineIndex": 2
    }
  ],
  "buttons": [
    {
      "click": [
        {
          "action": {
            "dialerAction": {
              "dialPhoneNumber": {
                "phoneNumber": "1522{{지점번호}}"
              }
            },
            "displayText": "고객센터"
          }
        },
        {}
      ]
    }
  ]  
}
```

{% endtab %}

{% tab title="타이틀자유형-서술" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "TATA001D",
  "tmpltName": "타이틀자유형-서술",
  "agencyId": "",
  "body": [
    {
      "param": "title1",
      "value": "제목"
    },
    {
      "param": "description",
      "value": "내일 서울 낮 기온은 {{내일기온}}도로 오늘보다 {{온도차이}}도 정도 더 높겠습니다."
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "displayText": "url 연결_수정",
            "postback": {
              "data": "set_by_chatbot_open_url"
            },
            "urlAction": {
              "openUrl": {
                "url": "https://phoneppu.com"
              }
            }
          }
        },
        {
          "action": {
            "dialerAction": {
              "dialPhoneNumber": {
                "phoneNumber": "1522{{지점번호}}"
              }
            },
            "displayText": "고객센터",
            "postback": {
              "data": "set_by_chatbot_dial_phone_number"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="이미지&타이틀 강조형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "ITHITS",
  "tmpltName": "이미지&타이틀 강조형",
  "agencyId": "",
  "body": [
    {
      "param": "media",
      "value": "maapfile://LT-logo.common-Efehqa"
    },
    {
      "param": "mediaUrl",
      "value": "https://post.naver.com/viewer/postView.naver?memberNo=49797427&volumeNo=34609427&abvc={{abvc}}"
    },
    {
      "param": "title",
      "value": "메리어트 창립 95주년을 맞아 한국을 찾았다."
    },
    {
      "param": "subTitle1",
      "value": "이벤트"
    },
    {
      "param": "subDesc1",
      "value": "최근 여행업계에는 다시 ‘봄’이 찾아온 모습이다."
    },
    {
      "param": "subTitle2",
      "value": "여행업계"
    },
    {
      "param": "subDesc2",
      "value": "제주도는 내국인 관광객 1000만 명을 돌파했다."
    },
    {
      "param": "subTitle3",
      "value": "가을여행"
    },
    {
      "param": "subDesc3",
      "value": "{{이것}}의 긍정적인 부분은 이 숫자 역시 빠르게 회복 중이라는 것"
    }
  ]
}{
```

{% endtab %}

{% tab title="이미지강조형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "ITHIMS",
  "tmpltName": "이미지강조형",
  "agencyId": "",
  "body": [
    {
      "param": "media",
      "value": "maapfile://LT-logo.common-Efehqa"
    },
    {
      "param": "mediaUrl",
      "value": "https://www.kurly.com/{{shop}}/event/kurlyEvent.php?htmid=event%2Fjoin%2Fjoin&%243p=a_custom_741527000799871056&%24deeplink_path=home&%24android_passive_deepview=false&%24ios_passive_deepview=false&~tags=3004&~stage=2210&~campaign=1000072629&~keyword=non_time_B_101412&utm_source=3004&utm_medium=2210&utm_campaign=1000072629&utm_content=non_time_B_101412&_branch_match_id=1037612873204479401&_branch_referrer=H4sIAAAAAAAAA32P3W6EIBSEnwYvFdCV2oQ0bXb3oi9BWKQLVX4iKNm3L2h71aYJyeGbM0wGFaMPz00zrcv8qLn39azt1Kj3KBLp57O4vQDctZ5yJtYQnWGkQydMIIRkGJ4Igqe%2Byo5RSl9eMs%2BjosoZWVRux8XpMYsh6E2y4tq0TPSDz2F3aBf%2B2ebLfONiYrkdVaUqaF8BvuaTUqqP0sKZzEE5n4fcpI157qtLgdorD9qrikaPoD3%2FGD6dtt%2BjAuQS%2BT3QFsKuQMgkKcYIFhLceK7vliJYfo17PBR5ko%2FklpFaZ1nURrI3hiDqEK7WaFhw6yLkkVjYyFGv5sgs%2FFforjsbc8HfqV%2BPT9huqQEAAA%3D%3D"
    },
    {
      "param": "title",
      "value": "한국 시장의 2022년 3분기 예측"
    },
    {
      "param": "description",
      "value": "코로나19 사태 이전의 수요를 회복한 것을 넘어 더욱 성장했다는 점에서 큰 의미가 있다. 앞으로의 전망도 밝다. 최근의 상황을 봤을 때 4분기에는 코로나19 사태 이후 처음으로 객실 예약률이 {{퍼센트}}%가 넘을 것으로 예측된다.",
      "decoration": {}
    },
    {
      "param": "subTitle1",
      "value": "이벤트"
    },
    {
      "param": "subDesc1",
      "value": "최근 여행업계에는 다시 ‘봄’이 찾아온 모습이다."
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "mapAction": {
              "showLocation": {
                "location": {
                  "latitude": "14133843.9742104",
                  "longitude": "4516756.2469226",
                  "label": "서울역"
                },
                "fallbackUrl": "https://info.korail.com/info/index.do"
              }
            },
            "displayText": "서울역",
            "postback": {
              "data": "set_by_chatbot_show_location"
            }
          }
        },
        {
          "action": {
            "clipboardAction": {
              "copyToClipboard": {
                "text": "{{복사텍스트}} 되었습니다."
              }
            },
            "displayText": "복사하기",
            "postback": {
              "data": "set_by_chatbot_copy_to_clipboard"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="썸네일형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "ITTBNH",
  "tmpltName": "썸네일형",
  "agencyId": "",
    "body": [
        {
            "param": "media",
            "value": "maapfile://LT-BR.kpxN0UgshA-6eyF"
        },
        {
            "param": "mediaUrl",
            "value": "https://www.paris.co.kr/{{URL1}}/{{URL2}}"
        },
        {
            "param": "title1",
            "value": "오픈호텔"
        },
        {
            "param": "description",
            "value": "2018년부터 오픈한 호텔이 {{오픈개수}}개에 달한다. 그리고 내년 초까지 {{신규도시}} 등에 총 5개의 신규 호텔이 문을 연다. 이렇게 되면 총 18개의 호텔을 한국에서 운영하게 된다."
        },
        {
            "param": "subMedia1",
            "value": "maapfile://LT-BR.kpxN0UgshA-rCLj"
        },
        {
            "param": "subMediaUrl1",
            "value": "https://n.news.naver.com/article/016/{{articleId1}}"
        },
        {
            "param": "subMedia2",
            "value": "maapfile://LT-BR.kpxN0UgshA-F8C5"
        },
        {
            "param": "subMediaUrl2",
            "value": "https://n.news.naver.com/article/050/{{articleId2}}"
        },
        {
            "param": "subMedia3",
            "value": "maapfile://LT-BR.kpxN0UgshA-HOCI"
        }
    ],
    "buttons": []
}
```

{% endtab %}

{% tab title="SNS형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "ITSNSH",
  "tmpltName": "SNS형",
  "agencyId": "",
  "body": [
    {
      "param": "media",
      "value": "maapfile://LT-logo.common-34FDUE"
    },
    {
      "param": "mediaUrl",
      "value": "http://rcsbizcenter.com"
    },
    {
      "param": "title",
      "value": "상품명에 '마약' 이름 못쓴다.",
      "decoration": {}
    },
    {
      "param": "description",
      "value": "앞으로 '{{금지단어}}김밥', '{{금지단어}}떡볶이'등 '{{금지단어}}'이라는 단어를 상품명 앞에 붙일 수 없을 것으로 보인다.",
      "decoration": {}
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "calendarAction": {
              "createCalendarEvent": {
                "startTime": "2022-09-01T00:00:00+09",
                "endTime": "2022-09-30T00:00:00+09",
                "title": "호텔 숙박 이벤트를 실시합니다!",
                "description": "{{이벤트설명}}"
              }
            },
            "displayText": "호텔 숙박 이벤트를 실시합니다",
            "postback": {
              "data": "set_by_chatbot_create_calendar_event"
            }
          }
        },
        {
          "action": {
            "mapAction": {
              "requestLocationPush": {}
            },
            "displayText": "현재위치를 보내드립니다",
            "postback": {
              "data": "set_by_chatbot_request_location_push"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="슬라이드형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "ITCRM3",
  "tmpltName": "슬라이드형",
  "agencyId": "",
  "body": [
    {
      "param": "media1",
      "value": "maapfile://LT-logo.common-34FDUE"
    },
    {
      "param": "description1",
      "value": "내용 1번이 들어갑니다."
    },
    {
      "param": "media2",
      "value": "maapfile://LT-logo.common-34FDUE"
    },
    {
      "param": "title2",
      "value": "제 2장, {{ttl2}}"
    },
    {
      "param": "description2",
      "value": "제 2장, 설명: {{desc2}}"
    },
    {
      "param": "media3",
      "value": "maapfile://LT-logo.common-34FDUE"
    },
    {
      "param": "description3",
      "value": "제 3장, 설명"
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {},
        {
          "action": {
            "dialerAction": {
              "dialPhoneNumber": {
                "phoneNumber": "15221601"
              }
            },
            "displayText": "고객센터1",
            "postback": {
              "data": "set_by_chatbot_dial_phone_number"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="LMS형-기본" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "CLL00004",
  "tmpltName": "LMS형-기본",
  "agencyId": "",
  "body": [
    {
      "param": "mTitle",
      "value": "움직이는 아이콘!:수박:"
    },
    {
      "param": "description",
      "value": "내용만 입력합니다.\n{{1}}님 안녕하세요.\n동해물과 백두산이 {{2}} 하느님이 보우하사 우리 나라 만세!!\n{{2}}\n동일한 변수를 반복해서 써 봅니다.\n{{2}}"
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www.rcsbizcenter.com"
              }
            },
            "displayText": "URL 버튼 입니다.",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="LMS형-명세서" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "CLL00001",
  "tmpltName": "LMS형-명세서",
  "agencyId": "",
  "body": [
    {
      "param": "cellLeft1",
      "value": "납부정보"
    },
    {
      "param": "cellLeft2",
      "value": "자동납부"
    },
    {
      "param": "cellLeft3",
      "value": "승인예정일"
    },
    {
      "param": "cellLeft4",
      "value": "통신요금"
    },
    {
      "param": "cellLeft5",
      "value": "부가사용금액"
    },
    {
      "param": "cellLeft6",
      "value": "납부하실금액"
    },
    {
      "param": "cellRight2",
      "value": "{{place}}}}"
    },
    {
      "param": "cellRight3",
      "value": "{{Month}}월{{day}}일"
    },
    {
      "param": "cellRight4",
      "value": "{{amount1}}"
    },
    {
      "param": "cellRight5",
      "value": "{{amount2}}"
    },
    {
      "param": "cellRight6",
      "value": "{{vat}}"
    },
    {
      "param": "mTitle",
      "value": "청구서함"
    },
    {
      "lineIndex": 1
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://www-qa.rcsbizcenter.com/"
              }
            },
            "displayText": "청구서함바로가기",
            "postback": {
              "data": "set_by_chatbot_open_url"
            }
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="테이블아이템 강조형" %}

```
{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "CLT00001",
  "tmpltName": "테이블아이템 강조형",
  "agencyId": "",
  "body": [
    {
      "param": "itemTitle",
      "value": "명세서"
    },
    {
      "param": "itemMedia",
      "value": "LT-messagebase.common-2k8ydI"
    },
    {
      "param": "cellLeft1",
      "value": "누적"
    },
    {
      "param": "cellLeft2",
      "value": "일시불"
    },
    {
      "param": "cellLeft3",
      "value": "할부"
    },
    {
      "param": "cellLeft4",
      "value": "합계"
    },
    {
      "param": "cellRight1",
      "value": "{{누적금액}}"
    },
    {
      "param": "cellRight2",
      "value": "{{일시불금액}}"
    },
    {
      "param": "cellRight3",
      "value": "{{할부금}}"
    },
    {
      "param": "cellRight4",
      "value": "{{합계총액}}"
    },
    {
      "lineIndex": 1
    },
    {
      "lineIndex": 3
    }
  ],
  "buttons": []
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 템플릿ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="200">필드명</th><th width="82">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="89">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>등록된 템플릿ID(= messagebaseId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseId": "UBR.u720xwadx0-test202406182"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64106",
        "message": "Invalid messagebaseId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64318",
        "message": "Invalid formattedString format - [media's value] file not logo type or not registered"
    },
    "status": 400
}

{
    "error": {
        "code": "64400",
        "message": "required 900x900,  image resolution is 280x103 (param:media, fileId:LT-messagebase.common-Zno7xg)"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 이미지 상세 조회\_V2

## Request

## 이미지 템플릿 용으로 등록한 이미지 파일 정보를 조회 합니다.<br>

> 이미지 템플릿 용으로 등록한 이미지 파일 정보를 조회 합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*  \
> &#x20; \+ \*\*지원 범위: 이미지 템플릿, LMS 템플릿\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"FileId":{"name":"fileId","in":"path","schema":{"type":"string"},"required":true,"description":"파일ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/v2/messagebase/file/{fileId}":{"get":{"summary":"이미지 템플릿 용으로 등록한 이미지 파일 정보를 조회 합니다.\n","description":"이미지 템플릿 용으로 등록한 이미지 파일 정보를 조회 합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**  \n  + **지원 범위: 이미지 템플릿, LMS 템플릿**  \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/FileId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>이미지 템플릿용 파일 등록 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center">64</td><td align="center">O</td><td></td><td>이미지 템플릿용 파일 등록 정보입니다.</td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>등록된 파일의 URL 정보 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 가로 크기 입니다.</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 세로 크기 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "LT-BR.u720xwadx0-17CJ",
            "fileName": "BR.275F8GY6nR-FD4DBi3W06i5.jpg",
            "url": "https://file-qa.rcsbizcenter.com/brand/BR.u720xwadx0/template/LT-BR.u720xwadx0-17CJ_1.jpg",
            "imageWidth": 1080,
            "imageHeight": 1080
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 템플릿 이미지 등록\_V2

## Request

## 이미지 템플릿에서 사용할 이미지 파일을 등록합니다.<br>

> 이미지 템플릿에서 사용할 이미지 파일을 등록합니다.  \
> 파일을 먼저 등록해야 이미지 템플릿 등록 시 file Id를 템플릿 내 지정할 수 있습니다.\
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*  \
> &#x20; \+ \*\*지원 범위: 이미지 템플릿, LMS 템플릿\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/v2/messagebase/file":{"post":{"summary":"이미지 템플릿에서 사용할 이미지 파일을 등록합니다.\n","description":"이미지 템플릿에서 사용할 이미지 파일을 등록합니다.  \n파일을 먼저 등록해야 이미지 템플릿 등록 시 file Id를 템플릿 내 지정할 수 있습니다.\n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**  \n  + **지원 범위: 이미지 템플릿, LMS 템플릿**  \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"properties":{"file":{"type":"object","format":"binary","description":"이미지 템플릿에 사용할 이미지 파일입니다.\n"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>이미지 템플릿용 파일 등록 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center">64</td><td align="center">O</td><td></td><td>이미지 템플릿용 파일 등록 정보입니다.</td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>등록된 파일의 URL 정보 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 가로 크기 입니다.</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 세로 크기 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "LT-BR.u720xwadx0-17CJ",
            "fileName": "BR.275F8GY6nR-FD4DBi3W06i5.jpg",
            "url": "https://file-qa.rcsbizcenter.com/brand/BR.u720xwadx0/template/LT-BR.u720xwadx0-17CJ_1.jpg",
            "imageWidth": 1080,
            "imageHeight": 1080
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}

{% tab title="500" %}

```
{
    "error": {
        "code": "69999",
        "message": "null[org.springframework.web.multipart.MultipartException-Current request is not a multipart request]"
    },
    "status": 500
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 양방향 대화방

이 문서는 양방향 대화방 및 대화방 메뉴에 대한 API 정보를 안내합니다.


# 양방향 대화방 목록 조회

## Request

## 브랜드에 등록된 대화방(양방향) 목록을 조회합니다.<br>

> 브랜드에 등록된 양방향ID 또는 대화방메뉴, 양방향 대행사가 연결된 대화방 목록을 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/brand/{brandId}/bidirectional/chatbot":{"get":{"summary":"브랜드에 등록된 대화방(양방향) 목록을 조회합니다.\n","description":"브랜드에 등록된 양방향ID 또는 대화방메뉴, 양방향 대행사가 연결된 대화방 목록을 조회합니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>대화방이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "15330001",
            "brandId": "BR.u720xwadx0",
            "subNum": "15330001",
            "isMainNum": false,
            "subTitle": "테스트대화방",
            "service": "a2p",
            "display": "01",
            "inputField": 1,
            "subDescr": "테스트용 대화방입니다.",
            "botAgencyId": null,
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "저장",
            "registerDate": null,
            "approvalDate": null,
            "updateDate": "2024-06-25T11:08:10.000+09",
            "registerId": "hong",
            "updateId": "hong"
        },
        {
            "groupId": null,
            "chatbotId": "15330000",
            "brandId": "BR.u720xwadx0",
            "subNum": "15330000",
            "isMainNum": false,
            "subTitle": "테스트대화방",
            "service": "a2p",
            "display": "01",
            "inputField": 1,
            "subDescr": "테스트용 대화방입니다.",
            "botAgencyId": null,
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "저장",
            "registerDate": null,
            "approvalDate": null,
            "updateDate": "2024-06-25T11:08:29.000+09",
            "registerId": "hong",
            "updateId": "hong"
        },
        {
            "groupId": null,
            "chatbotId": "bot-l4tid2078py",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "isMainNum": false,
            "subTitle": "테스트입니다.",
            "service": "chat",
            "display": "11",
            "inputField": 1,
            "subDescr": "소개입니다.",
            "botAgencyId": "twRcsCorpAgency",
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인",
            "registerDate": "2024-06-25T17:57:57.000+09",
            "approvalDate": "2024-06-25T17:58:17.000+09",
            "updateDate": "2024-06-25T17:58:15.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 3
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 양방향 대화방 상세 조회

## Request

## 대화방(양방향)의 상세 정보를 조회합니다.<br>

> 대화방(양방향)의 상세 정보를 조회합니다.  \
> 양방향ID 또는 대화방메뉴, 양방향 대행사가 연결된 대화방의 상세 정보를 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}":{"get":{"summary":"대화방(양방향)의 상세 정보를 조회합니다.\n","description":"대화방(양방향)의 상세 정보를 조회합니다.  \n양방향ID 또는 대화방메뉴, 양방향 대행사가 연결된 대화방의 상세 정보를 조회합니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방(발신번호) 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>대화방이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>rcsReply</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>1</td><td><p>service가 'chat' 이거나 양방향 대화방으로 설정하고자 한다면 반드시 '1'로 설정해야 합니다.</p><ul><li>0 : SMS MO 수신</li><li>1 : RCS Postback 수신</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 상태를 나타내는 필드입니다. 현재는 단일 값인 "published" 만 존재하며, 대행사나 기업에서 API를 통한 등록/수정은 제공하지 않습니다.</td></tr><tr><td><strong><code>searchWeight</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>검색 우선 순위로 사용자 단말에서 검색 시 검색 결과가 여러 개라면 이 값이 높은 순서로 보여집니다. 대행사나 기업에서 API를 통한 등록/수정은 제공하지 않습니다.</td></tr><tr><td><strong><code>webhook</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>양방향 대화방 서비스 중계사 webhook URL 정보이며 botAgencyId 지정 시 자동으로 등록됩니다.</td></tr><tr><td><strong><code>botTcPage</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>이용약관페이지 URL 입니다. 대행사나 기업에서 API를 통해 등록/수정은 제공하지 않습니다.</td></tr><tr><td><a href="#persistentmenu-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>persistentMenu</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>대화방메뉴 정보입니다.</td></tr></tbody></table>

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>typeName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">persistentMenu</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="176">필드명</th><th width="159">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>postbackId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>메뉴에 자동 부여되는 고유ID이며, RBC 자동할당하므로 별도 입력이 불가합니다.</td></tr><tr><td><strong><code>upPostbackId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>현재 메뉴가 속한 상위 메뉴 버튼의 Postback ID, RBC 자동할당하므로 별도 입력이 불가합니다.</td></tr><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>대화방 메뉴를 구성하는 메뉴버튼의 유형입니다.<br>RBC 개편 이후 하위메뉴(type menu)는 허용하지 않습니다.</p><ul><li>menu : 하위메뉴를 갖는 메뉴 버튼 (deprecated)</li><li>reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)</li><li>feed : 브랜드 소식 연결 버튼</li><li>action : RCS 액션 지정 버튼</li></ul></td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center">25</td><td align="center">O</td><td></td><td>메뉴버튼에 표시되는 메뉴명입니다.</td></tr><tr><td><strong><code>ordNo</code></strong></td><td>number</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼 순서 값입니다.</td></tr><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'reply' 인 경우, 자동응답메시지ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.</td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다. 2022년 7월 28일 대화방 메뉴 정책 변경으로 dialerAction만 지정할 수 있습니다.</td></tr><tr><td><strong><code>action</code></strong></td><td>dialerAction</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

{% hint style="info" %}
[**버튼 Action 목록 Link (2023.12.14)**](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)
{% endhint %}

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "bot-l4tid2078py",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "isMainNum": false,
            "subTitle": "테스트입니다.",
            "service": "chat",
            "display": "11",
            "inputField": 1,
            "subDescr": "소개입니다.",
            "botAgencyId": "twRcsCorpAgency",
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인",
            "registerDate": "2024-06-25T17:57:57.000+09",
            "approvalDate": "2024-06-25T17:58:17.000+09",
            "updateDate": "2024-06-25T17:58:15.000+09",
            "registerId": "hong",
            "updateId": "hong",
            "mediaUrl": [
                {
                    "fileId": "LT-common-Cni7oQ",
                    "fileName": "교육.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-Cni7oQ_1.png",
                    "typeName": "profile"
                }
            ],
            "approvalReason": "승인완료",
            "status": "published",
            "rcsReply": "1",
            "searchWeight": "512",
            "webhook": "http://demo9295359.mockable.io/",
            "botTcPage": "http://www.rcsbizcenter.com"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 양방향 대화방 등록

## Request

## 대화방(양방향)을 등록합니다.<br>

> 양방향ID를 이용한 대화방을 등록하거나 대화방에 다음과 같은 사항을 연결을 하고자 하는 경우 사용합니다.  \
> &#x20; \
> &#x20; \+ 양방향ID 대화방 등록  \
> &#x20; \+ 발신번호 또는 양방향ID 대화방에 대화방 메뉴 등록  \
> &#x20; \+ 발신번호 또는 양방향ID 대화방에 양방향 서비스 대행사 연결(자동응답메시지, 챗봇 사용)  \
> \
> 대화방명 등록/변경 시 RBC 운영자 검수 승인 후 등록됩니다.    \
> \
> &#x20; \+ 발신번호를 이용한 양방향 대화방 전환 등록 시 대화방명이 변경된 경우  \
> &#x20; \+ 사용자 입력 양방향ID를 이용한 신규 양방향 대화방 등록 시  \
> \
> &#x20; \- \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \- \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegBiChatbot":{"description":"대화방(양방향) 정보 객체입니다.\n","type":"object","properties":{"chatbotId":{"type":"string","maxLength":15,"description":"maxLength: 15 - 대화방(양방향)으로 등록/전환하고자 하는 chatbotId를 지정합니다.  \n\n  + 발신번호(service = 'A2P')인 경우, 사전에 승인된 발신번호의 chatbotId를 입력합니다.\n  + 양방향ID(service = 'CHAT')를 새로 등록하는 경우, 원하는 문자열을 입력합니다.  \n\n**양방향ID(service 구분값: 'CHAT')의 포맷 규칙은 다음과 같습니다.**  \n\n  + chatbotId는 생략할 수 있으며 RBC에서 랜덤으로 chatbotId 생성하여 리턴합니다.  \n  + 등록 시 사용 가능한 문자는 alphanumeric, '-', '_' 만 허용 됩니다.  \n  + 알파벳은 대문자 입력시 소문자로 변환되어 처리됩니다.  \n  + 'bot-' prefix 가 기본 삽입됩니다.  \n  + 'bot-' prefix 삽입된 된 문자열 사용이 가능하며, 이때는 'bot-' prefix를 RBC에서 추가하지 않습니다.  \n  + 'bot-' prefix 포함 시 최대 15자리 입력이 가능하므로 'bot-'외 사용 가능한 문자열의 길이는 11자리 입니다.\n  + API 호출 시 입력한 chatbotId에 bot- prefix 삽입, 소문자 변환 등 변경이 발생할 수 있으므로 반드시 API 응답으로 리턴되는 chatbotId를 취득 사용해야 합니다.\n"},"subNum":{"type":"string","maxLength":40,"description":"maxLength: 40 - 회신번호 입니다.  \n\nA2P는 chatbotId와 동일하며, 생략 가능합니다.  \n\nservice가 chat인 경우 사전에 승인된 대화방(발신번호) 중 하나를 반드시 지정해야 합니다.\n"},"subTitle":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대화방명입니다.\n"},"display":{"type":"string","enum":["11","10","01","00"],"default":"01","description":"단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.  \n\n브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지\n수신이 불가능합니다.  \n\n  + '11' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 전시  \n  + '10' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 비전시  \n  + '01' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 전시  \n  + '00' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 비전시\n"},"service":{"type":"string","enum":["a2p","chat"],"default":"a2p","description":"대화방 유형입니다.  \n\n  + a2p : 발신번호를 이용한 대화방\n  + chat : 양방향ID를 이용한 대화방\n"},"inputField":{"type":"integer","description":"단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.  \n\n  + 0 : 비활성화  \n  + 1 : 활성화\n","enum":[0,1],"default":1},"botAgencyId":{"type":"string","description":"maxLength: 20 - 양방향 대화방 서비스 계약 관계에 있는 대행사ID로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.    \n\n예를들어 양방향ID 대화방을 생성하는 경우 대행사ID를 지정하지 않아도 생성이 가능합니다.  \n\n대화방(발신번호)를 전환하는 경우에는 반드시 대행사ID를 지정해야 합니다.  \n\n  + 기업에서 양방향 대화방 등록 시: 브랜드 대행사 중 양방향 서비스가 가능한 대행사ID 지정  \n  + 양방향 서비스 대행사에서 양방향 대화방 등록 시: 연계된 중계사의 RBC 등록ID 지정(RBC 등록 ID는 해당 중계사에 직접 확인)\n","maxLength":20},"subDescr":{"type":"string","description":"maxLength: 50 - 대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.  \n","maxLength":50},"saftyStatusYn":{"description":"안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.  \n\n  + Y : 안심마크 표시\n  + N : 안심마크 미표시\n","type":"string","enum":["Y","N"],"default":"Y"}},"required":["chatbotId","service","subTitle","subNum","inputField"]}}},"paths":{"/brand/{brandId}/bidirectional/chatbot":{"post":{"summary":"대화방(양방향)을 등록합니다.\n","description":"양방향ID를 이용한 대화방을 등록하거나 대화방에 다음과 같은 사항을 연결을 하고자 하는 경우 사용합니다.  \n  \n  + 양방향ID 대화방 등록  \n  + 발신번호 또는 양방향ID 대화방에 대화방 메뉴 등록  \n  + 발신번호 또는 양방향ID 대화방에 양방향 서비스 대행사 연결(자동응답메시지, 챗봇 사용)  \n\n대화방명 등록/변경 시 RBC 운영자 검수 승인 후 등록됩니다.    \n\n  + 발신번호를 이용한 양방향 대화방 전환 등록 시 대화방명이 변경된 경우  \n  + 사용자 입력 양방향ID를 이용한 신규 양방향 대화방 등록 시  \n\n  - **계정 권한 : 마스터, 매니저, 대행사**  \n  - **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"chatbot":{"$ref":"#/components/schemas/RegBiChatbot"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="대화방(양방향) 정보" %}

```
{
    "chatbot": {
        "chatbotId": "07082245290",
        "subNum": "07082245290",
        "subTitle": "대화방(양방향)",
        "display": "11",
        "service": "a2p",
        "inputField": 1,
        "botAgencyId": "twRcsCorpAgency",
        "subDesr": "대화방 검색 시 노출되는 소개글",
        "saftyStatusYn": "Y"
    }
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>대화방이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "chatbotId": "07082245290",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "subTitle": "대화방(양방향)",
            "service": "a2p",
            "display": "01",
            "webhook": "http://demo9295359.mockable.io/",
            "botTcPage": "http://www.rcsbizcenter.com",
            "inputField": 1,
            "botAgencyId": "twRcsCorpAgency",
            "psMenuUse": false,
            "saftyStatusYn": "N",
            "subDescr": "null",
            "approvalResult": "승인대기",
            "registerDate": "2024-06-18 09:42:21",
            "approvalDate": "2024-06-18 09:48:37",
            "updateDate": "2024-06-26 09:15:31",
            "registerId": "swjeong75",
            "updateId": null
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64304",
        "message": "Over specified size (chatbotId)"
    },
    "status": 400
}

{
    "error": {
        "code": "64383",
        "message": "the value of subnum does not exist or is not valid"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 양방향 대화방 수정

## Request

## 대화방(양방향) 정보를 수정 합니다.<br>

> 대화방(양방향) 정보를 수정 합니다.  \
> 양방향ID를 이용한 대화방을 수정하거나 대화방에 다음과 같은 사항을 연결을 하고자 하는 경우 사용합니다.  \
> &#x20; \
> &#x20; \+ 양방향ID 대화방 수정  \
> &#x20; \+ 발신번호 또는 양방향ID 대화방에 대화방 메뉴 등록  \
> &#x20; \+ 발신번호 또는 양방향ID 대화방에 양방향 서비스 대행사 연결/해제(자동응답메시지, 챗봇 사용)  \
> \
> 대화방명 등록/변경 시 RBC 운영자 검수 승인 후 등록됩니다.  \
> \
> &#x20; \+ 발신번호를 이용한 양방향 대화방 전환 등록 시 대화방명이 변경된 경우  \
> &#x20; \+ 사용자 입력 양방향ID를 이용한 신규 양방향 대화방 등록 시   \
> \
> &#x20; \- \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \- \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}},"schemas":{"ModBiChatbot":{"description":"양방향 대화방 정보 객체입니다.\n","type":"object","properties":{"subNum":{"type":"string","maxLength":40,"description":"maxLength: 40 - 회신번호 입니다.  \n\nA2P는 chatbotId와 동일하며, 생략 가능합니다.  \n\nservice가 chat인 경우 사전에 승인된 대화방(발신번호) 중 하나를 반드시 지정해야 합니다.\n"},"subTitle":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대화방명입니다.\n"},"display":{"type":"string","enum":["11","10","01","00"],"default":"01","description":"단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.  \n\n브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.  \n\n  + '11' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 전시  \n  + '10' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 비전시  \n  + '01' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 전시  \n  + '00' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 비전시\n"},"inputField":{"type":"integer","description":"단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.  \n\n  + 0 : 비활성화  \n  + 1 : 활성화\n","enum":[0,1],"default":1},"botAgencyId":{"type":"string","description":"maxLength: 20 - 양방향 대화방 서비스 계약 관계에 있는 대행사ID로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.    \n\n예를들어 양방향ID 대화방을 생성하는 경우 대행사ID를 지정하지 않아도 생성이 가능합니다.  \n\n대화방(발신번호)를 전환하는 경우에는 반드시 대행사ID를 지정해야 합니다.  \n\n이미 양방향 대화방으로 전환된 발신번호의 경우, botAgencyId를 빈값으로 설정하면 일반 발신번호로 전환됩니다.(DELETE /brand/{brandId}/bidirectional/chatbot/{chatbotId}과\n동일)\n\n  + 기업에서 양방향 대화방 등록 시: 브랜드 대행사 중 양방향 서비스가 가능한 대행사ID 지정  \n  + 양방향 서비스 대행사에서 양방향 대화방 등록 시: 연계된 중계사의 RBC 등록ID 지정(RBC 등록 ID는 해당 중계사에 직접 확인)\n","maxLength":20},"subDescr":{"type":"string","description":"maxLength: 50 - 대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.  \n","maxLength":50},"saftyStatusYn":{"description":"안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.  \n\n  + Y : 안심마크 표시\n  + N : 안심마크 미표시\n","type":"string","enum":["Y","N"],"default":"Y"}}}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}":{"put":{"summary":"대화방(양방향) 정보를 수정 합니다.\n","description":"대화방(양방향) 정보를 수정 합니다.  \n양방향ID를 이용한 대화방을 수정하거나 대화방에 다음과 같은 사항을 연결을 하고자 하는 경우 사용합니다.  \n  \n  + 양방향ID 대화방 수정  \n  + 발신번호 또는 양방향ID 대화방에 대화방 메뉴 등록  \n  + 발신번호 또는 양방향ID 대화방에 양방향 서비스 대행사 연결/해제(자동응답메시지, 챗봇 사용)  \n\n대화방명 등록/변경 시 RBC 운영자 검수 승인 후 등록됩니다.  \n\n  + 발신번호를 이용한 양방향 대화방 전환 등록 시 대화방명이 변경된 경우  \n  + 사용자 입력 양방향ID를 이용한 신규 양방향 대화방 등록 시   \n\n  - **계정 권한 : 마스터, 매니저, 대행사**  \n  - **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"chatbot":{"$ref":"#/components/schemas/ModBiChatbot"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="대화방(양방향) 정보" %}

```
{
    "chatbot": {
        "subNum": "07082245290",
        "subTitle": "대화방(양방향)",
        "display": "11",
        "service": "a2p",
        "inputField": 1,
        "botAgencyId": "twRcsCorpAgency",
        "subDesr": "대화방 검색 시 노출되는 소개글",
        "saftyStatusYn": "Y"
    }
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "07082245290",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "isMainNum": true,
            "subTitle": "대화방(양방향)",
            "service": "a2p",
            "display": "11",
            "inputField": 1,
            "subDescr": null,
            "botAgencyId": "twRcsCorpAgency",
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인대기(수정)",
            "registerDate": "2024-06-26T09:54:55.000+09",
            "approvalDate": "2024-06-26T09:54:39.000+09",
            "updateDate": "2024-06-26T09:54:55.000+09",
            "registerId": "hong",
            "updateId": "hong",
            "mediaUrl": [
                {
                    "fileId": "LT-common-Cni7oQ",
                    "fileName": "교육.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-Cni7oQ_1.png",
                    "typeName": "profile"
                }
            ],
            "approvalReason": "승인완료",
            "status": "published",
            "rcsReply": "1",
            "searchWeight": "512",
            "webhook": "http://demo9295359.mockable.io/",
            "botTcPage": "http://www.rcsbizcenter.com"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64321",
        "message": "Invalid approval status"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 양방향 대화방 삭제

## Request

## 대화방(양방향)을 삭제합니다.<br>

> 양방향ID 대화방 삭제 또는 양방향 대행사가 연결된 발신번호 대화방에서 양방향 대행사 정보를 제거합니다.  \
> \
> &#x20; \+ 양방향ID 대화방 삭제  \
> &#x20; \+ 발신번호 대화방에 연결된 양방향 대행사 정보 제거(양방향 서비스 속성 제거)   \
> &#x20; \+ 양방향 대행사 정보가 없는 발신번호 대화방 삭제(DELETE /brand/{brandId}/chatbot/{chatbotId} 동일) \
> \
> &#x20; \- \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \- \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}":{"delete":{"summary":"대화방(양방향)을 삭제합니다.\n","description":"양방향ID 대화방 삭제 또는 양방향 대행사가 연결된 발신번호 대화방에서 양방향 대행사 정보를 제거합니다.  \n\n  + 양방향ID 대화방 삭제  \n  + 발신번호 대화방에 연결된 양방향 대행사 정보 제거(양방향 서비스 속성 제거)   \n  + 양방향 대행사 정보가 없는 발신번호 대화방 삭제(DELETE /brand/{brandId}/chatbot/{chatbotId} 동일) \n\n  - **계정 권한 : 마스터, 매니저, 대행사**  \n  - **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방Id(=chatbotId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">**`result`**</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="183">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>대화방Id(=chatbotId)</td></tr><tr><td><strong><code>releatedChatbots</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>삭제된 chatbotId를 회신번호로 사용하는 함께 삭제된 양방향대화방 리스트</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "chatbotId": "07082245290",
            "releatedChatbots": [
                "bot-l4tid2078py"
            ]
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 메뉴 등록

## Request

## 대화방에 대화방메뉴를 등록합니다.<br>

> 대화방에 대화방메뉴를 등록합니다.\
> \
> 대화방 메뉴 개편으로 상위 메뉴, 하위 메뉴 구분 없이 최대 5개까지 메뉴를 지정할 수 있습니다.    \
> \
> 대화방 메뉴 등록 시 대화방메뉴 정보는 등록하지만 대화방에서의 사용여부를 미사용으로 설정할 수 있습니다.  \
> \
> ※  대표번호 문자서비스가 설정된 대화방에는 대화방메뉴를 등록할 수 없습니다. 즉, rcsReply 값이 1인 대화방에만 대화방메뉴를 설정할 수 있습니다.\
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}},"schemas":{"RegPersistentMenu":{"type":"object","properties":{"menu":{"type":"array","items":{"$ref":"#/components/schemas/RegPersistentMenu_L1"}}}},"RegPersistentMenu_L1":{"description":"대화방메뉴 버튼 정보입니다.","type":"object","properties":{"type":{"type":"string","description":"대화방 메뉴를 구성하는 메뉴 버튼의 유형입니다.\n\n  - reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)\n  - feed : 브랜드 소식 연결 버튼\n  - action : RCS 액션 지정 버튼 \n","enum":["reply","feed","action"]},"title":{"type":"string","description":"maxLength: 25 - 메뉴버튼에 표시되는 메뉴명입니다.\n","maxLength":25},"ordNo":{"type":"number","description":"메뉴버튼 순서 값입니다.\n"},"autoReplyMsgId":{"type":"string","description":"type이 'reply' 인 경우, 자동응답메시지 ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지 ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.\n"},"feedId":{"type":"string","description":"type이 'feed' 인 경우, 브랜드 소식 ID 지정 시 해당 소식이 연결됩니다.  \n"},"actionType":{"type":"string","description":"type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다.  \n\n  - dialerAction : 전화연결  \n  - urlAction : 웹사이트 연결\n","enum":["dialerAction","urlAction"]},"action":{"type":"object","oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"}]}},"required":["type","title","ordNo"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}/persistentmenu":{"post":{"summary":"대화방에 대화방메뉴를 등록합니다.\n","description":"대화방에 대화방메뉴를 등록합니다.\n\n대화방 메뉴 개편으로 상위 메뉴, 하위 메뉴 구분 없이 최대 5개까지 메뉴를 지정할 수 있습니다.    \n\n대화방 메뉴 등록 시 대화방메뉴 정보는 등록하지만 대화방에서의 사용여부를 미사용으로 설정할 수 있습니다.  \n\n※  대표번호 문자서비스가 설정된 대화방에는 대화방메뉴를 등록할 수 없습니다. 즉, rcsReply 값이 1인 대화방에만 대화방메뉴를 설정할 수 있습니다.\n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"psMenuUse":{"type":"boolean","description":"대화방메뉴 사용 여부입니다.  \n\n  + true : 사용  \n  + false : 미사용\n","default":true},"persistentMenu":{"$ref":"#/components/schemas/RegPersistentMenu"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="양방향대화방메뉴" %}

```
{
    "psMenuUse": false,
    "persistentMenu": {
        "menu": [
            {
                "type": "action",
                "title": "119연락",
                "ordNo": 0,
                "actionType": "dialerAction",
                "action": {
                    "dialerAction": {
                        "dialPhoneNumber": {
                            "phoneNumber": "119"
                        }
                    }
                }
            },
            {
                "ordNo": "1",
                "title": "API버튼1",
                "type": "feed",
                "feedId": "BR.vt0HGdJXG0.cUmR1s689n"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방메뉴 버튼 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">**`result`**</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="192">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>대화방 메뉴를 구성하는 메뉴 버튼의 유형입니다.</p><ul><li>reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)</li><li>feed : 브랜드 소식 연결 버튼</li><li>action : RCS 액션 지정 버튼</li></ul></td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼에 표시되는 메뉴명입니다.</td></tr><tr><td><strong><code>ordNo</code></strong></td><td>number</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼 순서 값입니다.</td></tr><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'reply' 인 경우, 자동응답메시지 ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지 ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.</td></tr><tr><td><strong><code>feedId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'feed' 인 경우, 브랜드 소식 ID 지정 시 해당 소식이 연결됩니다.</td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다.</p><ul><li>dialerAction : 전화연결</li><li>urlAction : 웹사이트 연결</li></ul></td></tr><tr><td><strong><code>action</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

{% hint style="info" %}
[**버튼 Action 목록 Link (2023.12.14)**](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)
{% endhint %}

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "postbackId": "P7r9Gr5W0XM6RyQ",
            "upPostbackId": "",
            "type": "action",
            "title": "119연락",
            "ordNo": "10",
            "autoReplyMsgId": "",
            "actionType": "dialerAction",
            "action": {
                "dialerAction": {
                    "dialPhoneNumber": {
                        "phoneNumber": "119"
                    }
                }
            },
            "chatbotId": "07082245290",
            "armIdName": null
        }, 
        {
            "postbackId": "PObF8R4XtopwoW2",
            "upPostbackId": "",
            "type": "feed",
            "title": "API버튼1",
            "ordNo": "20",
            "autoReplyMsgId": "",
            "actionType": "urlAction",
            "action": {
                "urlAction": {
                    "openUrl": {
                        "url": "https://biz-qa.chatplus.co.kr/brand/BR.vt0HGdJXG0/feed/BR.vt0HGdJXG0.cUmR1s689n"
                    }
                }
            },
            "chatbotId": "07082245290",
            "armIdName": null
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 메뉴 수정

## Request

## 대화방의 대화방메뉴를 수정합니다.<br>

> 대화방의 대화방메뉴를 수정합니다.\
> \
> 대화방 메뉴 개편으로 상위 메뉴, 하위 메뉴 구분 없이 최대 5개까지 메뉴를 지정할 수 있습니다.    \
> \
> 대화방 메뉴 정보는 유지한 상태에서 사용/미사용 전환이 가능합니다.  \
> \
> ※  대표번호 문자서비스가 설정된 대화방에는 대화방메뉴를 등록할 수 없습니다. 즉, rcsReply 값이 1인 대화방에만\
> 대화방메뉴를 설정할 수 있습니다.\
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}},"schemas":{"RegPersistentMenu":{"type":"object","properties":{"menu":{"type":"array","items":{"$ref":"#/components/schemas/RegPersistentMenu_L1"}}}},"RegPersistentMenu_L1":{"description":"대화방메뉴 버튼 정보입니다.","type":"object","properties":{"type":{"type":"string","description":"대화방 메뉴를 구성하는 메뉴 버튼의 유형입니다.\n\n  - reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)\n  - feed : 브랜드 소식 연결 버튼\n  - action : RCS 액션 지정 버튼 \n","enum":["reply","feed","action"]},"title":{"type":"string","description":"maxLength: 25 - 메뉴버튼에 표시되는 메뉴명입니다.\n","maxLength":25},"ordNo":{"type":"number","description":"메뉴버튼 순서 값입니다.\n"},"autoReplyMsgId":{"type":"string","description":"type이 'reply' 인 경우, 자동응답메시지 ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지 ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.\n"},"feedId":{"type":"string","description":"type이 'feed' 인 경우, 브랜드 소식 ID 지정 시 해당 소식이 연결됩니다.  \n"},"actionType":{"type":"string","description":"type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다.  \n\n  - dialerAction : 전화연결  \n  - urlAction : 웹사이트 연결\n","enum":["dialerAction","urlAction"]},"action":{"type":"object","oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"}]}},"required":["type","title","ordNo"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}/persistentmenu":{"put":{"summary":"대화방의 대화방메뉴를 수정합니다.\n","description":"대화방의 대화방메뉴를 수정합니다.\n\n대화방 메뉴 개편으로 상위 메뉴, 하위 메뉴 구분 없이 최대 5개까지 메뉴를 지정할 수 있습니다.    \n\n대화방 메뉴 정보는 유지한 상태에서 사용/미사용 전환이 가능합니다.  \n\n※  대표번호 문자서비스가 설정된 대화방에는 대화방메뉴를 등록할 수 없습니다. 즉, rcsReply 값이 1인 대화방에만\n대화방메뉴를 설정할 수 있습니다.\n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"psMenuUse":{"type":"boolean","description":"대화방메뉴 사용 여부입니다.  \n\n  + true : 사용  \n  + false : 미사용\n","default":true},"persistentMenu":{"$ref":"#/components/schemas/RegPersistentMenu"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="양방향대화방메뉴" %}

```
{
    "psMenuUse": true,
    "persistentMenu": {
        "menu": [
            {
                "type": "action",
                "title": "119연락",
                "ordNo": 0,
                "actionType": "dialerAction",
                "action": {
                    "dialerAction": {
                        "dialPhoneNumber": {
                            "phoneNumber": "119"
                        }
                    }
                }
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방메뉴 버튼 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="192">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>대화방 메뉴를 구성하는 메뉴 버튼의 유형입니다.</p><ul><li>reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)</li><li>feed : 브랜드 소식 연결 버튼</li><li>action : RCS 액션 지정 버튼</li></ul></td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼에 표시되는 메뉴명입니다.</td></tr><tr><td><strong><code>ordNo</code></strong></td><td>number</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼 순서 값입니다.</td></tr><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'reply' 인 경우, 자동응답메시지 ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지 ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.</td></tr><tr><td><strong><code>feedId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'feed' 인 경우, 브랜드 소식 ID 지정 시 해당 소식이 연결됩니다.</td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다.</p><ul><li>dialerAction : 전화연결</li><li>urlAction : 웹사이트 연결</li></ul></td></tr><tr><td><strong><code>action</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

{% hint style="info" %}
[**버튼 Action 목록 Link (2023.12.14)**](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)
{% endhint %}

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "postbackId": "Pfz7ZqouHV95Zq3",
            "upPostbackId": "",
            "type": "action",
            "title": "119긴급연락",
            "ordNo": "10",
            "autoReplyMsgId": "",
            "actionType": "dialerAction",
            "action": {
                "dialerAction": {
                    "dialPhoneNumber": {
                        "phoneNumber": "119"
                    }
                }
            },
            "chatbotId": "07082245290",
            "armIdName": null
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 메뉴 삭제

## Request

## 대화방(양방향)을 삭제합니다.<br>

> 양방향ID 대화방 삭제 또는 양방향 대행사가 연결된 발신번호 대화방에서 양방향 대행사 정보를 제거합니다.  \
> \
> &#x20; \+ 양방향ID 대화방 삭제  \
> &#x20; \+ 발신번호 대화방에 연결된 양방향 대행사 정보 제거(양방향 서비스 속성 제거)   \
> &#x20; \+ 양방향 대행사 정보가 없는 발신번호 대화방 삭제(DELETE /brand/{brandId}/chatbot/{chatbotId} 동일) \
> \
> &#x20; \- \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \- \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}":{"delete":{"summary":"대화방(양방향)을 삭제합니다.\n","description":"양방향ID 대화방 삭제 또는 양방향 대행사가 연결된 발신번호 대화방에서 양방향 대행사 정보를 제거합니다.  \n\n  + 양방향ID 대화방 삭제  \n  + 발신번호 대화방에 연결된 양방향 대행사 정보 제거(양방향 서비스 속성 제거)   \n  + 양방향 대행사 정보가 없는 발신번호 대화방 삭제(DELETE /brand/{brandId}/chatbot/{chatbotId} 동일) \n\n  - **계정 권한 : 마스터, 매니저, 대행사**  \n  - **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방Id(=chatbotId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>대화방Id(=chatbotId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "chatbotId": "07082245290"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 자동응답 메시지

이 문서는 자동응답에 대한 API 정보를 안내합니다.


# 자동응답 메시지 목록 조회

## Request

## 브랜드 내에 등록된 자동응답메시지 목록을 조회합니다.<br>

> 브랜드 내에 등록된 자동응답메시지 목록을 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\* <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/brand/{brandId}/autoreplymsg":{"get":{"summary":"브랜드 내에 등록된 자동응답메시지 목록을 조회합니다.\n","description":"브랜드 내에 등록된 자동응답메시지 목록을 조회합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자** \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>자동응답메시지 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="206">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>자동응답메시지 기본 정보입니다.</td></tr><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>autoReplyMsgName</code></strong></td><td>string</td><td align="center">100</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0Qn6dj8Goh",
            "autoReplyMsgId": "ARM8Q97K45uti2X",
            "autoReplyMsgName": "자동응답 메시지 명 입니다 (medium)",
            "messagebaseId": "RPCSMMX001",
            "approvalResult": "저장",
            "registerDate": null,
            "updateDate": "2026-04-20T21:15:17.000+09",
            "registerId": "yoonmin9411",
            "updateId": "yoonmin9411"
        },
        {
            "brandId": "BR.0Qn6dj8Goh",
            "autoReplyMsgId": "ARMncHxBauc9Z6t",
            "autoReplyMsgName": "자동응답 메시지 명 입니다 (tall)",
            "messagebaseId": "RPCSMTX001",
            "approvalResult": "저장",
            "registerDate": null,
            "updateDate": "2026-04-20T21:14:50.000+09",
            "registerId": "yoonmin9411",
            "updateId": "yoonmin9411"
        },
        {
            "brandId": "BR.0Qn6dj8Goh",
            "autoReplyMsgId": "ARM4aj8cxE1ryqx",
            "autoReplyMsgName": "자동응답 메시지 명 입니다",
            "messagebaseId": "RPCSAXX001",
            "approvalResult": "저장",
            "registerDate": null,
            "updateDate": "2026-04-20T21:14:18.000+09",
            "registerId": "yoonmin9411",
            "updateId": "yoonmin9411"
        },
        {
            "brandId": "BR.0Qn6dj8Goh",
            "autoReplyMsgId": "ARMJqb8TG1dn0cd",
            "autoReplyMsgName": "자동응답 메시지 명 입니다.",
            "messagebaseId": "TMCSA00001",
            "approvalResult": "저장",
            "registerDate": null,
            "updateDate": "2026-04-20T21:16:22.000+09",
            "registerId": "yoonmin9411",
            "updateId": "yoonmin9411"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 30,
        "total": 4
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 자동응답 메시지 상세 조회

## Request

## 자동응답메시지의 상세 정보를 조회합니다.<br>

> 자동응답메시지의 상세 정보를 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\* <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"AutoReplyMsgId":{"name":"autoReplyMsgId","in":"path","schema":{"type":"string"},"required":true,"description":"브랜드 내 자동응답메시지 정보 접근시 사용되는 자동응답메시지ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/autoreplymsg/{autoReplyMsgId}":{"get":{"summary":"자동응답메시지의 상세 정보를 조회합니다.\n","description":"자동응답메시지의 상세 정보를 조회합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자** \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/AutoReplyMsgId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>자동응메시지 상세 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="199">필드명</th><th width="178">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>자동응메시지 상세 정보입니다.</td></tr><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>autoReplyMsgName</code></strong></td><td>string</td><td align="center">100</td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>자동응답메시지 등록 상태입니다. 자동응답메시지는 운영자 검수 없이 자동 등록됩니다.</p><ul><li>등록완료 : 이통3사에 자동응답메시지가 정상 등록된 상태입니다.</li><li>저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다.</li><li>처리중 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>수정 계정 ID</td></tr><tr><td><strong><code>copyAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>true</td><td></td></tr><tr><td><strong><code>body</code></strong></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#buttons-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>buttons</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><a href="#suggestions-array-less-than-object-greater-than-chiplist-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>chipList</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">buttons</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><mark style="color:$primary;">suggestions</mark></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">suggestions</mark> - array\<object>, <mark style="color:blue;">chipList</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td>action</td><td>object</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td>reply</td><td>object</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200-말풍선" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0Qn6dj8Goh",
            "autoReplyMsgId": "ARMJqb8TG1dn0cd",
            "autoReplyMsgName": "자동응답 메시지 명 입니다.",
            "messagebaseId": "TMCSA00001",
            "approvalResult": "저장",
            "updateDate": "2026-04-20T21:16:22.000+09",
            "registerId": "yoonmin9411",
            "updateId": "yoonmin9411",
            "chipList": [
                {
                    "action": {
                        "displayText": "URL 연결 버튼",
                        "postback": {
                            "data": "postbackId=P5oA7AS71TwulUa;;"
                        },
                        "urlAction": {
                            "openUrl": {
                                "url": "http://www.rcsbizcenter.com"
                            }
                        }
                    }
                }
            ],
            "copyAllowed": true,
            "body": {
                "description": "자동응답 메시지의 내용 입니다."
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200-카드" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0Qn6dj8Goh",
            "autoReplyMsgId": "ARMJqb8TG1dn0cd",
            "autoReplyMsgName": "자동응답 메시지 명 입니다.",
            "messagebaseId": "TMCSA00001",
            "approvalResult": "저장",
            "updateDate": "2026-04-20T21:16:22.000+09",
            "registerId": "yoonmin9411",
            "updateId": "yoonmin9411",
            "chipList": [
                {
                    "action": {
                        "displayText": "URL 연결 버튼",
                        "postback": {
                            "data": "postbackId=P5oA7AS71TwulUa;;"
                        },
                        "urlAction": {
                            "openUrl": {
                                "url": "http://www.rcsbizcenter.com"
                            }
                        }
                    }
                }
            ],
            "copyAllowed": true,
            "body": {
                "description": "자동응답 메시지의 내용 입니다."
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200-카드(이미지세로T)" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0Qn6dj8Goh",
            "autoReplyMsgId": "ARMncHxBauc9Z6t",
            "autoReplyMsgName": "자동응답 메시지 명 입니다 (tall)",
            "messagebaseId": "RPCSMTX001",
            "approvalResult": "저장",
            "updateDate": "2026-04-20T21:14:50.000+09",
            "registerId": "yoonmin9411",
            "updateId": "yoonmin9411",
            "copyAllowed": true,
            "body": {
                "description": "내용 영역 입니다",
                "media": "BR.0Qn6dj8Goh-ARMf9u14CX7p5",
                "title": "제목 영역 입니다"
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200-카드(이미지세로M)" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0Qn6dj8Goh",
            "autoReplyMsgId": "ARM8Q97K45uti2X",
            "autoReplyMsgName": "자동응답 메시지 명 입니다 (medium)",
            "messagebaseId": "RPCSMMX001",
            "approvalResult": "저장",
            "updateDate": "2026-04-20T21:15:17.000+09",
            "registerId": "yoonmin9411",
            "updateId": "yoonmin9411",
            "copyAllowed": true,
            "body": {
                "description": "내용 영역 입니다",
                "media": "BR.0Qn6dj8Goh-ARMaN71hbmC5Q",
                "title": "제목 영역 입니다"
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 자동응답 메시지 등록

## Request

## 브랜드에 자동응답메시지를 등록합니다.<br>

> 브랜드에 자동응답메시지를 등록합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*  \
> \
> 제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용하며 다음과 같이 처리 됩니다.  \
> \*\*2026.4.21 부터 모든 자동응답메시지는 통합RCS 규격으로만 사용이 가능합니다.\*\*  \
> &#x20; \+ 말풍선: TMCSA00001\
> &#x20; \+ (이미지가 없는) 카드: RPCSAXX001 \
> &#x20; \+ (세로형 Tall 이미지) 카드: RPCSMTX001\
> &#x20; \+ (세로형 Medium 이미지) 카드: RPCSMMX001 \
> &#x20; \+ 슬라이드형 미제공  \
> &#x20;   \
> 자동응답메시지에 등록 가능한 액션은 다음과 같습니다.  \
> &#x20; \+ 전화걸기\
> &#x20; \+ 브랜드 소식 연결\
> &#x20; \+ URL연결 \
> &#x20; \+ 다른 대화방연결\
> &#x20; \+ 캘린더 등록\
> &#x20; \+ 지도 보여주기(좌표)\
> &#x20; \+ 지도 보여주기(쿼리)\
> &#x20; \+ 사용자 위치 공유\
> &#x20; \+ 자동응답메시지 연결\
> &#x20; \+ 챗봇연결<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegAutoReplyMsgInfo":{"required":["autoReplyMsgName","messagebaseId","body"],"description":"자동응답메시지 등록/수정 시 필요한 정보입니다.\n","type":"object","properties":{"autoReplyMsgName":{"type":"string","maxLength":100,"description":"maxLength: 100 - 자동응답메시지 명을 지정합니다.\n"},"messagebaseId":{"type":"string","maxLength":40,"description":"maxLength: 40 - 메시지 상품코드 chat에 속하는 messagebase ID를 지정합니다.  \n"},"copyAllowed":{"type":"boolean","default":true,"description":"단말에서 메시지 복사 가능 여부를 지정합니다.  \n\n  + true : 복사 가능\n  + false : 복사 불가\n"},"body":{"type":"object","description":"이통 발송규격 중 /message API의 body object와 동일한 방식으로 값을 지정합니다.  \n"},"buttons":{"description":"자동응답메시지에 버튼을 등록합니다.\n\n지원하는 action 유형은 다음과 같습니다.  \n\n  + urlAction : URL 연결, 브랜드 소식 연결(브랜드 소식의 URL을 넣어주면 됩니다.)  \n  + mapAction : 지도 보여주기(좌표), 지도 보여주기(쿼리), 사용자 위치 공유 \n  + calendarAction : 캘린더 등록  \n  + composeAction : 지정 대화방에 메시지 작성  \n  + dialerAction : 전화걸기  \n  + reply : 챗봇연결, 자동응답메시지 연결(다른 자동응답메시지 연결 시에는 reply JSON object 내에 autoReplyMsgId 필드에 자동응답메시지ID를 지정하며, postback.data는 자동할당 됩니다.)\n\n**clipboardAction, localBrowserAction 은 2026.04.21 부터 더 이상 지원하지 않습니다.**             \n","type":"array","items":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/AutoReplyMsgActions"}}}}},"chipList":{"description":"자동응답메시지에 칩리스트를 지정합니다. \n\n지원하는 action 유형은 다음과 같습니다.  \n\n  + urlAction : URL 연결, 브랜드 소식 연결(브랜드 소식의 URL을 넣어주면 됩니다.)  \n  + mapAction : 지도 보여주기(좌표), 지도 보여주기(쿼리), 사용자 위치 공유 \n  + calendarAction : 캘린더 등록  \n  + composeAction : 지정 대화방에 메시지 작성  \n  + dialerAction : 전화걸기  \n  + reply : 챗봇연결, 자동응답메시지 연결(다른 자동응답메시지 연결 시에는 reply JSON object 내에 autoReplyMsgId 필드에 자동응답메시지ID를 지정하며, postback.data는 자동할당 됩니다.)\n\n**clipboardAction, localBrowserAction 은 2026.04.21 부터 더 이상 지원하지 않습니다.**  \n","type":"array","items":{"$ref":"#/components/schemas/AutoReplyMsgActions"}}}},"AutoReplyMsgActions":{"oneOf":[{"$ref":"#/components/schemas/ARMaction"},{"$ref":"#/components/schemas/CustomReply"}]},"ARMaction":{"description":"자동응답메시지용 Action","type":"object","properties":{"action":{"type":"object","oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"},{"$ref":"#/components/schemas/mapAction"},{"$ref":"#/components/schemas/calendarAction"},{"$ref":"#/components/schemas/composeAction"}]}},"required":["action"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]},"mapAction":{"description":"Suggested actions for interacting with a location on a map.","properties":{"mapAction":{"type":"object","oneOf":[{"properties":{"showLocation":{"description":"Shows a given location on a map.","type":"object","properties":{"location":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"label":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"}},"required":["latitude","longitude"]},"fallbackUrl":{"type":"string","format":"uri"}},"required":["location"]}},"required":["showLocation"]},{"properties":{"requestLocationPush":{"description":"One-time request to send a geo location push from UE to\nchatbot","type":"object","properties":{"currentLocation":{"description":"set true to send current location without location\nselection","type":"boolean"}}}},"required":["requestLocationPush"]}]}},"required":["mapAction"]},"calendarAction":{"description":"Suggested actions for interacting with a calendar event.","properties":{"calendarAction":{"type":"object","oneOf":[{"properties":{"createCalendarEvent":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"title":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"},"description":{"type":"string","minLength":1,"maxLength":500,"description":"maxLength: 500, minLength: 1\n"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["startTime","endTime","title"]}},"required":["createCalendarEvent"]}]}},"required":["calendarAction"]},"composeAction":{"description":"Suggested actions for composing draft messages.","properties":{"composeAction":{"type":"object","oneOf":[{"properties":{"composeTextMessage":{"description":"Compose a draft text message.","type":"object","properties":{"phoneNumber":{"type":"string"},"text":{"type":"string","maxLength":100,"description":"maxLength: 100\n"}},"required":["phoneNumber","text"]}},"required":["composeTextMessage"]},{"properties":{"composeRecordingMessage":{"description":"Compose a draft message with a media recording.","type":"object","properties":{"phoneNumber":{"type":"string"},"type":{"type":"string","enum":["AUDIO","VIDEO"]}}}},"required":["composeRecordingMessage"]}]}},"required":["composeAction"]},"CustomReply":{"description":"자동응답메시지 reply 지정 필드 추가","type":"object","properties":{"reply":{"type":"object","properties":{"autoReplyMsgId":{"type":"string","maxLength":40,"description":"maxLength: 40 - 자동응답메시지ID 입니다.\n"},"displayText":{"type":"string","minLength":1,"maxLength":25,"description":"maxLength: 25, minLength: 1 - 버튼명(표시문자열)으로 표시되는 항목입니다.\n"},"postback":{"description":"등록 시 자동 설정\n","type":"object","properties":{"data":{"type":"string","maxLength":2048,"description":"maxLength: 2048\n"}},"required":["data"]}},"required":["autoReplyMsgId"]}},"required":["reply"]}}},"paths":{"/brand/{brandId}/autoreplymsg":{"post":{"summary":"브랜드에 자동응답메시지를 등록합니다.\n","description":"브랜드에 자동응답메시지를 등록합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**  \n\n제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용하며 다음과 같이 처리 됩니다.  \n**2026.4.21 부터 모든 자동응답메시지는 통합RCS 규격으로만 사용이 가능합니다.**  \n  + 말풍선: TMCSA00001\n  + (이미지가 없는) 카드: RPCSAXX001 \n  + (세로형 Tall 이미지) 카드: RPCSMTX001\n  + (세로형 Medium 이미지) 카드: RPCSMMX001 \n  + 슬라이드형 미제공  \n    \n자동응답메시지에 등록 가능한 액션은 다음과 같습니다.  \n  + 전화걸기\n  + 브랜드 소식 연결\n  + URL연결 \n  + 다른 대화방연결\n  + 캘린더 등록\n  + 지도 보여주기(좌표)\n  + 지도 보여주기(쿼리)\n  + 사용자 위치 공유\n  + 자동응답메시지 연결\n  + 챗봇연결\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"description":"자동응답메시지 등록 정보를 전송합니다.\n","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegAutoReplyMsgInfo"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

{% tabs %}
{% tab title="말풍선" %}

```
{
    "autoReplyMsgName": "복권기금 안내",
    "messagebaseId": "SCS00000",
    "copyAllowed": true,
    "body": {
        "description": "이 복권은 복권 및 복권기금법 제4조에 의거 발행되며 조성된 자금은 동법 제23조에 따라 소외계층 지원사업등에 사용됩니다."
    }
}
```

{% endtab %}

{% tab title="카드" %}

```
{
    "autoReplyMsgName": "카드",
    "messagebaseId": "SCwThM00",
    "copyAllowed": true,
    "body": {
        "title": "카드제목",
        "description": "카드내용",
        "media": "BR.61hBmMP164-ARME1M6dN9c3l"
    },
    "buttons": [
        {
            "suggestions": [
                {
                    "action": {
                        "displayText": "RCS비즈센터",
                        "urlAction": {
                            "openUrl": {
                                "url": "https://www-qa.rcsbizcenter.com"
                            }
                        }
                    }
                }
            ]
        }
    ],
    "chipList": [
        {
            "action": {
                "dialerAction": {
                    "dialPhoneNumber": {
                        "phoneNumber": "07082245288"
                    }
                },
                "displayText": "고객센터"
            }
        }
    ]
}
```

{% endtab %}

{% tab title="슬라이드" %}

```
{
    "autoReplyMsgName": "슬라이드",
    "messagebaseId": "CCwMhM0200",
    "copyAllowed": true,
    "body": {
        "title1": "슬라이드1",
        "description1": "슬라이드1",
        "media1": "BR.61hBmMP164-ARM6tE1T7nzwf",
        "title2": "슬라이드2",
        "description2": "슬라이드2",
        "media2": "BR.61hBmMP164-ARMsYgo2O538B"
    },
    "buttons": [
        {
            "suggestions": [
                {
                    "action": {
                        "dialerAction": {
                            "dialPhoneNumber": {
                                "phoneNumber": "119"
                            }
                        },
                        "displayText": "긴급연락119"
                    }
                }
            ]
        },
        {
            "suggestions": [
                {
                    "action": {
                        "displayText": "유튜브연결",
                        "urlAction": {
                            "openUrl": {
                                "url": "https://utube.com"
                            }
                        }
                    }
                }
            ]
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>자동응답메시지 ID</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>result</code></strong></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>자동응답메시지 ID</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "autoReplyMsgId": "ARMKlU2bCGpsV37"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64336",
        "message": "required value: [autoReplyMsgName]"
    },
    "status": 400
}

{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 자동응답 메시지 수정

## Request

## 자동응답메시지의 정보를 업데이트합니다.<br>

> 자동응답메시지의 정보를 업데이트합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\* \
> \
> 제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용하며 다음과 같이 처리 됩니다.  \
> \*\*2026.4.21 부터 모든 자동응답메시지는 통합RCS 규격으로만 사용이 가능합니다.\*\*  \
> &#x20; \+ 말풍선: TMCSA00001\
> &#x20; \+ (이미지가 없는) 카드: RPCSAXX001 \
> &#x20; \+ (세로형 Tall 이미지) 카드: RPCSMTX001\
> &#x20; \+ (세로형 Medium 이미지) 카드: RPCSMMX001 \
> &#x20; \+ 슬라이드형 미제공  \
> &#x20;   \
> 자동응답메시지에 등록 가능한 액션은 다음과 같습니다.  \
> &#x20; \+ 전화걸기\
> &#x20; \+ 브랜드 소식 연결\
> &#x20; \+ URL연결 \
> &#x20; \+ 다른 대화방연결\
> &#x20; \+ 캘린더 등록\
> &#x20; \+ 지도 보여주기(좌표)\
> &#x20; \+ 지도 보여주기(쿼리)\
> &#x20; \+ 사용자 위치 공유\
> &#x20; \+ 자동응답메시지 연결\
> &#x20; \+ 챗봇연결<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"AutoReplyMsgId":{"name":"autoReplyMsgId","in":"path","schema":{"type":"string"},"required":true,"description":"브랜드 내 자동응답메시지 정보 접근시 사용되는 자동응답메시지ID Path Parameter 입니다.\n"}},"schemas":{"RegAutoReplyMsgInfo":{"required":["autoReplyMsgName","messagebaseId","body"],"description":"자동응답메시지 등록/수정 시 필요한 정보입니다.\n","type":"object","properties":{"autoReplyMsgName":{"type":"string","maxLength":100,"description":"maxLength: 100 - 자동응답메시지 명을 지정합니다.\n"},"messagebaseId":{"type":"string","maxLength":40,"description":"maxLength: 40 - 메시지 상품코드 chat에 속하는 messagebase ID를 지정합니다.  \n"},"copyAllowed":{"type":"boolean","default":true,"description":"단말에서 메시지 복사 가능 여부를 지정합니다.  \n\n  + true : 복사 가능\n  + false : 복사 불가\n"},"body":{"type":"object","description":"이통 발송규격 중 /message API의 body object와 동일한 방식으로 값을 지정합니다.  \n"},"buttons":{"description":"자동응답메시지에 버튼을 등록합니다.\n\n지원하는 action 유형은 다음과 같습니다.  \n\n  + urlAction : URL 연결, 브랜드 소식 연결(브랜드 소식의 URL을 넣어주면 됩니다.)  \n  + mapAction : 지도 보여주기(좌표), 지도 보여주기(쿼리), 사용자 위치 공유 \n  + calendarAction : 캘린더 등록  \n  + composeAction : 지정 대화방에 메시지 작성  \n  + dialerAction : 전화걸기  \n  + reply : 챗봇연결, 자동응답메시지 연결(다른 자동응답메시지 연결 시에는 reply JSON object 내에 autoReplyMsgId 필드에 자동응답메시지ID를 지정하며, postback.data는 자동할당 됩니다.)\n\n**clipboardAction, localBrowserAction 은 2026.04.21 부터 더 이상 지원하지 않습니다.**             \n","type":"array","items":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/AutoReplyMsgActions"}}}}},"chipList":{"description":"자동응답메시지에 칩리스트를 지정합니다. \n\n지원하는 action 유형은 다음과 같습니다.  \n\n  + urlAction : URL 연결, 브랜드 소식 연결(브랜드 소식의 URL을 넣어주면 됩니다.)  \n  + mapAction : 지도 보여주기(좌표), 지도 보여주기(쿼리), 사용자 위치 공유 \n  + calendarAction : 캘린더 등록  \n  + composeAction : 지정 대화방에 메시지 작성  \n  + dialerAction : 전화걸기  \n  + reply : 챗봇연결, 자동응답메시지 연결(다른 자동응답메시지 연결 시에는 reply JSON object 내에 autoReplyMsgId 필드에 자동응답메시지ID를 지정하며, postback.data는 자동할당 됩니다.)\n\n**clipboardAction, localBrowserAction 은 2026.04.21 부터 더 이상 지원하지 않습니다.**  \n","type":"array","items":{"$ref":"#/components/schemas/AutoReplyMsgActions"}}}},"AutoReplyMsgActions":{"oneOf":[{"$ref":"#/components/schemas/ARMaction"},{"$ref":"#/components/schemas/CustomReply"}]},"ARMaction":{"description":"자동응답메시지용 Action","type":"object","properties":{"action":{"type":"object","oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"},{"$ref":"#/components/schemas/mapAction"},{"$ref":"#/components/schemas/calendarAction"},{"$ref":"#/components/schemas/composeAction"}]}},"required":["action"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]},"mapAction":{"description":"Suggested actions for interacting with a location on a map.","properties":{"mapAction":{"type":"object","oneOf":[{"properties":{"showLocation":{"description":"Shows a given location on a map.","type":"object","properties":{"location":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"label":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"}},"required":["latitude","longitude"]},"fallbackUrl":{"type":"string","format":"uri"}},"required":["location"]}},"required":["showLocation"]},{"properties":{"requestLocationPush":{"description":"One-time request to send a geo location push from UE to\nchatbot","type":"object","properties":{"currentLocation":{"description":"set true to send current location without location\nselection","type":"boolean"}}}},"required":["requestLocationPush"]}]}},"required":["mapAction"]},"calendarAction":{"description":"Suggested actions for interacting with a calendar event.","properties":{"calendarAction":{"type":"object","oneOf":[{"properties":{"createCalendarEvent":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"title":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"},"description":{"type":"string","minLength":1,"maxLength":500,"description":"maxLength: 500, minLength: 1\n"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["startTime","endTime","title"]}},"required":["createCalendarEvent"]}]}},"required":["calendarAction"]},"composeAction":{"description":"Suggested actions for composing draft messages.","properties":{"composeAction":{"type":"object","oneOf":[{"properties":{"composeTextMessage":{"description":"Compose a draft text message.","type":"object","properties":{"phoneNumber":{"type":"string"},"text":{"type":"string","maxLength":100,"description":"maxLength: 100\n"}},"required":["phoneNumber","text"]}},"required":["composeTextMessage"]},{"properties":{"composeRecordingMessage":{"description":"Compose a draft message with a media recording.","type":"object","properties":{"phoneNumber":{"type":"string"},"type":{"type":"string","enum":["AUDIO","VIDEO"]}}}},"required":["composeRecordingMessage"]}]}},"required":["composeAction"]},"CustomReply":{"description":"자동응답메시지 reply 지정 필드 추가","type":"object","properties":{"reply":{"type":"object","properties":{"autoReplyMsgId":{"type":"string","maxLength":40,"description":"maxLength: 40 - 자동응답메시지ID 입니다.\n"},"displayText":{"type":"string","minLength":1,"maxLength":25,"description":"maxLength: 25, minLength: 1 - 버튼명(표시문자열)으로 표시되는 항목입니다.\n"},"postback":{"description":"등록 시 자동 설정\n","type":"object","properties":{"data":{"type":"string","maxLength":2048,"description":"maxLength: 2048\n"}},"required":["data"]}},"required":["autoReplyMsgId"]}},"required":["reply"]}}},"paths":{"/brand/{brandId}/autoreplymsg/{autoReplyMsgId}":{"put":{"summary":"자동응답메시지의 정보를 업데이트합니다.\n","description":"자동응답메시지의 정보를 업데이트합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자** \n\n제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용하며 다음과 같이 처리 됩니다.  \n**2026.4.21 부터 모든 자동응답메시지는 통합RCS 규격으로만 사용이 가능합니다.**  \n  + 말풍선: TMCSA00001\n  + (이미지가 없는) 카드: RPCSAXX001 \n  + (세로형 Tall 이미지) 카드: RPCSMTX001\n  + (세로형 Medium 이미지) 카드: RPCSMMX001 \n  + 슬라이드형 미제공  \n    \n자동응답메시지에 등록 가능한 액션은 다음과 같습니다.  \n  + 전화걸기\n  + 브랜드 소식 연결\n  + URL연결 \n  + 다른 대화방연결\n  + 캘린더 등록\n  + 지도 보여주기(좌표)\n  + 지도 보여주기(쿼리)\n  + 사용자 위치 공유\n  + 자동응답메시지 연결\n  + 챗봇연결\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/AutoReplyMsgId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegAutoReplyMsgInfo"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="말풍선" %}

```
{
    "autoReplyMsgName": "복권기금 안내",
    "messagebaseId": "SCS00000",
    "copyAllowed": true,
    "body": {
        "description": "이 복권은 복권 및 복권기금법 제4조에 의거 발행되며 조성된 자금은 동법 제23조에 따라 소외계층 지원사업등에 사용됩니다."
    }
}
```

{% endtab %}

{% tab title="카드" %}

```
{
    "autoReplyMsgName": "카드",
    "messagebaseId": "SCwThM00",
    "copyAllowed": true,
    "body": {
        "title": "카드제목",
        "description": "카드내용",
        "media": "BR.61hBmMP164-ARME1M6dN9c3l"
    },
    "buttons": [
        {
            "suggestions": [
                {
                    "action": {
                        "displayText": "RCS비즈센터",
                        "urlAction": {
                            "openUrl": {
                                "url": "https://www-qa.rcsbizcenter.com"
                            }
                        }
                    }
                }
            ]
        }
    ],
    "chipList": [
        {
            "action": {
                "dialerAction": {
                    "dialPhoneNumber": {
                        "phoneNumber": "07082245288"
                    }
                },
                "displayText": "고객센터"
            }
        }
    ]
}
```

{% endtab %}

{% tab title="슬라이드" %}

```
{
    "autoReplyMsgName": "슬라이드",
    "messagebaseId": "CCwMhM0200",
    "copyAllowed": true,
    "body": {
        "title1": "슬라이드1",
        "description1": "슬라이드1",
        "media1": "BR.61hBmMP164-ARM6tE1T7nzwf",
        "title2": "슬라이드2",
        "description2": "슬라이드2",
        "media2": "BR.61hBmMP164-ARMsYgo2O538B"
    },
    "buttons": [
        {
            "suggestions": [
                {
                    "action": {
                        "dialerAction": {
                            "dialPhoneNumber": {
                                "phoneNumber": "119"
                            }
                        },
                        "displayText": "긴급연락119"
                    }
                }
            ]
        },
        {
            "suggestions": [
                {
                    "action": {
                        "displayText": "유튜브연결",
                        "urlAction": {
                            "openUrl": {
                                "url": "https://utube.com"
                            }
                        }
                    }
                }
            ]
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>자동응답메시지 ID</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="199">필드명</th><th width="178">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>자동응메시지 상세 정보입니다.</td></tr><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>autoReplyMsgName</code></strong></td><td>string</td><td align="center">100</td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>자동응답메시지 등록 상태입니다. 자동응답메시지는 운영자 검수 없이 자동 등록됩니다.</p><ul><li>등록완료 : 이통3사에 자동응답메시지가 정상 등록된 상태입니다.</li><li>저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다.</li><li>처리중 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>수정 계정 ID</td></tr><tr><td><strong><code>copyAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>true</td><td></td></tr><tr><td><strong><code>body</code></strong></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>buttons</code></strong></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>chipList</code></strong></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200-말풍선" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.61hBmMP164",
            "autoReplyMsgId": "ARMKLOTfB1h1Fne",
            "autoReplyMsgName": "복권기금 안내",
            "messagebaseId": "SCS00000",
            "approvalResult": "처리중",
            "registerDate": "2024-06-28T11:20:25.000+09",
            "updateDate": "2024-06-28T11:20:25.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "status": "APRV_MOD",
            "aprvRet": "INSPECTED",
            "autoReplyMsgType": "SCL",
            "autoReplyMsgTypeNm": "말풍선",
            "cardCount": 0,
            "copyAllowed": true,
            "body": {
                "description": "이 복권은 복권 및 복권기금법 제4조에 의거 발행되며 조성된 자금은 동법 제23조에 따라 소외계층 지원사업등에 사용됩니다."
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200-카드" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.61hBmMP164",
            "autoReplyMsgId": "ARMKLOTfB1h1Fne",
            "autoReplyMsgName": "카드1장",
            "messagebaseId": "SCwThM00",
            "approvalResult": "처리중",
            "registerDate": "2024-06-28T11:38:37.000+09",
            "updateDate": "2024-06-28T11:38:37.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "buttons": [
                {
                    "suggestions": [
                        {
                            "action": {
                                "displayText": "RCS비즈센터",
                                "urlAction": {
                                    "openUrl": {
                                        "url": "https://www-qa.rcsbizcenter.com"
                                    }
                                },
                                "postback": {
                                    "data": "postbackId=PClYUNGU5mE4dn2;;"
                                }
                            }
                        }
                    ]
                }
            ],
            "chipList": [
                {
                    "action": {
                        "dialerAction": {
                            "dialPhoneNumber": {
                                "phoneNumber": "07082245288"
                            }
                        },
                        "displayText": "고객센터",
                        "postback": {
                            "data": "postbackId=PPagxG7V5cHdlsm;;"
                        }
                    }
                }
            ],
            "status": "APRV_MOD",
            "aprvRet": "INSPECTED",
            "autoReplyMsgType": "CARD",
            "autoReplyMsgTypeNm": "카드",
            "cardCount": 0,
            "copyAllowed": true,
            "body": {
                "title": "카드1장제목",
                "description": "카드1장내용",
                "media": "BR.61hBmMP164-ARME1M6dN9c3l"
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="200-슬라이드" %}

````
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.61hBmMP164",
            "autoReplyMsgId": "ARMKLOTfB1h1Fne",
            "autoReplyMsgName": "슬라이드",
            "messagebaseId": "CCwMhM0200",
            "approvalResult": "처리중",
            "registerDate": "2024-06-28T11:39:21.000+09",
            "updateDate": "2024-06-28T11:39:21.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "buttons": [
                {
                    "suggestions": [
                        {
                            "action": {
                                "dialerAction": {
                                    "dialPhoneNumber": {
                                        "phoneNumber": "119"
                                    }
                                },
                                "displayText": "긴급연락119",
                                "postback": {
                                    "data": "postbackId=Prr7V706hnDO694;;"
                                }
                            }
                        }
                    ]
                },
                {
                    "suggestions": [
                        {
                            "action": {
                                "displayText": "유튜브연결",
                                "urlAction": {
                                    "openUrl": {
                                        "url": "https://utube.com"
                                    }
                                },
                                "postback": {
                                    "data": "postbackId=P6vRpgNjRhENE9O;;"
                                }
                            }
                        }
                    ]
                }
            ],
            "status": "APRV_MOD",
            "aprvRet": "INSPECTED",
            "autoReplyMsgType": "SLIDER",
            "autoReplyMsgTypeNm": "슬라이드",
            "cardCount": 0,
            "copyAllowed": true,
            "body": {
                "title1": "슬라이드1",
                "description1": "슬라이드1",
                "media1": "BR.61hBmMP164-ARM6tE1T7nzwf",
                "title2": "슬라이드2",
                "description2": "슬라이드2",
                "media2": "BR.61hBmMP164-ARMsYgo2O538B"
            }
        }
    ],
    "status": 200
}
```
````

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64336",
        "message": "required value: [autoReplyMsgName]"
    },
    "status": 400
}

{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 자동응답 메시지 삭제

## Request

## 자동응답메시지를 삭제합니다.<br>

> 자동응답메시지를 삭제합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"AutoReplyMsgId":{"name":"autoReplyMsgId","in":"path","schema":{"type":"string"},"required":true,"description":"브랜드 내 자동응답메시지 정보 접근시 사용되는 자동응답메시지ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/autoreplymsg/{autoReplyMsgId}":{"delete":{"summary":"자동응답메시지를 삭제합니다.\n","description":"자동응답메시지를 삭제합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/AutoReplyMsgId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>자동응답메시지 ID</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="174">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>자동응답메시지 ID</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "autoReplyMsgId": "ARMKlU2bCGpsV37"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 자동응답 메시지 이미지 상세 조회

## Request

## 자동응답메시지에서 사용할 이미지 파일 상세 정보를 조회합니다.<br>

> 자동응답메시지에서 사용할 이미지 파일 상세 정보를 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"FileId":{"name":"fileId","in":"path","schema":{"type":"string"},"required":true,"description":"파일ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/autoreplymsg/file/{fileId}":{"get":{"summary":"자동응답메시지에서 사용할 이미지 파일 상세 정보를 조회합니다.\n","description":"자동응답메시지에서 사용할 이미지 파일 상세 정보를 조회합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/FileId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>자동응답메시지용 파일 등록 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>등록된 파일의 ID 입니다.</td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>등록된 파일의 URL 정보 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BR.61hBmMP164-ARMExJiCTJSzQ",
            "url": "https://file-qa.rcsbizcenter.com/brand/BR.61hBmMP164/autoreplymsg/BR.61hBmMP164-ARMExJiCTJSzQ_1.png",
            "fileName": "BR.275F8GY6nR-FD4DBi3W06i5.png"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 자동응답 메시지 이미지 등록

## Request

## 자동응답메시지에서 사용할 이미지 파일을 등록합니다.<br>

> 자동응답메시지에서 사용할 이미지 파일을 등록합니다.\
> 파일을 먼저 등록해야 자동응답메시지를 등록할 때 fileId를 메시지 내 지정할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/autoreplymsg/file":{"post":{"summary":"자동응답메시지에서 사용할 이미지 파일을 등록합니다.\n","description":"자동응답메시지에서 사용할 이미지 파일을 등록합니다.\n파일을 먼저 등록해야 자동응답메시지를 등록할 때 fileId를 메시지 내 지정할 수 있습니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"type":"object","format":"binary","description":"자동응답메시지에 사용할 이미지 파일입니다.\n"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>자동응답메시지용 파일 등록 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>등록된 파일의 ID 입니다.</td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>등록된 파일의 URL 정보 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BR.61hBmMP164-ARMExJiCTJSzQ",
            "url": "https://file-qa.rcsbizcenter.com/brand/BR.61hBmMP164/autoreplymsg/BR.61hBmMP164-ARMExJiCTJSzQ_1.png",
            "fileName": "[크기변환]BR.275F8GY6nR-FD4DBi3W06i5.png"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 고객반응 통계

이 문서는 고객 통계 데이터에 대한 API 정보를 안내합니다.


# 메시지 발송 통계

## Request

## 고객반응 통계 - 캠페인 메시지 발송/읽음확인 통계를 조회합니다.<br>

> 고객반응 통계 - 캠페인 메시지 발송/읽음확인 통계를 조회합니다.\
> \
> &#x20; \- 동일 Group ID+동일 메시지포맷으로 발송일 기준 발송 성공건수(이통사별 100건 이상)에 해당하면 D+3일간 집계됩니다.  \
> &#x20; \- 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\* <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"StartDate":{"name":"startDate","in":"query","schema":{"type":"string"},"description":"통계 조회 기간 시작일자(yyyymmdd) 입니다.","required":true},"EndDate":{"name":"endDate","in":"query","schema":{"type":"string"},"description":"통계 조회 기간 종료일자(yyyymmdd) 입니다.","required":true},"GroupId":{"name":"groupId","in":"query","schema":{"type":"string"},"description":"발송 캠페인 구분 ID 입니다.","required":true},"ChatbotIdQuery":{"name":"chatbotId","in":"query","description":"대화방ID Query Parameter 입니다.\n","schema":{"type":"string"}}}},"paths":{"/statQuery/message/{brandId}":{"get":{"summary":"고객반응 통계 - 캠페인 메시지 발송/읽음확인 통계를 조회합니다.\n","description":"고객반응 통계 - 캠페인 메시지 발송/읽음확인 통계를 조회합니다.\n\n  - 동일 Group ID+동일 메시지포맷으로 발송일 기준 발송 성공건수(이통사별 100건 이상)에 해당하면 D+3일간 집계됩니다.  \n  - 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자** \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"},{"$ref":"#/components/parameters/GroupId"},{"$ref":"#/components/parameters/ChatbotIdQuery"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>메시지 발송 읽음 확인 통계 Data</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="169">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>statDate</code></strong></td><td>string</td><td align="center">8</td><td align="center"></td><td></td><td>통계일자</td></tr><tr><td><strong><code>corpId</code></strong></td><td>string</td><td align="center">13</td><td align="center"></td><td></td><td>RCS Biz Center에 등록된 기업ID</td></tr><tr><td><strong><code>corpRegNum</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>기업사업자 등록 번호</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center"></td><td></td><td>브랜드 ID</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center"></td><td></td><td>대화방 ID</td></tr><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>발송 캠페인 구분 ID</td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>발송 메시지의 messagebaseId(식별 불가시 NA)</td></tr><tr><td><strong><code>deliveredCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>발송 건수</td></tr><tr><td><strong><code>displayedCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>읽음확인 건수</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "statDate": "20240628",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6227",
            "messagebaseId": "SMwThT00",
            "deliveredCount": 116,
            "displayedCount": 56
        },
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6227",
            "messagebaseId": "SMwThT00",
            "deliveredCount": 0,
            "displayedCount": 9
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [groupId]"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [endDate]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [endDate], endDate must be within 31 days"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 메시지 버튼 클릭 통계

## Request

## 고객반응 통계 - 캠페인 메시지 버튼 클릭 통계를 조회합니다.<br>

> 고객반응 통계 - 캠페인 메시지 버튼 클릭 통계를 조회합니다.\
> \
> &#x20; \- 동일 Group ID+동일 메시지포맷으로 발송일 기준 발송 성공건수(이통사별 100건 이상)에 해당하면 D+3일간 집계됩니다.  \
> &#x20; \- 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.\
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\* <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"StartDate":{"name":"startDate","in":"query","schema":{"type":"string"},"description":"통계 조회 기간 시작일자(yyyymmdd) 입니다.","required":true},"EndDate":{"name":"endDate","in":"query","schema":{"type":"string"},"description":"통계 조회 기간 종료일자(yyyymmdd) 입니다.","required":true},"GroupId":{"name":"groupId","in":"query","schema":{"type":"string"},"description":"발송 캠페인 구분 ID 입니다.","required":true},"ChatbotIdQuery":{"name":"chatbotId","in":"query","description":"대화방ID Query Parameter 입니다.\n","schema":{"type":"string"}}}},"paths":{"/statQuery/messageButton/{brandId}":{"get":{"summary":"고객반응 통계 - 캠페인 메시지 버튼 클릭 통계를 조회합니다.\n","description":"고객반응 통계 - 캠페인 메시지 버튼 클릭 통계를 조회합니다.\n\n  - 동일 Group ID+동일 메시지포맷으로 발송일 기준 발송 성공건수(이통사별 100건 이상)에 해당하면 D+3일간 집계됩니다.  \n  - 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.\n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자** \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"},{"$ref":"#/components/parameters/GroupId"},{"$ref":"#/components/parameters/ChatbotIdQuery"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>메시지 버튼 클릭 카운트</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="171">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>statDate</code></strong></td><td>string</td><td align="center">8</td><td align="center"></td><td></td><td>통계일자</td></tr><tr><td><strong><code>corpId</code></strong></td><td>string</td><td align="center">13</td><td align="center"></td><td></td><td>RCS Biz Center에 등록된 기업ID</td></tr><tr><td><strong><code>corpRegNum</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>기업사업자 등록 번호</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center"></td><td></td><td>브랜드 ID</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center"></td><td></td><td>대화방 ID</td></tr><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>발송 캠페인 구분 ID</td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td>NA</td><td>발송 메시지의 messagebaseId (식별 불가시 NA)</td></tr><tr><td><strong><code>reactionType</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td>NA</td><td><p>고객이 클릭 반응한 대상(messagebaseId 식별 불가 시 NA)</p><ul><li>NA: 식별불가</li><li>button:  메시지  내 버튼</li><li>chipList: 메시지 하단 칩리스트</li><li>image: 메시지 내 이미지</li></ul></td></tr><tr><td><strong><code>cardNum</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>reactionType 해당 card 의 위치 (식별 불가시 0)</p><p><strong>ex1)</strong> Standalone 인 경우 1</p><p><strong>ex2)</strong> Card 4장 Carousel 1, 2, 3, 4 중 버튼이 위치한 카드 번호</p><p><strong>ex3)</strong> 칩리스트인 경우 1</p></td></tr><tr><td><a href="#buttonlist-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>buttonList</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>발송 캠페인 메시지에 포함된 RCS 액션 버튼 통계 Data</td></tr></tbody></table>

### <mark style="color:blue;">buttonList</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="171">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonNum</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>0</td><td><p>이미지, 칩리스트 또는 버튼 reactionType별 메시지 내 위치를 나타내는 번호(식별 불가시 0)</p><p>좌에서 우, 위에서 아래로 1 부터 부여하며 Carousel은 각 카드 별로 1 부터 부여</p></td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>메시지 버튼에 할당된 RCS 액션 유형</p><p>이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분</p><ul><li>urlAction</li><li>dialerAction</li><li>mapAction</li><li>calendarAction</li><li>composeAction</li><li>clipboardAction</li><li>iframeplayB</li></ul></td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공</td></tr><tr><td><strong><code>clickCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6236",
            "messagebaseId": "IBR.mp0Xf8sGBE-iE8w82N11u45AHjEC3Oz8CB9A",
            "cardNum": 1,
            "reactionType": "button",
            "buttonList": [
                {
                    "actionType": "urlAction",
                    "title": "자세히 보기",
                    "clickCount": 272,
                    "buttonNum": 1
                },
                {
                    "actionType": "urlAction",
                    "title": "버닝러시",
                    "clickCount": 82,
                    "buttonNum": 2
                }
            ]
        },
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6236",
            "messagebaseId": "IBR.mp0Xf8sGBE-iE8w82N11u45AHjEC3Oz8CB9A",
            "cardNum": 1,
            "reactionType": "image",
            "buttonList": [
                {
                    "actionType": "urlAction",
                    "title": "image_1",
                    "clickCount": 32,
                    "buttonNum": 1
                }
            ]
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [groupId]"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [endDate]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [endDate], endDate must be within 31 days"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 메뉴 클릭 통계

## Request

## 고객반응 통계 - 대화방 메뉴 클릭 통계를 조회합니다.<br>

> 고객반응 통계 - 대화방 메뉴 클릭 통계를 조회합니다.\
> \
> &#x20; \- 대화방별 1건 이상 사용자선택이 일어난 경우에 대해 집계됩니다.  \
> &#x20; \- 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.\
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\* <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"StartDate":{"name":"startDate","in":"query","schema":{"type":"string"},"description":"통계 조회 기간 시작일자(yyyymmdd) 입니다.","required":true},"EndDate":{"name":"endDate","in":"query","schema":{"type":"string"},"description":"통계 조회 기간 종료일자(yyyymmdd) 입니다.","required":true},"ChatbotIdQueryReuired":{"name":"chatbotId","in":"query","description":"대화방ID Query Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/statQuery/persistentMenu/{brandId}":{"get":{"summary":"고객반응 통계 - 대화방 메뉴 클릭 통계를 조회합니다.\n","description":"고객반응 통계 - 대화방 메뉴 클릭 통계를 조회합니다.\n\n  - 대화방별 1건 이상 사용자선택이 일어난 경우에 대해 집계됩니다.  \n  - 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.\n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자** \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"},{"$ref":"#/components/parameters/ChatbotIdQueryReuired"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방메뉴 통계 Data</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>statDate</code></strong></td><td>string</td><td align="center">8</td><td align="center"></td><td></td><td>통계일자</td></tr><tr><td><strong><code>corpId</code></strong></td><td>string</td><td align="center">13</td><td align="center"></td><td></td><td>RCS Biz Center에 등록된 기업ID</td></tr><tr><td><strong><code>corpRegNum</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>기업사업자 등록 번호</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center"></td><td></td><td>브랜드 ID</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center"></td><td></td><td>대화방 ID</td></tr><tr><td><a href="#menulist-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>menuList</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>대화방메뉴 별 상세 Data</td></tr></tbody></table>

### <mark style="color:blue;">menuList</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="167">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>postbackId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>메뉴에 할당된 postbackId</td></tr><tr><td><strong><code>menuType</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td><p>메뉴 할당된 액션 구분</p><ul><li>action: RCS 액션 버튼(urlAction, mapAction, ...) 메뉴</li><li>reply: 기본응답 메뉴</li><li>autoreply: 자동응답 메뉴</li><li>menu: 하위 메뉴를 갖는 상위 메뉴</li></ul></td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>menuType이 action인 경우, 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분</p><p></p><p>(현재 자동응답메시지는 iframepalyB 설정 미지원)</p></td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공</td></tr><tr><td><strong><code>clickCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>menuType이 action, reply, autoreply 인 경우 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)</td></tr><tr><td><a href="#sublist-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>subList</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>하위 메뉴 또는 자동응답메시지 상의 버튼 상세 Data</td></tr></tbody></table>

### <mark style="color:blue;">subList</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="168">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>postbackId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>메뉴에 할당된 postbackId</td></tr><tr><td><strong><code>menuType</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td><p>메뉴 할당된 액션 구분</p><ul><li>action: RCS 액션 버튼(urlAction, mapAction, ...) 메뉴</li><li>reply: 기본응답 메뉴</li><li>autoreply: 자동응답 메뉴</li><li>menu: 하위 메뉴를 갖는 상위 메뉴</li></ul></td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>menuType이 action인 경우 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분</p><p></p><p>(현재 자동응답메시지는 iframepalyB 설정 미지원)</p></td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공</td></tr><tr><td><strong><code>clickCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>menuType이 action, reply, autoreply 인 경우 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)</td></tr><tr><td><a href="#subactionlist-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>subActionList</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>menuType이 autoReply인 경우 자동응답메시지 상의 상세 버튼 Data</td></tr></tbody></table>

### <mark style="color:blue;">subActionList</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="168">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>postbackId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>메뉴에 할당된 postbackId</td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>menuType이 action인 경우 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분(현재 자동응답메시지는 iframepalyB 설정 미지원)</td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공</td></tr><tr><td><strong><code>clickCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>menuType이 action, reply, autoreply 인 경우 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "statDate": "20240630",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196573",
            "menuList": [
                {
                    "postbackId": "P090pbJY06J6fgX",
                    "menuType": "autoreply",
                    "title": "내원 진료 시간",
                    "clickCount": 1
                },
                {
                    "postbackId": "ARM6J1wfCn81N6u",
                    "menuType": "autoreply",
                    "title": "위치 안내",
                    "clickCount": 1,
                    "subList": [
                        {
                            "postbackId": "Pec587X6nVY8k5c",
                            "menuType": "action",
                            "title": "지도",
                            "clickCount": 1,
                            "actionType": "urlAction",
                            "messagebaseId": "SCwThT00",
                            "reactionType": "button",
                            "cardNum": 1,
                            "buttonNum": 1
                        }
                    ]
                }
            ]
        },
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196573",
            "menuList": [
                {
                    "postbackId": "ARM6J1wfCn81N6u",
                    "menuType": "autoreply",
                    "title": "위치 안내",
                    "clickCount": 1,
                    "subList": [
                        {
                            "postbackId": "Pec587X6nVY8k5c",
                            "menuType": "action",
                            "title": "지도",
                            "clickCount": 1,
                            "actionType": "urlAction",
                            "messagebaseId": "SCwThT00",
                            "reactionType": "button",
                            "cardNum": 1,
                            "buttonNum": 1
                        }
                    ]
                }
            ]
        },
        {
            "statDate": "20240628",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196573",
            "menuList": [
                {
                    "postbackId": "P41aj0w7FTu97Zw",
                    "menuType": "autoreply",
                    "title": "국민건강보험공단 검진 안내",
                    "clickCount": 2
                },
                {
                    "postbackId": "ARM6J1wfCn81N6u",
                    "menuType": "autoreply",
                    "title": "위치 안내",
                    "clickCount": 1
                }
            ]
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [chatbotId]"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [endDate]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [endDate], endDate must be within 31 days"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 브랜드 프로필 노출 통계

## Request

## 브랜드프로필 노출 통계를 조회합니다.<br>

> 브랜드프로필 노출 통계를 조회합니다.\
> \
> &#x20; \- 브랜드 프로필 이미지가 단말에 표시되면 일자별로 집계됩니다. \
> &#x20; \- 단말에서 브랜드 프로필은 대화방별로 노출되므로 통계 데이터는 브랜드에 등록된 대화방별 건수로 제공됩니다.\
> &#x20; \- 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.\
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\* <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"StartDate":{"name":"startDate","in":"query","schema":{"type":"string"},"description":"통계 조회 기간 시작일자(yyyymmdd) 입니다.","required":true},"EndDate":{"name":"endDate","in":"query","schema":{"type":"string"},"description":"통계 조회 기간 종료일자(yyyymmdd) 입니다.","required":true}}},"paths":{"/statQuery/brandprofile/{brandId}":{"get":{"summary":"브랜드프로필 노출 통계를 조회합니다.\n","description":"브랜드프로필 노출 통계를 조회합니다.\n\n  - 브랜드 프로필 이미지가 단말에 표시되면 일자별로 집계됩니다. \n  - 단말에서 브랜드 프로필은 대화방별로 노출되므로 통계 데이터는 브랜드에 등록된 대화방별 건수로 제공됩니다.\n  - 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.\n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자** \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>일자별, 대화방별 브랜드 프로필 노출 통계 Data</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="171">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>statDate</code></strong></td><td>string</td><td align="center">8</td><td align="center"></td><td></td><td>통계일자</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center"></td><td></td><td>대화방 ID</td></tr><tr><td><strong><code>displayedCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>대화방별 브랜드 프로필 노출 건수</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "statDate": "20240630",
            "chatbotId": "09044196572",
            "displayedCount": 620
        },
        {
            "statDate": "20240629",
            "chatbotId": "09044196572",
            "displayedCount": 636
        },
        {
            "statDate": "20240628",
            "chatbotId": "09044196572",
            "displayedCount": 631
        },
        {
            "statDate": "20240627",
            "chatbotId": "09044196572",
            "displayedCount": 632
        },
        {
            "statDate": "20240626",
            "chatbotId": "09044196572",
            "displayedCount": 609
        },
        {
            "statDate": "20240625",
            "chatbotId": "09044196572",
            "displayedCount": 639
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [chatbotId]"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [endDate]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [endDate], endDate must be within 31 days"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 레이아웃

이 문서는 메시지 포맷에 대한 API 정보를 안내합니다.


# 컴포넌트 목록 조회

## Request

## 레이아웃 등록/수정 시 사용 가능한 컴포넌트 목록을 조회 합니다.<br>

> 레이아웃 등록/수정 시 사용 가능한 컴포넌트 목록을 조회 합니다.  \
> 컴포넌트 별 상세 내역이 제공되므로 별도의 컴포넌트별 상세 조회 API는 제공하지 않습니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/baselayout/component":{"get":{"summary":"레이아웃 등록/수정 시 사용 가능한 컴포넌트 목록을 조회 합니다.\n","description":"레이아웃 등록/수정 시 사용 가능한 컴포넌트 목록을 조회 합니다.  \n컴포넌트 별 상세 내역이 제공되므로 별도의 컴포넌트별 상세 조회 API는 제공하지 않습니다.  \n\n  + **계정 권한: 대행사**\n","parameters":[{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>컴포넌트 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="197">필드명</th><th width="141">타입</th><th width="82" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>componentId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>컴포넌트 ID 입니다.</td></tr><tr><td><strong><code>componentName</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>컴포넌트 이름 입니다.</td></tr><tr><td><strong><code>iconImgFileUrl</code></strong></td><td>string</td><td align="center">1000</td><td align="center"></td><td></td><td>컴포넌트 모양을 아이콘으로 표현한 이미지 파일 주소입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>컴포넌트의 사용 가능 여부, 범위를 표시합니다.</p><ul><li>public: 레이아웃 등록/수정 시 사용 가능한 컴포넌트 입니다.</li><li>private: RBC에서 특정 케이스별 추가하는 컴포넌트로 레이아웃 등록/수정 시 별도 사용할 수 없습니다.</li><li>tpl: 템플릿에서 사용되는 컴포넌트로 레이아웃 등록/수정 시 사용할 수 없습니다.</li><li>disable: 사용할 수 없는 컴포넌트 입니다. 제공 중이던 컴포넌트가 사용 중지된 경우 설정됩니다.</li></ul></td></tr><tr><td><strong><code>headerYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃의 Header 영역 내 사용 가능 여부입니다.</p><ul><li>Y: 가능</li><li>N: 불가능</li></ul></td></tr><tr><td><strong><code>bodyYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃의 Body 영역 내 사용 가능 여부입니다.</p><ul><li>Y: 가능</li><li>N: 불가능</li></ul></td></tr><tr><td><strong><code>footerYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃의 footer 영역 내 사용 가능 여부입니다.</p><ul><li>Y: 가능</li><li>N: 불가능</li></ul></td></tr><tr><td><a href="#options-object-0"><mark style="color:blue;"><strong><code>options</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 사용 시 컴포넌트에 적용될 수 있는 옵션입니다. 옵션 지정이 가능한 경우 표기됩니다.</td></tr><tr><td><strong><code>groupComponentId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>컴포넌트 그룹 ID 입니다. 동일한 컴포넌트 그룹ID를 갖는 컴포넌트는 레이아웃의 body 영역에서 함께 사용될 수 없습니다.</td></tr></tbody></table>

### <mark style="color:blue;">options</mark> - object(0)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>leftAlign</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>left</td><td><p>좌측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.</p><ul><li>left : 좌측 정렬</li><li>right : 우측 정렬</li><li>center : 중앙 정렬</li></ul></td></tr><tr><td><strong><code>rightAlign</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>right</td><td><p>우측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.</p><ul><li>left : 좌측 정렬</li><li>right : 우측 정렬</li><li>center : 중앙 정렬</li></ul></td></tr><tr><td><strong><code>leftTextStyle</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>normal</td><td><p>좌측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.</p><ul><li>normal : 기본 스타일</li><li>bold : bold 스타일 적용</li></ul></td></tr><tr><td><strong><code>rightTextStyle</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>normal</td><td><p>우측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.</p><ul><li>normal : 기본 스타일</li><li>bold : bold 스타일 적용</li></ul></td></tr><tr><td><strong><code>maxCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>5</td><td><p>테이블의 행 개수를 지정합니다. 정의된 숫자 이외에는 지정할 수 없습니다.</p><ul><li>5 : 5행</li><li>10 : 10행</li></ul></td></tr></tbody></table>

{% hint style="info" %}
Table / StyleTable등 테이블 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### <mark style="color:blue;">options</mark> - object(1)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>color</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>버튼의 색상 설정 옵션입니다. 버튼의 색상은 브랜드 정보에서 지정한 templateColor 컬러 Hex 값과 동일해야 합니다. 빈값 지정 시 기본 버튼 컬러로 적용되며, 지정된 컬러 Hex 값이 templateColor의 값과 다르면 templateColor로 강제 설정됩니다.</td></tr></tbody></table>

{% hint style="info" %}
VButton / HButton 등 버튼 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### <mark style="color:blue;">options</mark> - object(2)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>ctlrViewAll</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>true</td><td><p>컴포넌트 단위의 viewAll(모두보기) 활성화 여부를  지정합니다.</p><ul><li>true: 컴포넌트 viewAll(모두보기) 활성화</li><li>false: 컴포넌트 viewAll(모두보기) 비활성화</li></ul></td></tr><tr><td><strong><code>viewAll</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>150</td><td><p>viewAll(모두보기) 접힘 글자수 기준값을 지정합니다.</p><ul><li>유효값: 150(default), 300</li><li>유효값 이외 수치가 입력되는 경우 defualt로 처리됩니다.</li></ul></td></tr></tbody></table>

{% hint style="info" %}
viewAll(모두보기) 설정을 포함하는 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "componentId": "CP-Banner",
            "componentName": "배너",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-Banner/LT-CP-Banner-O17l_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "BannerGroup"
        },
        {
            "componentId": "CP-Description",
            "componentName": "디스크립션",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-Description/LT-CP-Description-qh7e_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "DescriptionGroup"
        },
        {
            "componentId": "CP-HButton",
            "componentName": "좌우버튼",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-HButton/LT-CP-HButton-Kpy2_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": {
                "color": "#1e1e1e"
            },
            "groupComponentId": "ButtonGroup"
        },
        {
            "componentId": "CP-ImageHorizontal",
            "componentName": "가로형이미지",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-ImageHorizontal/LT-CP-ImageHorizontal-535b_1.png",
            "headerYn": "Y",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "ImageGroup"
        },
        {
            "componentId": "CP-ImageSquare",
            "componentName": "정형이미지",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-ImageSquare/LT-CP-ImageSquare-N2le_1.png",
            "headerYn": "Y",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "ImageGroup"
        },
        {
            "componentId": "CP-ImageTall",
            "componentName": "장형이미지",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-ImageTall/LT-CP-ImageTall-II02_1.png",
            "headerYn": "Y",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "ImageGroup"
        },
        {
            "componentId": "CP-ItemA",
            "componentName": "아이템A",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-ItemA/LT-CP-ItemA-sHK9_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "ItemGroup"
        },
        {
            "componentId": "CP-ItemB",
            "componentName": "아이템B",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-ItemB/LT-CP-ItemB-ujA1_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "ItemGroup"
        },
        {
            "componentId": "CP-MainTitle",
            "componentName": "메인타이틀",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-MainTitle/LT-CP-MainTitle-67r7_1.png",
            "headerYn": "Y",
            "bodyYn": "N",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "TitleGroup"
        },
        {
            "componentId": "CP-NoticeL",
            "componentName": "노티스",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-NoticeL/LT-CP-NoticeL-J47V_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "layout",
            "options": null,
            "groupComponentId": "NoticeGroup"
        },
        {
            "componentId": "CP-StyleTitleA",
            "componentName": "스타일타이틀A",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-StyleTitleA/LT-CP-StyleTitleA-J68P_1.png",
            "headerYn": "Y",
            "bodyYn": "N",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "TitleGroup"
        },
        {
            "componentId": "CP-Table",
            "componentName": "테이블",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-Table/LT-CP-Table-u43h_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": {
                "rightTextStyle": "normal",
                "rightAlign": "right",
                "leftAlign": "left",
                "leftTextStyle": "normal",
                "maxCount": 10
            },
            "groupComponentId": "TableGroup"
        },
        {
            "componentId": "CP-ThumbDesc",
            "componentName": "서브디스크립션이미지",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-ThumbDesc/LT-CP-ThumbDesc-FkO3_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": {
                "maxCount": "5"
            },
            "groupComponentId": "ThumbDescGroup"
        },
        {
            "componentId": "CP-Thumbnail",
            "componentName": "썸네일 컴포넌트",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-Thumbnail/LT-CP-Thumbnail-m4xC_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": null,
            "groupComponentId": "ThumbnailGroup"
        },
        {
            "componentId": "CP-TitleDesc",
            "componentName": "서브디스크립션타이틀",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-TitleDesc/LT-CP-TitleDesc-BIc2_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": {
                "maxCount": "5"
            },
            "groupComponentId": "TableGroup"
        },
        {
            "componentId": "CP-VButton",
            "componentName": "상하버튼",
            "iconImgFileUrl": "https://file-qa.rcsbizcenter.com/form/component/CP-VButton/LT-CP-VButton-4rtF_1.png",
            "headerYn": "N",
            "bodyYn": "Y",
            "footerYn": "N",
            "status": "public",
            "options": {
                "color": "#1e1e1e"
            },
            "groupComponentId": "ButtonGroup"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 16
    },
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 샘플 레이아웃 목록 조회

## Request

## 레이아웃 등록/수정을 위해 참조용으로 제공되는 샘플 레이아웃 목록 입니다.<br>

> 레이아웃 등록/수정을 위해 참조용으로 제공되는 샘플 레이아웃 목록 입니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/baselayout/sample":{"get":{"summary":"레이아웃 등록/수정을 위해 참조용으로 제공되는 샘플 레이아웃 목록 입니다.\n","description":"레이아웃 등록/수정을 위해 참조용으로 제공되는 샘플 레이아웃 목록 입니다.  \n\n  + **계정 권한: 대행사**\n","parameters":[{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>컴포넌트 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#inks-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="172">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td>sampleLayoutId</td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>샘플 레이아웃 ID 입니다.</td></tr><tr><td>sampleLayoutName</td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>샘플 레이아웃 이름 입니다.</td></tr><tr><td>productCode</td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>샘플 레이아웃의 메시지 상품 코드 입니다.</td></tr><tr><td>status</td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td><p>샘플 레이아웃의 상태를 표시합니다.</p><ul><li>ready : 사용</li><li>pause : 사용중지</li></ul></td></tr><tr><td>registerId</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록자 ID 입니다.</td></tr><tr><td>registerDate</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 입니다.</td></tr><tr><td>updateDate</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 입니다.</td></tr><tr><td>approvalResult</td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃 등록 상태입니다. 레이아웃은 운영자 검수 없이 자동 등록됩니다.</p><ul><li>등록완료 : 이통3사에 정상 등록된 상태입니다.</li><li>저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다.</li><li>처리중 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.</li></ul></td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td>total</td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td>offset</td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td>limit</td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">inks</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td>prev</td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td>next</td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "sampleLayoutId": "OL00000001",
            "sampleLayoutName": "기본형",
            "productCode": "lms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "rd135",
            "registerDate": "2023-10-19 22:41:12",
            "updateDate": "2024-06-21 14:47:25"
        },
        {
            "sampleLayoutId": "OL00000002",
            "sampleLayoutName": "기본형 타이틀 강조",
            "productCode": "lms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "rd135",
            "registerDate": "2023-10-19 22:42:15",
            "updateDate": "2024-06-21 14:47:36"
        },
        {
            "sampleLayoutId": "OL00000003",
            "sampleLayoutName": "문단형",
            "productCode": "lms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "rd135",
            "registerDate": "2023-10-19 22:43:52",
            "updateDate": "2024-06-21 14:47:47"
        },
        {
            "sampleLayoutId": "OM00000001",
            "sampleLayoutName": "기본형",
            "productCode": "mms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "rd135",
            "registerDate": "2023-10-19 22:31:11",
            "updateDate": "2024-06-21 14:10:39"
        },
        {
            "sampleLayoutId": "OM00000002",
            "sampleLayoutName": "기본형 타이틀 강조형",
            "productCode": "mms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "rd135",
            "registerDate": "2023-10-19 22:38:00",
            "updateDate": "2024-06-21 14:41:12"
        },
        {
            "sampleLayoutId": "OM00000003",
            "sampleLayoutName": "아이템 상세형",
            "productCode": "mms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "rd135",
            "registerDate": "2023-10-19 22:39:36",
            "updateDate": "2024-06-21 17:00:37"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 6
    },
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 샘플 레이아웃 상세 조회

## Request

## 레이아웃 등록/수정을 위해 참조용으로 제공되는 샘플 레이아웃 상세 정보를 조회합니다.<br>

> 레이아웃 등록/수정을 위해 참조용으로 제공되는 샘플 레이아웃 상세 정보를 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"SampleLayoutId":{"name":"sampleLayoutId","in":"path","schema":{"type":"string"},"description":"샘플레이아웃 ID 입니다.","required":true}}},"paths":{"/baselayout/sample/{sampleLayoutId}":{"get":{"summary":"레이아웃 등록/수정을 위해 참조용으로 제공되는 샘플 레이아웃 상세 정보를 조회합니다.\n","description":"레이아웃 등록/수정을 위해 참조용으로 제공되는 샘플 레이아웃 상세 정보를 조회합니다.  \n\n  + **계정 권한: 대행사**\n","parameters":[{"$ref":"#/components/parameters/SampleLayoutId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>샘플 레이아웃 상세 정보 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="205">필드명</th><th width="137">타입</th><th width="70" align="center">길이</th><th width="96" align="center">필수여부</th><th width="139">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>sampleLayoutId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>샘플 레이아웃 상세 정보 입니다.</td></tr><tr><td><strong><code>sampleLayoutName</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>샘플 레이아웃 이름 입니다.</td></tr><tr><td><strong><code>productCode</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>샘플 레이아웃의 메시지 상품 코드 입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>샘플 레이아웃의 상태를 표시합니다.</p><ul><li>ready : 사용</li><li>pause : 사용중지</li></ul></td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>등록자 ID 입니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 입니다.</td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃 등록 상태입니다. 레이아웃은 운영자 검수 없이 자동 등록됩니다.</p><ul><li>등록완료 : 이통3사에 정상 등록된 상태입니다.</li><li>저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다.</li><li>처리중 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.</li></ul></td></tr><tr><td><strong><code>spec</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>openrichcard</td><td>레이아웃 구조가 리치카드인지 오픈리치카드인지 구분합니다. 샘플 레이아웃은 오픈리치카드로 구성되어 있습니다.</td></tr><tr><td><strong><code>cardType</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td><p>카드 종류를 구분합니다.<br>레이아웃에 표시되는 카드 타입은 다음 두 가지로 제한됩니다.</p><ul><li>format : 이통사 제공 공통포맷의 카드 타입입니다.</li><li>formatBr : 사용자가 등록한 레이아웃의 카드 타입입니다.</li></ul></td></tr><tr><td><strong><code>buttonColor</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>버튼에 지정된 컬러 값을 표시합니다. 지정된 경우 컬러 Hex 값(예,'#FFFFFF')이 표시되며, 미지정 시 빈값 입니다.</td></tr><tr><td><a href="#headercomposition-bodycomposition-footercomposition-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>headerComposition</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>카드 내의 최상위 영역으로 1개의 컴포넌트를 지정할 수 있습니다. 컴포넌트 중 headerYn = 'Y' 인 컴포넌트만 등록이 가능합니다.</td></tr><tr><td><a href="#headercomposition-bodycomposition-footercomposition-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>bodyComposition</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td><p>카드 내의 중간 영역으로 메시지 상품에서 지정한 개수의 컴포넌트를 지정할 수 있습니다.<br>컴포넌트 중 bodyYn = 'Y' 인 컴포넌트만 등록이 가능합니다.<br>예를 들어 LMS는 최대 6개의 컴포넌트를 지정할 수 있으며, 최대 개수 범위 내에서 각 영역별 배분할 수 있습니다.</p><ul><li>Header 1개 지정 시 body 최대 5개</li><li>body만 지정 시 최대 6개</li></ul></td></tr><tr><td><a href="#headercomposition-bodycomposition-footercomposition-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>footerComposition</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>카드 내의 최상위 영역으로 1개의 컴포넌트를 지정할 수 있습니다. 컴포넌트 중 footerYn = 'Y' 인 컴포넌트만 등록이 가능합니다. 현재는 footer에 사용자가 직접 지정하는 컴포넌트는 없습니다.</td></tr><tr><td><a href="#headercomposition-bodycomposition-footercomposition-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>formattedString</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>샘플 레이아웃을 구성한 openrichcard 메시지 구조 정보 입니다. 레이아웃 등록/수정 시에는 컴포넌트를 활용하므로 formattedString 은 참조 데이터로 제공됩니다.</td></tr></tbody></table>

{% hint style="info" %}
GSMA RCC.07-v11.0 참조\
<https://www.gsma.com/solutions-and-impact/technologies/networks/wp-content/uploads/2019/10/RCC.07-v11.0.pdf>
{% endhint %}

{% hint style="info" %}
TTAK.KO-06.0410/R7 참조

<https://committee.tta.or.kr/data/standard_view.jsp?secondDepthCode=PG1105&firstDepthCode=TC011&pk_num=TTAK.KO-06.0410/R7&commit_code=PG1105>
{% endhint %}

### <mark style="color:blue;">headerComposition, bodyComposition, footerComposition</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>index</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 내 컴포넌트의 순번을 표시합니다. 등록 시에는 index를 지정하지 않으며, 배열 내 순서를 기준으로 처리됩니다.</td></tr><tr><td><strong><code>componentId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>지정할 컴포넌트 ID 입니다.</td></tr><tr><td><a href="#options-object-0"><mark style="color:blue;"><strong><code>options</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 사용 시 컴포넌트에 적용될 수 있는 옵션입니다. 옵션 지정이 가능한 경우 표기됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">**options**</mark> - object(0)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="74" align="center">길이</th><th width="108" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>leftAlign</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>left</td><td><p>좌측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.</p><ul><li>left : 좌측 정렬</li><li>right : 우측 정렬</li><li>center : 중앙 정렬</li></ul></td></tr><tr><td><strong><code>rightAlign</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>right</td><td><p>우측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.</p><ul><li>left : 좌측 정렬</li><li>right : 우측 정렬</li><li>center : 중앙 정렬</li></ul></td></tr><tr><td><strong><code>leftTextStyle</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>normal</td><td><p>좌측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.</p><ul><li>normal : 기본 스타일</li><li>bold : bold 스타일 적용</li></ul></td></tr><tr><td><strong><code>rightTextStyle</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>normal</td><td><p>우측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.</p><ul><li>normal : 기본 스타일</li><li>bold : bold 스타일 적용</li></ul></td></tr><tr><td><strong><code>maxCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>5</td><td><p>테이블의 행 개수를 지정합니다. 정의된 숫자 이외에는 지정할 수 없습니다.</p><ul><li>5 : 5행</li><li>10 : 10행</li></ul></td></tr></tbody></table>

{% hint style="info" %}
Table / StyleTable등 테이블 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### <mark style="color:blue;">options</mark> - object(1)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>color</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>버튼의 색상 설정 옵션입니다. 버튼의 색상은 브랜드 정보에서 지정한 templateColor 컬러 Hex 값과 동일해야 합니다. 빈값 지정 시 기본 버튼 컬러로 적용되며, 지정된 컬러 Hex 값이 templateColor의 값과 다르면 templateColor로 강제 설정됩니다.</td></tr></tbody></table>

{% hint style="info" %}
VButton / HButton 등 버튼 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### <mark style="color:blue;">options</mark> - object(2)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>ctlrViewAll</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>true</td><td><p></p><p>컴포넌트 단위의 viewAll(모두보기) 활성화 여부를  지정합니다.</p><ul><li>true: 컴포넌트 viewAll(모두보기) 활성화</li><li>false: 컴포넌트 viewAll(모두보기) 비활성화</li></ul></td></tr><tr><td>viewAll</td><td>integer</td><td align="center"></td><td align="center"></td><td>150</td><td>viewAll(모두보기) 접힘 글자수 기준값을 지정합니다.
<br>유효값: 150(default), 300
<br>유효값 이외 수치가 입력되는 경우 defualt로 처리됩니다.</td></tr></tbody></table>

{% hint style="info" %}
viewAll(모두보기) 설정을 포함하는 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "sampleLayoutId": "OL00000001",
            "sampleLayoutName": "기본형",
            "productCode": "lms",
            "spec": "openrichcard",
            "buttonColor": null,
            "formattedString": {
                "RCSMessage": {
                    "openrichcardMessage": {
                        "scaleAllowed": true,
                        "layout": {
                            "orientation": "vertical",
                            "widget": "LinearLayout",
                            "children": [
                                {
                                    "orientation": "vertical",
                                    "widget": "LinearLayout",
                                    "visibility": "{{mTitleVsblty}}",
                                    "children": [
                                        {
                                            "orientation": "horizontal",
                                            "widget": "LinearLayout",
                                            "children": [
                                                {
                                                    "corner_radius": "4dp",
                                                    "marginRight": "4dp",
                                                    "widget": "ImageView",
                                                    "visibility": "{{mTitleMediaVsblty}}",
                                                    "mediaUrl": "{{mTitleMedia}}",
                                                    "scaleType": "fitXY",
                                                    "width": "24dp",
                                                    "height": "24dp"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "textSize": "19dp",
                                                    "textAlignment": "textStart",
                                                    "width": "match",
                                                    "textStyle": "bold",
                                                    "text": "{{mTitle}}",
                                                    "textColor": "#1e1e1e",
                                                    "height": "content"
                                                }
                                            ],
                                            "gravity": "bottom",
                                            "width": "match",
                                            "height": "content"
                                        },
                                        {
                                            "widget": "View",
                                            "background": "#1e1e1e",
                                            "width": "match",
                                            "marginTop": "6dp",
                                            "height": "2dp"
                                        }
                                    ],
                                    "paddingRight": "14dp",
                                    "width": "match",
                                    "paddingLeft": "14dp",
                                    "marginTop": "14dp",
                                    "height": "content"
                                },
                                {
                                    "orientation": "vertical",
                                    "widget": "LinearLayout",
                                    "children": [
                                        {
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "widget": "LinearLayout",
                                            "visibility": "{{descVsblty}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty}}",
                                                    "width": "match",
                                                    "marginBottom": "6dp",
                                                    "textStyle": "bold",
                                                    "text": "{{title}}",
                                                    "textColor": "#1e1e1e",
                                                    "height": "content"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "textSize": "15dp",
                                                    "width": "match",
                                                    "textStyle": "normal",
                                                    "text": "{{description}}",
                                                    "textColor": "#1e1e1e",
                                                    "viewAll": "150",
                                                    "height": "content"
                                                }
                                            ],
                                            "width": "match",
                                            "marginTop": "6dp",
                                            "height": "content"
                                        },
                                        {
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "widget": "LinearLayout",
                                            "children": [
                                                {
                                                    "orientation": "vertical",
                                                    "widget": "LinearLayout",
                                                    "children": [
                                                        {
                                                            "corner_radius": "8dp",
                                                            "widget": "Button",
                                                            "textSize": "15dp",
                                                            "visibility": "{{btnVsblty1}}",
                                                            "textColor": "#1e1e1e",
                                                            "click": {
                                                                "action": {
                                                                    "displayText": "dummy",
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    }
                                                                }
                                                            },
                                                            "background": "#E4E4E4",
                                                            "textAlignment": "center",
                                                            "width": "match",
                                                            "text": "{{btnName1}}",
                                                            "textStyle": "normal",
                                                            "marginTop": "8dp",
                                                            "height": "36dp"
                                                        },
                                                        {
                                                            "corner_radius": "8dp",
                                                            "widget": "Button",
                                                            "textSize": "15dp",
                                                            "visibility": "{{btnVsblty2}}",
                                                            "textColor": "#1e1e1e",
                                                            "click": {
                                                                "action": {
                                                                    "displayText": "dummy",
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    }
                                                                }
                                                            },
                                                            "background": "#E4E4E4",
                                                            "textAlignment": "center",
                                                            "width": "match",
                                                            "text": "{{btnName2}}",
                                                            "textStyle": "normal",
                                                            "marginTop": "8dp",
                                                            "height": "36dp"
                                                        }
                                                    ],
                                                    "width": "match",
                                                    "height": "content"
                                                }
                                            ],
                                            "width": "match",
                                            "height": "content"
                                        }
                                    ],
                                    "paddingRight": "10dp",
                                    "width": "match",
                                    "paddingLeft": "10dp",
                                    "height": "content"
                                },
                                {
                                    "orientation": "vertical",
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp"
                                }
                            ],
                            "background": "#F2F2F2",
                            "width": "match",
                            "height": "content"
                        },
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "card": "open_rich_card"
                    },
                    "trafficType": "advertisement"
                }
            },
            "registerId": "rd135",
            "registerDate": "2023-10-19 22:41:12",
            "updateDate": "2024-06-21 14:47:25",
            "status": "ready",
            "approvalResult": "승인",
            "cardType": "format",
            "headerComposition": [
                {
                    "componentId": "CP-MainTitle",
                    "index": 1
                }
            ],
            "bodyComposition": [
                {
                    "componentId": "CP-Description",
                    "index": 2
                },
                {
                    "componentId": "CP-VButton",
                    "index": 3
                }
            ],
            "footerComposition": []
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 레이아웃 구성 규칙 조회

## Request

## 메시지 상품별 레이아웃 구성 규칙을 조회합니다.<br>

> 메시지 상품별 레이아웃 구성 규칙을 조회합니다.  \
> 본 규칙에 부합해야만 레이아웃 등록/수정이 가능합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}}},"paths":{"/baselayout/product/rule":{"get":{"summary":"메시지 상품별 레이아웃 구성 규칙을 조회합니다.\n","description":"메시지 상품별 레이아웃 구성 규칙을 조회합니다.  \n본 규칙에 부합해야만 레이아웃 등록/수정이 가능합니다.  \n\n  + **계정 권한: 대행사**\n","responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>상품별 레이아웃 구성 규칙 정보</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="210">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>productCode</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td><p>레이아웃 사용이 가능한 메시지 상품 코드 입니다.</p><ul><li>sms</li><li>lms</li><li>mms</li></ul></td></tr><tr><td><strong><code>componentCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 정의 시 지정 가능한 최대 컴포넌트 개수 입니다.</td></tr><tr><td><strong><code>componentMinCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 정의 시 필요한 최소 컴포넌트 개수 입니다.</td></tr><tr><td><strong><code>buttonCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 정의 시 지정 가능한 버튼 컴포넌트 개수 입니다.</td></tr><tr><td><a href="#componentlimit-object"><mark style="color:blue;"><strong><code>componentLimit</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>현재 제공되는 컴포넌트 그룹ID 별 레이아웃 내 설정 가능한 컴포넌트 그룹의 지정 가능 개수를 표시합니다.</td></tr></tbody></table>

### <mark style="color:blue;">componentLimit</mark> - object

<table data-full-width="true"><thead><tr><th width="210">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>ImageGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지를  표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>TitleGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>제목을 표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>BannerGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>배너형태의 이미지를 표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>DescriptionGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>일반적인 내용을 표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>ItemGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>작은 아이콘형태 이미지와 소제목을 표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>ThumbDescGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>작은 이미지와 설명을 표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>TableGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>표 형식으로 내용을 표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>ThumbnailGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>작은 아이콘형태 이미지와 소제목을 표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>NoticeGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>특정 용도의 내용을 표시할 수 있는 컴포넌트 그룹입니다.</td></tr><tr><td><strong><code>ButtonGroup</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼을 표시할 수 있는 컴포넌트 그룹입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "productCode": "sms",
            "componentMinCount": 1,
            "componentCount": 2,
            "buttonCount": 1,
            "componentLimit": {
                "ItemGroup": 1,
                "TableGroup": 1,
                "ButtonGroup": 1,
                "DescriptionGroup": 1,
                "TitleGroup": 1
            }
        },
        {
            "productCode": "lms",
            "componentMinCount": 1,
            "componentCount": 6,
            "buttonCount": 3,
            "componentLimit": {
                "ItemGroup": 1,
                "NoticeGroup": 1,
                "TableGroup": 2,
                "ButtonGroup": 3,
                "DescriptionGroup": 3,
                "TitleGroup": 1
            }
        },
        {
            "productCode": "mms",
            "componentMinCount": 1,
            "componentCount": 6,
            "buttonCount": 3,
            "componentLimit": {
                "ItemGroup": 1,
                "NoticeGroup": 1,
                "TableGroup": 1,
                "ThumbnailGroup": 1,
                "ButtonGroup": 3,
                "ThumbDescGroup": 1,
                "DescriptionGroup": 1,
                "ImageGroup": 1,
                "TitleGroup": 1,
                "BannerGroup": 1
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 레이아웃 목록 조회

## Request

## 브랜드 별 등록된 레이아웃 목록을 조회합니다.<br>

> 브랜드 별 등록된 레이아웃 목록을 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/brand/{brandId}/layout":{"get":{"summary":"브랜드 별 등록된 레이아웃 목록을 조회합니다.\n","description":"브랜드 별 등록된 레이아웃 목록을 조회합니다.  \n\n  + **계정 권한: 대행사**  \n  + **브랜드 권한: 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>레이아웃 기본 정보 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><strong><code>pagination</code></strong></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><strong><code>links</code></strong></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="201">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>layoutId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>레이아웃 ID 입니다.</td></tr><tr><td><strong><code>layoutName</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>레이아웃 이름 입니다.</td></tr><tr><td><strong><code>productCode</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td><p>레이아웃의 메시지 상품 코드 입니다.</p><ul><li>sms</li><li>lms</li><li>mms</li></ul></td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃의 상태를 표시합니다.</p><ul><li>ready : 사용</li><li>pause : 사용중지</li></ul></td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>등록자 ID 입니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 입니다.</td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃 등록 상태입니다. 레이아웃은 운영자 검수 없이 자동 등록됩니다.</p><ul><li>승인 : 이통3사에 정상 등록된 상태입니다.</li><li>저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다.</li><li>검수완료 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.</li></ul></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "layoutId": "CLMBR.0a81DDlZjz-11GLm0hv4RX9zJB82D9r",
            "layoutName": "MMS_2024x06x26x10x11x22",
            "productCode": "mms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "leekmdevagency",
            "registerDate": "2024-07-03 10:44:51",
            "updateDate": "2024-07-03 10:44:51"
        },
        {
            "layoutId": "CLSBR.0a81DDlZjz-3WQxe43IgX1tnJnyqV04",
            "layoutName": "SMS_2024x06x26x10x11x22",
            "productCode": "sms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "leekmdevagency",
            "registerDate": "2024-07-03 10:35:04",
            "updateDate": "2024-07-03 10:35:04"
        },
        {
            "layoutId": "CLLBR.0a81DDlZjz-9OYjpEElL0HDIB079ac1",
            "layoutName": "2024x06x26x10x11x22",
            "productCode": "lms",
            "status": "ready",
            "approvalResult": "승인",
            "registerId": "leekmdevagency",
            "registerDate": "2024-07-03 10:20:10",
            "updateDate": "2024-07-03 10:20:11"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 3
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 레이아웃 상세 조회

## Request

## 브랜드 별 등록된 레이아웃 상세 내용을 조회합니다.<br>

> 브랜드 별 등록된 레이아웃 상세 내용을 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"LayoutId":{"name":"layoutId","in":"path","schema":{"type":"string"},"description":"레이아웃ID 입니다.","required":true}}},"paths":{"/brand/{brandId}/layout/{layoutId}":{"get":{"summary":"브랜드 별 등록된 레이아웃 상세 내용을 조회합니다.\n","description":"브랜드 별 등록된 레이아웃 상세 내용을 조회합니다.  \n\n  + **계정 권한: 대행사**  \n  + **브랜드 권한: 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/LayoutId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>레이아웃 상세 정보 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="205">필드명</th><th width="137">타입</th><th width="70" align="center">길이</th><th width="96" align="center">필수여부</th><th width="139">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>layoutId</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>샘플 레이아웃 상세 정보 입니다.</td></tr><tr><td><strong><code>layoutName</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>샘플 레이아웃 이름 입니다.</td></tr><tr><td><strong><code>productCode</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>샘플 레이아웃의 메시지 상품 코드 입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>샘플 레이아웃의 상태를 표시합니다.</p><ul><li>ready : 사용</li><li>pause : 사용중지</li></ul></td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>등록자 ID 입니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 입니다.</td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>레이아웃 등록 상태입니다. 레이아웃은 운영자 검수 없이 자동 등록됩니다.</p><ul><li>등록완료 : 이통3사에 정상 등록된 상태입니다.</li><li>저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다.</li><li>처리중 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.</li></ul></td></tr><tr><td><strong><code>spec</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>openrichcard</td><td>레이아웃 구조가 리치카드인지 오픈리치카드인지 구분합니다. 샘플 레이아웃은 오픈리치카드로 구성되어 있습니다.</td></tr><tr><td><strong><code>cardType</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td><p>카드 종류를 구분합니다.<br>레이아웃에 표시되는 카드 타입은 다음 두 가지로 제한됩니다.</p><ul><li>format : 이통사 제공 공통포맷의 카드 타입입니다.</li><li>formatBr : 사용자가 등록한 레이아웃의 카드 타입입니다.</li></ul></td></tr><tr><td><strong><code>buttonColor</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>버튼에 지정된 컬러 값을 표시합니다. 지정된 경우 컬러 Hex 값(예,'#FFFFFF')이 표시되며, 미지정 시 빈값 입니다.</td></tr><tr><td><a href="#headercomposition-bodycomposition-footercomposition-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>headerComposition</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>카드 내의 최상위 영역으로 1개의 컴포넌트를 지정할 수 있습니다. 컴포넌트 중 headerYn = 'Y' 인 컴포넌트만 등록이 가능합니다.</td></tr><tr><td><a href="#headercomposition-bodycomposition-footercomposition-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>bodyComposition</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td><p>카드 내의 중간 영역으로 메시지 상품에서 지정한 개수의 컴포넌트를 지정할 수 있습니다.<br>컴포넌트 중 bodyYn = 'Y' 인 컴포넌트만 등록이 가능합니다.<br>예를 들어 LMS는 최대 6개의 컴포넌트를 지정할 수 있으며, 최대 개수 범위 내에서 각 영역별 배분할 수 있습니다.</p><ul><li>Header 1개 지정 시 body 최대 5개</li><li>body만 지정 시 최대 6개</li></ul></td></tr><tr><td><a href="#headercomposition-bodycomposition-footercomposition-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>footerComposition</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>카드 내의 최상위 영역으로 1개의 컴포넌트를 지정할 수 있습니다. 컴포넌트 중 footerYn = 'Y' 인 컴포넌트만 등록이 가능합니다. 현재는 footer에 사용자가 직접 지정하는 컴포넌트는 없습니다.</td></tr><tr><td><strong><code>formattedString</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>샘플 레이아웃을 구성한 openrichcard 메시지 구조 정보 입니다. 레이아웃 등록/수정 시에는 컴포넌트를 활용하므로 formattedString 은 참조 데이터로 제공됩니다.</td></tr><tr><td><a href="#params-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>params</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>템플릿의 개별 파라미터를 검수하기 위한 대상 파라미터 정보 객체입니다. 크기 관련 필드는 &#x3C;=0 인 경우 체크하지 않습니다.</td></tr><tr><td><a href="#guideinfo-object"><mark style="color:blue;"><strong><code>guideInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 작성에 필요한 가이드 정보를 제공하기 위하여 양식 정의 시 포함되는 정보입니다. 리치카드의 경우 messagebaseInfo에서 제공됩니다.</td></tr><tr><td><a href="#policyinfo"><mark style="color:blue;"><strong><code>policyInfo</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>리치카드, 오픈리치카드에 포함된 content(title, description, media, button) 에 대한 검증 정책 저장을 위한 객체입니다.</td></tr></tbody></table>

{% hint style="info" %}
GSMA RCC.07-v11.0 참조\
<https://www.gsma.com/solutions-and-impact/technologies/networks/wp-content/uploads/2019/10/RCC.07-v11.0.pdf>
{% endhint %}

{% hint style="info" %}
TTAK.KO-06.0410/R7 참조

<https://committee.tta.or.kr/data/standard_view.jsp?secondDepthCode=PG1105&firstDepthCode=TC011&pk_num=TTAK.KO-06.0410/R7&commit_code=PG1105>
{% endhint %}

### <mark style="color:blue;">headerComposition, bodyComposition, footerComposition</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>index</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 내 컴포넌트의 순번을 표시합니다. 등록 시에는 index를 지정하지 않으며, 배열 내 순서를 기준으로 처리됩니다.</td></tr><tr><td><strong><code>componentId</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>지정할 컴포넌트 ID 입니다.</td></tr><tr><td><a href="#options-object-1"><mark style="color:blue;"><strong>options</strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 사용 시 컴포넌트에 적용될 수 있는 옵션입니다. 옵션 지정이 가능한 경우 표기됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">options</mark> - object(0)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="74" align="center">길이</th><th width="108" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>leftAlign</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>left</td><td><p>좌측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.</p><ul><li>left : 좌측 정렬</li><li>right : 우측 정렬</li><li>center : 중앙 정렬</li></ul></td></tr><tr><td><strong><code>rightAlign</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>right</td><td><p>우측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.</p><ul><li>left : 좌측 정렬</li><li>right : 우측 정렬</li><li>center : 중앙 정렬</li></ul></td></tr><tr><td><strong><code>leftTextStyle</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>normal</td><td><p>좌측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.</p><ul><li>normal : 기본 스타일</li><li>bold : bold 스타일 적용</li></ul></td></tr><tr><td><strong><code>rightTextStyle</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>normal</td><td><p>우측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.</p><ul><li>normal : 기본 스타일</li><li>bold : bold 스타일 적용</li></ul></td></tr><tr><td><strong><code>maxCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>5</td><td><p>테이블의 행 개수를 지정합니다. 정의된 숫자 이외에는 지정할 수 없습니다.</p><ul><li>5 : 5행</li><li>10 : 10행</li></ul></td></tr></tbody></table>

{% hint style="info" %}
Table / StyleTable등 테이블 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### <mark style="color:blue;">options</mark> - object(1)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>color</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>버튼의 색상 설정 옵션입니다. 버튼의 색상은 브랜드 정보에서 지정한 templateColor 컬러 Hex 값과 동일해야 합니다. 빈값 지정 시 기본 버튼 컬러로 적용되며, 지정된 컬러 Hex 값이 templateColor의 값과 다르면 templateColor로 강제 설정됩니다.</td></tr></tbody></table>

{% hint style="info" %}
VButton / HButton 등 버튼 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### <mark style="color:blue;">options</mark> - object(2)

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>ctlrViewAll</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>true</td><td><p></p><p>컴포넌트 단위의 viewAll(모두보기) 활성화 여부를  지정합니다.</p><ul><li>true: 컴포넌트 viewAll(모두보기) 활성화</li><li>false: 컴포넌트 viewAll(모두보기) 비활성화</li></ul></td></tr><tr><td>viewAll</td><td>integer</td><td align="center"></td><td align="center"></td><td>150</td><td>viewAll(모두보기) 접힘 글자수 기준값을 지정합니다.
<br>유효값: 150(default), 300
<br>유효값 이외 수치가 입력되는 경우 defualt로 처리됩니다.</td></tr></tbody></table>

{% hint style="info" %}
viewAll(모두보기) 설정을 포함하는 컴포넌트의 옵션 정보 객체 입니다.
{% endhint %}

### <mark style="color:blue;">params</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="170">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>param</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>검수 파라미터명. (영문, 한글, 숫자, '_' 만 사용)</td></tr><tr><td><strong><code>isMandatory</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td>필수여부. true인 경우 중계사에서 메시지 전송 요청 시 해당 필드가 없는 경우 MaaP FE에서 실패처리한다. false인 경우는 해당 필드가 없는 경우도 메시지 전송이 되도록 MaaP FE에서 적절하게 처리한다.</td></tr><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>기술검사타입을 지정합니다.</p><ul><li>string: 문자열 검사 대상</li><li>file: 파일 검사 대상</li><li>button: formattedString 내 button 제어 대상</li><li>layout: formattedString 내 button외 제어 대상</li></ul></td></tr><tr><td><strong><code>contentType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>컨텐츠 유형, PolicyInfo 정책을 검사하는데 사용됩니다.</p><ul><li>"title"</li><li>"description"</li><li>"maapfile"</li><li>"cell"</li><li>"displayText"</li><li>"url"</li><li>"etc"</li><li>"buttonName"</li><li>"visibility"</li></ul></td></tr><tr><td><strong><code>strSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>글자 최대 크기, type이 string인 경우</td></tr><tr><td><strong><code>fileSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>파일 최대 크기, type이 file인 경우.</td></tr><tr><td><strong><code>strRegx</code></strong></td><td>string</td><td align="center"></td><td align="center">65535</td><td></td><td><p>java regular expression, null 인경우 사용하지 않음. 예)</p><ol><li>숫자만 : '^[0-9]*$'</li><li>영문자만 : '[a-zA-Z]*$'</li><li>한글만 : '^[가-힣]*$'</li><li>영어 &#x26; 숫자만 : '^[a-zA-Z0-9]*$'</li><li>E-Mail : '^[a-zA-Z0-9]+@[a-zA-Z0-9]+$'</li><li>휴대폰 : '^01(?:0|1|[6-9])-(?:\d{3}|\d{4})-\d{4}$'</li><li>일반전화 : '^\d{2,3}-\d{3,4}-\d{4}$'</li><li>주민등록번호 : '\d{6}-[1-4]\d{6}'</li><li>IP 주소 : '([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3})'</li></ol></td></tr><tr><td><strong><code>verification</code></strong></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td>문장 패턴 정의 (SKT향) "안녕하세요", "님 ", "원입니다."</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 해상도 가로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 해상도 세로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)</td></tr><tr><td><strong><code>couplingId</code></strong></td><td>string</td><td align="center"></td><td align="center">20</td><td></td><td>파라미터 간 함께 처리되어야 하는 경우 동일한 값을 부여 즉, 같은 값의 couplingId가 지정되는 경우 지정된 파라미터는 모두 조건을 만족해야 정상 발송 처리됨</td></tr><tr><td><strong><code>inputText</code></strong></td><td>string</td><td align="center"></td><td align="center">65535</td><td></td><td>템플릿 등록시 사용자 입력한 원본 문장(고정부 &#x26; 변수부)을 제공합니다. 단, cell방식의 타이틀 선택형은 제공되지 않습니다.</td></tr><tr><td><strong><code>relationId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>param과 관계가 있는 param을 의미합니다. 주로 현재 param이 입력되지 않을 경우 메시지 상에 노출여부와 연관된 visibility에 지정된 param을 표시합니다. 메시지 발송시 이통MaaP FE에서 핸들링하는 것으로 템플릿 등록이나 메시지 발송 param과는 무관하며, 참조 용도로 제공됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">guideInfo</mark> - object

<table data-full-width="true"><thead><tr><th width="199">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>maxLineCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>max 라인수</td></tr><tr><td><strong><code>maxDisplayText</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼명 글자수</td></tr><tr><td><strong><code>maxDescriptionSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>카드별 max 본문 글자수</td></tr><tr><td><strong><code>imageWidth</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 권고 가로 사이즈 단위는 Pixel</td></tr><tr><td><strong><code>imageHeight</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>이미지 권고 세로 사이즈 단위는 Pixel</td></tr><tr><td><strong><code>detailInfo</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>리치카드 메시지 상품별 1라인당 글자수, 타이틀 라인수 및 버튼 수에 따라 메시지가 잘려 보이지 않는 최대 라인수 정보를 제공합니다. 메시지가 수신된 단말에 따라 상이할 수 있으나 리치카드 RCS메시지 발송 시 권장사항으로 참고하시기 바랍니다. LMS와 MMS 12종 총 13종에 대해 개별 제공됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">policyInfo</mark>

<table data-full-width="true"><thead><tr><th width="199">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonsAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>MaaP FE /message의 buttons 사용 유무 true : buttons 필드 사용 false : buttons 에 값이 들어오면 실패 처리</td></tr><tr><td><strong><code>adHeaderAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>header에 광고 인입 허가 여부 true : 광고인입 허용(MaaP FE /message의 header 체크안함) false : 광고인입 불허(MaaP FE /message이 header가 1(광고) 이면 실패 처리)</td></tr><tr><td><strong><code>adBodyAllowed</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>광고 문구 허용 여부 true : 본문 광고 문구를 체크하지 않음 false : 본문이 "(광고)"로 시작하면 실패 처리</td></tr><tr><td><strong><code>cardCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>카드 개수</td></tr><tr><td><strong><code>maxTitleSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>개별 타이틀 글자 최대 수. 사용하지 않음.</td></tr><tr><td><strong><code>maxButtonCount</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>버튼 최대 개수</td></tr><tr><td><strong><code>maxDescriptionSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>RichCard인 경우(Carousel포함) Description들의 글자수 총합. OpenRichCard인 경우 변수부 글자수 총합. &#x3C;=0 인 경우 사용하지 않음.</td></tr><tr><td><strong><code>maxMediaSize</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>Byte단위 미디어 크기 총합의 최대 크기, &#x3C;=0 인 경우 사용하지 않음.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "layoutId": "CLLBR.0a81DDlZjz-9OYjpEElL0HDIB079ac1",
            "layoutName": "2024x06x26x10x11x22",
            "productCode": "lms",
            "sampleLayoutId": null,
            "spec": "openrichcard",
            "buttonColor": null,
            "formattedString": {
                "RCSMessage": {
                    "openrichcardMessage": {
                        "scaleAllowed": true,
                        "layout": {
                            "orientation": "vertical",
                            "widget": "LinearLayout",
                            "children": [
                                {
                                    "orientation": "vertical",
                                    "widget": "LinearLayout",
                                    "visibility": "{{mTitleVsblty}}",
                                    "children": [
                                        {
                                            "orientation": "horizontal",
                                            "widget": "LinearLayout",
                                            "children": [
                                                {
                                                    "corner_radius": "4dp",
                                                    "marginRight": "4dp",
                                                    "widget": "ImageView",
                                                    "visibility": "{{mTitleMediaVsblty}}",
                                                    "mediaUrl": "{{mTitleMedia}}",
                                                    "scaleType": "fitXY",
                                                    "width": "24dp",
                                                    "height": "24dp"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "textSize": "19dp",
                                                    "textAlignment": "textStart",
                                                    "width": "match",
                                                    "textStyle": "bold",
                                                    "text": "{{mTitle}}",
                                                    "textColor": "#1e1e1e",
                                                    "height": "content"
                                                }
                                            ],
                                            "gravity": "bottom",
                                            "width": "match",
                                            "height": "content"
                                        },
                                        {
                                            "widget": "View",
                                            "background": "#1e1e1e",
                                            "width": "match",
                                            "marginTop": "6dp",
                                            "height": "2dp"
                                        }
                                    ],
                                    "paddingRight": "14dp",
                                    "width": "match",
                                    "paddingLeft": "14dp",
                                    "marginTop": "14dp",
                                    "height": "content"
                                },
                                {
                                    "orientation": "vertical",
                                    "widget": "LinearLayout",
                                    "children": [
                                        {
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "widget": "LinearLayout",
                                            "visibility": "{{descVsblty1}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty1}}",
                                                    "width": "match",
                                                    "marginBottom": "6dp",
                                                    "textStyle": "bold",
                                                    "text": "{{title1}}",
                                                    "textColor": "#1e1e1e",
                                                    "height": "content"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "textSize": "15dp",
                                                    "width": "match",
                                                    "textStyle": "normal",
                                                    "text": "{{description1}}",
                                                    "textColor": "#1e1e1e",
                                                    "viewAll": "100",
                                                    "height": "content"
                                                }
                                            ],
                                            "width": "match",
                                            "marginTop": "6dp",
                                            "height": "content"
                                        },
                                        {
                                            "padding": "4dp",
                                            "orientation": "horizontal",
                                            "widget": "LinearLayout",
                                            "children": [
                                                {
                                                    "corner_radius": "8dp",
                                                    "widget": "Button",
                                                    "textSize": "15dp",
                                                    "visibility": "{{btnVsblty1}}",
                                                    "weight": 1,
                                                    "textColor": "#1e1e1e",
                                                    "click": {
                                                        "action": {
                                                            "displayText": "dummy",
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            }
                                                        }
                                                    },
                                                    "background": "#E4E4E4",
                                                    "textAlignment": "center",
                                                    "width": "content",
                                                    "text": "{{btnName1}}",
                                                    "textStyle": "normal",
                                                    "height": "36dp"
                                                },
                                                {
                                                    "corner_radius": "8dp",
                                                    "widget": "Button",
                                                    "textSize": "15dp",
                                                    "visibility": "{{btnVsblty2}}",
                                                    "weight": 1,
                                                    "textColor": "#1e1e1e",
                                                    "click": {
                                                        "action": {
                                                            "displayText": "dummy",
                                                            "urlAction": {
                                                                "openUrl": {
                                                                    "url": ""
                                                                }
                                                            }
                                                        }
                                                    },
                                                    "marginLeft": "8dp",
                                                    "background": "#E4E4E4",
                                                    "textAlignment": "center",
                                                    "width": "content",
                                                    "text": "{{btnName2}}",
                                                    "textStyle": "normal",
                                                    "height": "36dp"
                                                }
                                            ],
                                            "width": "match",
                                            "marginTop": "8dp",
                                            "height": "content"
                                        },
                                        {
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "widget": "LinearLayout",
                                            "visibility": "{{descVsblty2}}",
                                            "children": [
                                                {
                                                    "widget": "TextView",
                                                    "textSize": "17dp",
                                                    "visibility": "{{descTitleVsblty2}}",
                                                    "width": "match",
                                                    "marginBottom": "6dp",
                                                    "textStyle": "bold",
                                                    "text": "{{title2}}",
                                                    "textColor": "#1e1e1e",
                                                    "height": "content"
                                                },
                                                {
                                                    "widget": "TextView",
                                                    "textSize": "15dp",
                                                    "width": "match",
                                                    "textStyle": "normal",
                                                    "text": "{{description2}}",
                                                    "textColor": "#1e1e1e",
                                                    "viewAll": "100",
                                                    "height": "content"
                                                }
                                            ],
                                            "width": "match",
                                            "marginTop": "6dp",
                                            "height": "content"
                                        },
                                        {
                                            "padding": "4dp",
                                            "orientation": "vertical",
                                            "widget": "LinearLayout",
                                            "children": [
                                                {
                                                    "orientation": "vertical",
                                                    "widget": "LinearLayout",
                                                    "children": [
                                                        {
                                                            "corner_radius": "8dp",
                                                            "widget": "Button",
                                                            "textSize": "15dp",
                                                            "visibility": "{{btnVsblty3}}",
                                                            "textColor": "#1e1e1e",
                                                            "click": {
                                                                "action": {
                                                                    "displayText": "dummy",
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    }
                                                                }
                                                            },
                                                            "background": "#E4E4E4",
                                                            "textAlignment": "center",
                                                            "width": "match",
                                                            "text": "{{btnName3}}",
                                                            "textStyle": "normal",
                                                            "marginTop": "8dp",
                                                            "height": "36dp"
                                                        },
                                                        {
                                                            "corner_radius": "8dp",
                                                            "widget": "Button",
                                                            "textSize": "15dp",
                                                            "visibility": "{{btnVsblty4}}",
                                                            "textColor": "#1e1e1e",
                                                            "click": {
                                                                "action": {
                                                                    "displayText": "dummy",
                                                                    "urlAction": {
                                                                        "openUrl": {
                                                                            "url": ""
                                                                        }
                                                                    }
                                                                }
                                                            },
                                                            "background": "#E4E4E4",
                                                            "textAlignment": "center",
                                                            "width": "match",
                                                            "text": "{{btnName4}}",
                                                            "textStyle": "normal",
                                                            "marginTop": "8dp",
                                                            "height": "36dp"
                                                        }
                                                    ],
                                                    "width": "match",
                                                    "height": "content"
                                                }
                                            ],
                                            "width": "match",
                                            "height": "content"
                                        }
                                    ],
                                    "paddingRight": "10dp",
                                    "width": "match",
                                    "paddingLeft": "10dp",
                                    "height": "content"
                                },
                                {
                                    "orientation": "vertical",
                                    "widget": "LinearLayout",
                                    "width": "match",
                                    "height": "10dp"
                                }
                            ],
                            "background": "#F2F2F2",
                            "width": "match",
                            "height": "content"
                        },
                        "version": "1.0.0",
                        "zoomAllowed": true,
                        "card": "open_rich_card"
                    },
                    "trafficType": "advertisement"
                }
            },
            "registerId": "leekmdevagency",
            "registerDate": "2024-07-03 10:20:10",
            "updateDate": "2024-07-03 10:20:11",
            "status": "ready",
            "approvalResult": "승인",
            "cardType": "formatBr",
            "headerComposition": [
                {
                    "componentId": "CP-MainTitle",
                    "index": 1
                }
            ],
            "bodyComposition": [
                {
                    "componentId": "CP-Description",
                    "index": 2
                },
                {
                    "componentId": "CP-HButton",
                    "index": 3
                },
                {
                    "componentId": "CP-Description",
                    "index": 4
                },
                {
                    "componentId": "CP-VButton",
                    "index": 5
                }
            ],
            "footerComposition": [],
            "params": [
                {
                    "param": "btnName1",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "buttonName",
                    "strSize": 7,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "btnVsblty1"
                },
                {
                    "param": "btnName2",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "buttonName",
                    "strSize": 7,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "btnVsblty2"
                },
                {
                    "param": "btnName3",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "buttonName",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "btnVsblty3"
                },
                {
                    "param": "btnName4",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "buttonName",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "btnVsblty4"
                },
                {
                    "param": "btnVsblty1",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "btnVsblty2",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "btnVsblty3",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "btnVsblty4",
                    "isMandatory": false,
                    "type": "button",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "description1",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty1"
                },
                {
                    "param": "description2",
                    "isMandatory": true,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 1300,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descVsblty2"
                },
                {
                    "param": "descTitleVsblty1",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "descTitleVsblty2",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "descVsblty1",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "descVsblty2",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mTitle",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "title",
                    "strSize": 17,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleVsblty"
                },
                {
                    "param": "mTitleMedia",
                    "isMandatory": false,
                    "type": "file",
                    "contentType": "maapfile",
                    "strSize": -1,
                    "fileSize": 1048576,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": 300,
                    "imageHeight": 300,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "mTitleMediaVsblty"
                },
                {
                    "param": "mTitleMediaVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "mTitleVsblty",
                    "isMandatory": false,
                    "type": "layout",
                    "contentType": "visibility",
                    "strSize": -1,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": null
                },
                {
                    "param": "title1",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty1"
                },
                {
                    "param": "title2",
                    "isMandatory": false,
                    "type": "string",
                    "contentType": "description",
                    "strSize": 30,
                    "fileSize": null,
                    "strRegx": null,
                    "verification": null,
                    "imageWidth": null,
                    "imageHeight": null,
                    "couplingId": null,
                    "inputText": null,
                    "relationId": "descTitleVsblty2"
                }
            ],
            "policyInfo": {
                "cardCount": 1,
                "maxTitleSize": 30,
                "maxButtonCount": 4,
                "maxDescriptionSize": 1300,
                "maxMediaSize": 0,
                "buttonsAllowed": true,
                "adHeaderAllowed": true,
                "adBodyAllowed": true
            },
            "guideInfo": {
                "maxLineCount": 0,
                "maxDisplayText": 17,
                "maxDescriptionSize": 1300,
                "imageWidth": "0",
                "imageHeight": "0",
                "detailInfo": null
            }
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 레이아웃 등록

## Request

## 브랜드 내에서 사용할 수 있는 레이아웃을 등록 합니다.  <br>

> 브랜드 내에서 사용할 수 있는 레이아웃을 등록 합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegBrandLayout":{"type":"object","description":"레이아웃 등록 객체 정보 입니다.\n","properties":{"layoutName":{"type":"string","description":"maxLength: 40 - 레이아웃 이름을 지정합니다.\n","maxLength":40},"productCode":{"type":"string","description":"maxLength: 20 - 레이아웃의 메시지 상품 코드 입니다.\n","maxLength":20,"enum":["sms","lms","mms"]},"sampleLayoutId":{"type":"string","description":"maxLength: 40 - 샘플 레이아웃 ID 입니다.\n샘플 레이아웃을 이용하여 부분적으로 컴포넌트 변경하여 등록하는 경우 설정합니다.\n","maxLength":40},"headerComposition":{"type":"array","description":"카드 내의 최상위 영역으로 1개의 컴포넌트를 지정할 수 있습니다.  \n컴포넌트 중 headerYn = 'Y' 인 컴포넌트만 등록이 가능합니다.  \n컴포넌트를 지정하지 않을 경우 빈 배열로 등록 합니다.  \n","items":{"$ref":"#/components/schemas/LayoutComponent"}},"bodyComposition":{"type":"array","description":"카드 내의 중간 영역으로 메시지 상품에서 지정한 개수의 컴포넌트를 지정할 수 있습니다.  \n\n컴포넌트 중 bodyYn = 'Y' 인 컴포넌트만 등록이 가능합니다.  \n\n예를 들어 LMS는 최대 6개의 컴포넌트를 지정할 수 있으며, 최대 개수 범위 내에서 각 영역별 배분할 수 있습니다.     \n  \n  + Header 1개 지정 시 body 최대 5개  \n  + body만 지정 시 최대 6개\n","items":{"$ref":"#/components/schemas/LayoutComponent"}},"footerComposition":{"type":"array","description":"카드 내의 최하단 영역으로 1개의 컴포넌트를 지정할 수 있습니다.  \n\n컴포넌트 중 footerYn = 'Y' 인 컴포넌트만 등록이 가능합니다.  \n\n컴포넌트를 지정하지 않을 경우 빈 배열로 등록 합니다.  \n\n현재는 footer에 사용자가 직접 지정하는 컴포넌트는 없습니다.\n","items":{"$ref":"#/components/schemas/LayoutComponent"}}},"required":["layoutName","productCode","headerComposition","bodyComposition","footerComposition"]},"LayoutComponent":{"description":"레이아웃 내 사용되는 컴포넌트 객체입니다.","type":"object","properties":{"index":{"type":"integer","description":"레이아웃 내 컴포넌트의 순번을 표시합니다.  \n등록 시에는 index를 지정하지 않으며, 배열 내 순서를 기준으로 처리됩니다.  \n"},"componentId":{"type":"string","description":"maxLength: 40 - 지정할 컴포넌트 ID 입니다.\n","maxLength":40},"options":{"type":"object","description":"레이아웃 사용 시 컴포넌트에 적용될 수 있는 옵션입니다.   옵션 지정이 가능한 경우 표기됩니다.\n","oneOf":[{"$ref":"#/components/schemas/TableOption"},{"$ref":"#/components/schemas/ButtonOption"},{"$ref":"#/components/schemas/ViewAllOption"}]}},"required":["componentId"]},"TableOption":{"type":"object","description":"Table / StyleTable등 테이블 컴포넌트의 옵션 정보 객체 입니다.  \n","properties":{"leftAlign":{"type":"string","description":"좌측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.  \n\n  + left : 좌측 정렬  \n  + right : 우측 정렬  \n  + center : 중앙 정렬\n","enum":["left","right","center"],"default":"left"},"rightAlign":{"type":"string","description":"우측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.  \n\n  + left : 좌측 정렬  \n  + right : 우측 정렬  \n  + center : 중앙 정렬\n","enum":["left","right","center"],"default":"right"},"leftTextStyle":{"type":"string","description":"좌측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.  \n\n  + normal : 기본 스타일\n  + bold : bold 스타일 적용\n","enum":["normal","bold"],"default":"normal"},"rightTextStyle":{"type":"string","description":"우측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.  \n\n  + normal : 기본 스타일\n  + bold : bold 스타일 적용\n","enum":["normal","bold"],"default":"normal"},"maxCount":{"type":"integer","description":"테이블의 행 개수를 지정합니다. 정의된 숫자 이외에는 지정할 수 없습니다.  \n\n  + 5 : 5행\n  + 10 : 10행\n","enum":[5,10],"default":5}}},"ButtonOption":{"type":"object","description":"VButton / HButton 등 버튼 컴포넌트의 옵션 정보 객체 입니다.  \n","properties":{"color":{"type":"string","description":"버튼의 색상 설정 옵션입니다.  \n\n버튼의 색상은 브랜드 정보에서 지정한 templateColor 컬러 Hex 값과 동일해야 합니다.  \n\n빈값 지정 시 기본 버튼 컬러로 적용되며, 지정된 컬러 Hex 값이 templateColor의 값과 다르면 templateColor로 강제 설정됩니다.  \n"}}},"ViewAllOption":{"type":"object","description":"모두보기(viewAll) 옵션 정보 객체 입니다. \n\n컴포넌트 조회 시 options 상에 해당 옵션 설정이 포함되어 있을 때만 유효합니다. \n","properties":{"ctrlViewAll":{"type":"boolean","default":true,"description":"컴포넌트 단위의 viewAll(모두보기) 활성화 여부를 지정합니다. \n\n* true: 컴포넌트 viewAll(모두보기) 활성화 \n* false: 컴포넌트 viewAll(모두보기) 비활성화\n\n> ※ viewAll은 메시지 내 문자열이 표시되는 영역에 설정된 글자수 이상이 입력된 경우, 대상 영역을 '모두보기 >' 표시와 함께 접힌 상태로 표시하는 메시지 규격입니다. \n"},"viewAll":{"type":"integer","default":150,"description":"viewAll(모두보기) 접힘 글자수 기준값을 지정합니다. \n\n* 유효값: 150(default), 300\n* 유효값 이외 수치가 입력되는 경우 defualt로 처리됩니다.\n"}}}}},"paths":{"/brand/{brandId}/layout":{"post":{"summary":"브랜드 내에서 사용할 수 있는 레이아웃을 등록 합니다.  \n","description":"브랜드 내에서 사용할 수 있는 레이아웃을 등록 합니다.  \n\n  + **계정 권한: 대행사**  \n  + **브랜드 권한: 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegBrandLayout"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="SMS" %}

```
{
    "layoutName": "SMS_{{YYYYMMDDHHmmss}}",
    "productCode": "sms,
    "headerComposition": [
        {
            "index": 0,
            "componentId": "CP-MainTitle",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        }
    ],
    "bodyComposition": [
        {
            "index": 1,
            "componentId": "CP-Description",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        }        
    ],
    "footerComposition": []
}
```

{% endtab %}

{% tab title="LMS" %}

```
{
    "layoutName": "LMS_{{YYYYMMDDHHmmss}}",
    "productCode": "lms",
    "headerComposition": [
        {
            "index": 0,
            "componentId": "CP-MainTitle",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        }
    ],
    "bodyComposition": [
        {
            "index": 1,
            "componentId": "CP-Description",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-HButton",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-Description",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-VButton",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 1
            }
        }
    ],
    "footerComposition": []
}
```

{% endtab %}

{% tab title="MMS" %}

```
{
    "layoutName": "MMS_{{YYYYMMDDHHmmss}}",
    "productCode": "mms",
    "headerComposition": [
        {
            "index": 0,
            "componentId": "CP-ImageSquare"
        }
    ],
    "bodyComposition": [
        {
            "index": 1,
            "componentId": "CP-Description",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-ItemA",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-HButton",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        }        
    ],
    "footerComposition": []
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>레이아웃 ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>layoutId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>등록된 레이아웃 ID(= messagebaseId) 입니다.</p><p>레이아웃 ID는 RCS 발송에 사용하는 messagebaseId 로 사용됩니다.</p></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "layoutId": "CLMBR.0a81DDlZjz-11GLm0hv4RX9zJB82D9r"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 레이아웃 수정

## Request

## 브랜드 내 레이아웃을 수정 합니다.  <br>

> 브랜드 내 레이아웃을 수정 합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"LayoutId":{"name":"layoutId","in":"path","schema":{"type":"string"},"description":"레이아웃ID 입니다.","required":true}},"schemas":{"RegBrandLayout":{"type":"object","description":"레이아웃 등록 객체 정보 입니다.\n","properties":{"layoutName":{"type":"string","description":"maxLength: 40 - 레이아웃 이름을 지정합니다.\n","maxLength":40},"productCode":{"type":"string","description":"maxLength: 20 - 레이아웃의 메시지 상품 코드 입니다.\n","maxLength":20,"enum":["sms","lms","mms"]},"sampleLayoutId":{"type":"string","description":"maxLength: 40 - 샘플 레이아웃 ID 입니다.\n샘플 레이아웃을 이용하여 부분적으로 컴포넌트 변경하여 등록하는 경우 설정합니다.\n","maxLength":40},"headerComposition":{"type":"array","description":"카드 내의 최상위 영역으로 1개의 컴포넌트를 지정할 수 있습니다.  \n컴포넌트 중 headerYn = 'Y' 인 컴포넌트만 등록이 가능합니다.  \n컴포넌트를 지정하지 않을 경우 빈 배열로 등록 합니다.  \n","items":{"$ref":"#/components/schemas/LayoutComponent"}},"bodyComposition":{"type":"array","description":"카드 내의 중간 영역으로 메시지 상품에서 지정한 개수의 컴포넌트를 지정할 수 있습니다.  \n\n컴포넌트 중 bodyYn = 'Y' 인 컴포넌트만 등록이 가능합니다.  \n\n예를 들어 LMS는 최대 6개의 컴포넌트를 지정할 수 있으며, 최대 개수 범위 내에서 각 영역별 배분할 수 있습니다.     \n  \n  + Header 1개 지정 시 body 최대 5개  \n  + body만 지정 시 최대 6개\n","items":{"$ref":"#/components/schemas/LayoutComponent"}},"footerComposition":{"type":"array","description":"카드 내의 최하단 영역으로 1개의 컴포넌트를 지정할 수 있습니다.  \n\n컴포넌트 중 footerYn = 'Y' 인 컴포넌트만 등록이 가능합니다.  \n\n컴포넌트를 지정하지 않을 경우 빈 배열로 등록 합니다.  \n\n현재는 footer에 사용자가 직접 지정하는 컴포넌트는 없습니다.\n","items":{"$ref":"#/components/schemas/LayoutComponent"}}},"required":["layoutName","productCode","headerComposition","bodyComposition","footerComposition"]},"LayoutComponent":{"description":"레이아웃 내 사용되는 컴포넌트 객체입니다.","type":"object","properties":{"index":{"type":"integer","description":"레이아웃 내 컴포넌트의 순번을 표시합니다.  \n등록 시에는 index를 지정하지 않으며, 배열 내 순서를 기준으로 처리됩니다.  \n"},"componentId":{"type":"string","description":"maxLength: 40 - 지정할 컴포넌트 ID 입니다.\n","maxLength":40},"options":{"type":"object","description":"레이아웃 사용 시 컴포넌트에 적용될 수 있는 옵션입니다.   옵션 지정이 가능한 경우 표기됩니다.\n","oneOf":[{"$ref":"#/components/schemas/TableOption"},{"$ref":"#/components/schemas/ButtonOption"},{"$ref":"#/components/schemas/ViewAllOption"}]}},"required":["componentId"]},"TableOption":{"type":"object","description":"Table / StyleTable등 테이블 컴포넌트의 옵션 정보 객체 입니다.  \n","properties":{"leftAlign":{"type":"string","description":"좌측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.  \n\n  + left : 좌측 정렬  \n  + right : 우측 정렬  \n  + center : 중앙 정렬\n","enum":["left","right","center"],"default":"left"},"rightAlign":{"type":"string","description":"우측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.  \n\n  + left : 좌측 정렬  \n  + right : 우측 정렬  \n  + center : 중앙 정렬\n","enum":["left","right","center"],"default":"right"},"leftTextStyle":{"type":"string","description":"좌측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.  \n\n  + normal : 기본 스타일\n  + bold : bold 스타일 적용\n","enum":["normal","bold"],"default":"normal"},"rightTextStyle":{"type":"string","description":"우측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.  \n\n  + normal : 기본 스타일\n  + bold : bold 스타일 적용\n","enum":["normal","bold"],"default":"normal"},"maxCount":{"type":"integer","description":"테이블의 행 개수를 지정합니다. 정의된 숫자 이외에는 지정할 수 없습니다.  \n\n  + 5 : 5행\n  + 10 : 10행\n","enum":[5,10],"default":5}}},"ButtonOption":{"type":"object","description":"VButton / HButton 등 버튼 컴포넌트의 옵션 정보 객체 입니다.  \n","properties":{"color":{"type":"string","description":"버튼의 색상 설정 옵션입니다.  \n\n버튼의 색상은 브랜드 정보에서 지정한 templateColor 컬러 Hex 값과 동일해야 합니다.  \n\n빈값 지정 시 기본 버튼 컬러로 적용되며, 지정된 컬러 Hex 값이 templateColor의 값과 다르면 templateColor로 강제 설정됩니다.  \n"}}},"ViewAllOption":{"type":"object","description":"모두보기(viewAll) 옵션 정보 객체 입니다. \n\n컴포넌트 조회 시 options 상에 해당 옵션 설정이 포함되어 있을 때만 유효합니다. \n","properties":{"ctrlViewAll":{"type":"boolean","default":true,"description":"컴포넌트 단위의 viewAll(모두보기) 활성화 여부를 지정합니다. \n\n* true: 컴포넌트 viewAll(모두보기) 활성화 \n* false: 컴포넌트 viewAll(모두보기) 비활성화\n\n> ※ viewAll은 메시지 내 문자열이 표시되는 영역에 설정된 글자수 이상이 입력된 경우, 대상 영역을 '모두보기 >' 표시와 함께 접힌 상태로 표시하는 메시지 규격입니다. \n"},"viewAll":{"type":"integer","default":150,"description":"viewAll(모두보기) 접힘 글자수 기준값을 지정합니다. \n\n* 유효값: 150(default), 300\n* 유효값 이외 수치가 입력되는 경우 defualt로 처리됩니다.\n"}}}}},"paths":{"/brand/{brandId}/layout/{layoutId}":{"put":{"summary":"브랜드 내 레이아웃을 수정 합니다.  \n","description":"브랜드 내 레이아웃을 수정 합니다.  \n\n  + **계정 권한: 대행사**  \n  + **브랜드 권한: 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/LayoutId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegBrandLayout"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="SMS" %}

```
{
    "layoutName": "SMS수정_{{YYYYMMDDHHmmss}}",
    "productCode": "sms,
    "headerComposition": [
        {
            "index": 0,
            "componentId": "CP-MainTitle",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        }
    ],
    "bodyComposition": [
        {
            "index": 1,
            "componentId": "CP-Description",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        }        
    ],
    "footerComposition": []
}
```

{% endtab %}

{% tab title="LMS" %}

```
{
    "layoutName": "LMS수정_{{YYYYMMDDHHmmss}}",
    "productCode": "lms",
    "headerComposition": [
        {
            "index": 0,
            "componentId": "CP-MainTitle",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        }
    ],
    "bodyComposition": [
        {
            "index": 1,
            "componentId": "CP-Description",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-HButton",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-Description",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-VButton",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 1
            }
        }
    ],
    "footerComposition": []
}
```

{% endtab %}

{% tab title="MMS" %}

```
{
    "layoutName": "MMS수정_{{YYYYMMDDHHmmss}}",
    "productCode": "mms",
    "headerComposition": [
        {
            "index": 0,
            "componentId": "CP-ImageSquare"
        }
    ],
    "bodyComposition": [
        {
            "index": 1,
            "componentId": "CP-Description",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-ItemA",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        },
        {
            "index": 1,
            "componentId": "CP-HButton",
            "options": {
                "leftAlign": "left",
                "rightAlign": "right",
                "leftTextStyle": "normal",
                "rightTextStyle": "normal",
                "maxCount": 5
            }
        }        
    ],
    "footerComposition": []
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>레이아웃 ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>layoutId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>레이아웃 ID(= messagebaseId)</td></tr><tr><td><strong><code>body</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td>중계사 발송 API /message 의 body에 사용되는 발송 전문 필드 정보입니다. 규격서에 나열된 항목 이외에도 지정한 컴포넌트별 입력 가능한 항목을 추출하여 구성 제공합니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "layoutId": "CLMBR.0a81DDlZjz-11GLm0hv4RX9zJB82D9r"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 레이아웃 삭제

## Request

## 브랜드 별 등록된 레이아웃을 삭제합니다.<br>

> 브랜드 별 등록된 레이아웃을 삭제합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"LayoutId":{"name":"layoutId","in":"path","schema":{"type":"string"},"description":"레이아웃ID 입니다.","required":true}}},"paths":{"/brand/{brandId}/layout/{layoutId}":{"delete":{"summary":"브랜드 별 등록된 레이아웃을 삭제합니다.\n","description":"브랜드 별 등록된 레이아웃을 삭제합니다.  \n\n  + **계정 권한: 대행사**  \n  + **브랜드 권한: 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/LayoutId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>삭제된 레이아웃 ID(= messagebaseId)</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>layoutId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>삭제된 레이아웃 ID(= messagebaseId)</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "layoutId": "CLMBR.0a81DDlZjz-11GLm0hv4RX9zJB82D9r"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 로고

이 문서는 브랜드 로고를 관리할수 있는 API를 안내합니다.


# 기본 아이콘 이미지 목록 조회

## Request

## RBC에서 제공되는 기본 아이콘 이미지 정보를 조회합니다.<br>

> RBC에서 제공되는 기본 아이콘 이미지 정보를 조회합니다.  \
> 조회된 파일 ID를 메시지 발송 시 또는 템플릿 등록 시 사용할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}}},"paths":{"/logo/common":{"get":{"summary":"RBC에서 제공되는 기본 아이콘 이미지 정보를 조회합니다.\n","description":"RBC에서 제공되는 기본 아이콘 이미지 정보를 조회합니다.  \n조회된 파일 ID를 메시지 발송 시 또는 템플릿 등록 시 사용할 수 있습니다.  \n\n  + **계정 권한 : 마스터, 매니저, 대행사**\n","responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="184">필드명</th><th width="213">타입</th><th width="78" align="center">길이</th><th width="112" align="center">필수여부</th><th width="116">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>RBC에서 제공되는 기본 로고 정보</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td>리턴코드값</td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td>상태값</td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>처리메시지</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="184">필드명</th><th width="213">타입</th><th width="78" align="center">길이</th><th width="112" align="center">필수여부</th><th width="116">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>기본 로고 이미지 파일 ID 입니다.</td></tr><tr><td><strong><code>fileUrl</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>기본 로고 이미지 파일 URL 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">30</td><td align="center"></td><td></td><td>기본 로고명 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileName": "프로모션.gif",
            "fileUrl": "https://file-qa.rcsbizcenter.com/form/messagebase.common/LT-messagebase.common-DdWk6s_1.gif",
            "fileId": "LT-messagebase.common-DdWk6s"
        },
        {
            "fileName": "쿠폰.gif",
            "fileUrl": "https://file-qa.rcsbizcenter.com/form/messagebase.common/LT-messagebase.common-5Weq00_1.gif",
            "fileId": "LT-messagebase.common-5Weq00"
        },
        {
            "fileName": "이벤트.gif",
            "fileUrl": "https://file-qa.rcsbizcenter.com/form/messagebase.common/LT-messagebase.common-jUAJX2_1.gif",
            "fileId": "LT-messagebase.common-jUAJX2"
        },
        {
            "fileName": "예약.gif",
            "fileUrl": "https://file-qa.rcsbizcenter.com/form/messagebase.common/LT-messagebase.common-2Yxt2H_1.gif",
            "fileId": "LT-messagebase.common-2Yxt2H"
        },
        {
            "fileName": "영수증.gif",
            "fileUrl": "https://file-qa.rcsbizcenter.com/form/messagebase.common/LT-messagebase.common-2k8ydI_1.gif",
            "fileId": "LT-messagebase.common-2k8ydI"
        },
        {
            "fileName": "알림.gif",
            "fileUrl": "https://file-qa.rcsbizcenter.com/form/messagebase.common/LT-messagebase.common-YCVd02_1.gif",
            "fileId": "LT-messagebase.common-YCVd02"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 로고 목록 조회

## Request

## 브랜드 별 등록된 로고 목록을 조회합니다.<br>

> 브랜드 별 등록된 로고 목록을 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/brand/{brandId}/logo":{"get":{"summary":"브랜드 별 등록된 로고 목록을 조회합니다.\n","description":"브랜드 별 등록된 로고 목록을 조회합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 로고 정보</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="189">필드명</th><th width="141">타입</th><th width="95" align="center">길이</th><th width="101" align="center">필수여부</th><th width="86">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>로고 이미지 파일 ID 입니다.</td></tr><tr><td><strong><code>fileUrl</code></strong></td><td>string</td><td align="center">1000</td><td align="center"></td><td></td><td>로고 이미지 파일 URL 입니다.</td></tr><tr><td><strong><code>name</code></strong></td><td>string</td><td align="center">30</td><td align="center"></td><td></td><td>로고명 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>원본 파일명 입니다.</td></tr><tr><td><strong><code>description</code></strong></td><td>string</td><td align="center">100</td><td align="center"></td><td></td><td>로고 설명입니다.</td></tr><tr><td><strong><code>viaTemplate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록 시 추가된 이미지가 로고로 등록된 경우 해당 템플릿(messagebase) ID 를 표시합니다. 템플릿ID가 존재하는 로고 파일ID는 다른 템플릿 등록 시 사용할 수 없습니다.</td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>로고 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 승인요청 하지 않고 저장 또는 승인요청 취소된 상태입니다. 저장 상태의 로고는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 로고 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 로고 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 정보 등록까지 최종 완료되어 RCS 메시지 발송시 사용 가능한 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 로고는 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송시 사용할 수 없습니다.</li><li>승인대기(수정) : 승인된 로고를 수정하여 다시 승인요청한 상태입니다.</li><li>검수시작(수정) : 승인된 로고를 수정하여 다시 승인요청된 로고의 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 로고를 수정하여 다시 승인요청 후 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 로고를 수정하여 다시 승인요청 후 검수 승인은 되었으나 이통3사 정보 갱신이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 로고가 다르게 표시될 수 있습니다.</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>로고 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>로고 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>로고 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>로고 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>로고 수정 계정 ID</td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BLG-BR.61hBmMP164-Jt1O",
            "fileUrl": "https://file-qa.rcsbizcenter.com/brand/BR.61hBmMP164/logo/BLG-BR.61hBmMP164-Jt1O_1.png",
            "name": "통신",
            "fileName": "통신.png",
            "approvalResult": "저장",
            "viaTemplate": null,
            "description": "통신",
            "approvalReason": "승인요청 취소",
            "registerDate": "2024-07-08 10:10:30",
            "approvalDate": null,
            "updateDate": "2024-07-08 10:16:16",
            "registerId": "hong",
            "updateId": "hong"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 로고 상세 조회

## Request

## 브랜드에 등록된 로고를 단건 상세 조회합니다.<br>

> 브랜드에 등록된 로고를 단건 상세 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"FileId":{"name":"fileId","in":"path","schema":{"type":"string"},"required":true,"description":"파일ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/logo/{fileId}":{"get":{"summary":"브랜드에 등록된 로고를 단건 상세 조회합니다.\n","description":"브랜드에 등록된 로고를 단건 상세 조회합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/FileId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 로고 정보</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="189">필드명</th><th width="141">타입</th><th width="95" align="center">길이</th><th width="101" align="center">필수여부</th><th width="86">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>로고 이미지 파일 ID 입니다.</td></tr><tr><td><strong><code>fileUrl</code></strong></td><td>string</td><td align="center">1000</td><td align="center"></td><td></td><td>로고 이미지 파일 URL 입니다.</td></tr><tr><td><strong><code>name</code></strong></td><td>string</td><td align="center">30</td><td align="center"></td><td></td><td>로고명 입니다.</td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>원본 파일명 입니다.</td></tr><tr><td><strong><code>description</code></strong></td><td>string</td><td align="center">100</td><td align="center"></td><td></td><td>로고 설명입니다.</td></tr><tr><td><strong><code>viaTemplate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록 시 추가된 이미지가 로고로 등록된 경우 해당 템플릿(messagebase) ID 를 표시합니다. 템플릿ID가 존재하는 로고 파일ID는 다른 템플릿 등록 시 사용할 수 없습니다.</td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>로고 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 승인요청 하지 않고 저장 또는 승인요청 취소된 상태입니다. 저장 상태의 로고는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 로고 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 로고 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 정보 등록까지 최종 완료되어 RCS 메시지 발송시 사용 가능한 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 로고는 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송시 사용할 수 없습니다.</li><li>승인대기(수정) : 승인된 로고를 수정하여 다시 승인요청한 상태입니다.</li><li>검수시작(수정) : 승인된 로고를 수정하여 다시 승인요청된 로고의 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 로고를 수정하여 다시 승인요청 후 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 로고를 수정하여 다시 승인요청 후 검수 승인은 되었으나 이통3사 정보 갱신이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 로고가 다르게 표시될 수 있습니다.</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>로고 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>로고 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>로고 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>로고 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>로고 수정 계정 ID</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BLG-BR.61hBmMP164-Jt1O",
            "fileUrl": "https://file-qa.rcsbizcenter.com/brand/BR.61hBmMP164/logo/BLG-BR.61hBmMP164-Jt1O_1.png",
            "name": "통신",
            "fileName": "[크기변환]통신.png",
            "approvalResult": "저장",
            "viaTemplate": null,
            "description": "통신",
            "approvalReason": "승인요청 취소",
            "registerDate": "2024-07-08 10:10:30",
            "approvalDate": null,
            "updateDate": "2024-07-08 10:16:16",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 로고 등록 요청

## Request

## 브랜드 내에서 사용할 수 있는 로고를 등록 합니다.  <br>

> 브랜드 내에서 사용할 수 있는 로고를 등록 합니다.  \
> \
> 등록한 로고는 영구적으로 사용 가능합니다.  \
> \
> 템플릿 등록 시 또는 메시지 발송 시 mTitleMedia, itemMedia 에는 로고 파일ID 만 지정이 가능합니다.  \
> \
> 다음과 같은 사용은 실패를 유발하므로 주의가 필요합니다.  \
> 예1) 템플릿 등록 시 mTitleMedia 에 POST /brand/{brandId}/v2/messagebase/file 로 등록한 이미지 파일ID를 지정하면 등록 실패          \
> 예2) 메시지 발송 시 itemMedia 에 이통 메시지 파일 등록 API(POST /file)로 등록한 파일ID를 지정하면 발송 실패  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegBrandLogo":{"type":"object","description":"브랜드 로고 등록시 사용됩니다.\n","properties":{"name":{"type":"string","maxLength":30,"description":"maxLength: 30 - 로고명 입니다.\n"},"description":{"type":"string","maxLength":100,"description":"maxLength: 100 - 100자 이내의 로고 설명 입니다.\n"},"file":{"type":"object","format":"binary","description":"업로드 로고 이미지 파일을 지칭합니다.  \n        \n**파일형식 : gif, png, jpeg, jpg, bmp (최대 1MB)**\n"}},"required":["name","file"]}}},"paths":{"/brand/{brandId}/logo":{"post":{"summary":"브랜드 내에서 사용할 수 있는 로고를 등록 합니다.  \n","description":"브랜드 내에서 사용할 수 있는 로고를 등록 합니다.  \n\n등록한 로고는 영구적으로 사용 가능합니다.  \n\n템플릿 등록 시 또는 메시지 발송 시 mTitleMedia, itemMedia 에는 로고 파일ID 만 지정이 가능합니다.  \n\n다음과 같은 사용은 실패를 유발하므로 주의가 필요합니다.  \n예1) 템플릿 등록 시 mTitleMedia 에 POST /brand/{brandId}/v2/messagebase/file 로 등록한 이미지 파일ID를 지정하면 등록 실패          \n예2) 메시지 발송 시 itemMedia 에 이통 메시지 파일 등록 API(POST /file)로 등록한 파일ID를 지정하면 발송 실패  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/RegBrandLogo"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 로고 ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록된 로고 ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BLG-BR.61hBmMP164-Jt1O"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}

{
    "error": {
        "code": "64321",
        "message": "Invalid approval status"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 로고 승인 요청 취소

## Request

## 로고의 승인요청을 취소합니다.<br>

> 로고의 승인요청을 취소합니다.  \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*  \
> &#x20; \
> 각 상태별 취소 요청 동작은 다음과 같습니다.  \
> &#x20; \+ \*\*승인대기 : 저장 상태로 변경\*\*          \
> &#x20; \+ \*\*승인대기(수정) : 직전 승인 상태 및 데이터로 롤백\*\*\
> &#x20; \+ \*\*반려(수정) : 직전 승인 상태 및 데이터로 롤백\*\*\
> &#x20; \+ \*\*이외의 경우 에러 리턴\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"FileId":{"name":"fileId","in":"path","schema":{"type":"string"},"required":true,"description":"파일ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/logo/{fileId}/cancel":{"put":{"summary":"로고의 승인요청을 취소합니다.\n","description":"로고의 승인요청을 취소합니다.  \n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**  \n  \n각 상태별 취소 요청 동작은 다음과 같습니다.  \n  + **승인대기 : 저장 상태로 변경**          \n  + **승인대기(수정) : 직전 승인 상태 및 데이터로 롤백**\n  + **반려(수정) : 직전 승인 상태 및 데이터로 롤백**\n  + **이외의 경우 에러 리턴**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/FileId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 로고 ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록된 로고 ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BLG-BR.61hBmMP164-Jt1O"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 로고 수정 승인 요청

## 브랜드에 등록된 로고를 수정 승인요청 합니다.<br>

> 브랜드에 등록된 로고를 수정 승인요청 합니다.  \
> \
> 템플릿 등록 시 또는 메시지 발송 시 mTitleMedia, itemMedia 에는 로고 파일ID 만 지정이 가능합니다.  \
> \
> 다음과 같은 사용은 실패를 유발하므로 주의가 필요합니다.  \
> 예1) 템플릿 등록 시 mTitleMedia 에 POST /brand/{brandId}/v2/messagebase/file 로 등록한 이미지 파일ID를 지정하면 등록 실패          \
> 예2) 메시지 발송 시 itemMedia 에 이통 메시지 파일 등록 API(POST /file)로 등록한 파일ID를 지정하면 발송 실패  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*수정 가능 상태 : 저장, 반려, 반려(수정), 승인\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"FileId":{"name":"fileId","in":"path","schema":{"type":"string"},"required":true,"description":"파일ID Path Parameter 입니다.\n"}},"schemas":{"RegBrandLogo":{"type":"object","description":"브랜드 로고 등록시 사용됩니다.\n","properties":{"name":{"type":"string","maxLength":30,"description":"maxLength: 30 - 로고명 입니다.\n"},"description":{"type":"string","maxLength":100,"description":"maxLength: 100 - 100자 이내의 로고 설명 입니다.\n"},"file":{"type":"object","format":"binary","description":"업로드 로고 이미지 파일을 지칭합니다.  \n        \n**파일형식 : gif, png, jpeg, jpg, bmp (최대 1MB)**\n"}},"required":["name","file"]}}},"paths":{"/brand/{brandId}/logo/{fileId}":{"put":{"summary":"브랜드에 등록된 로고를 수정 승인요청 합니다.\n","description":"브랜드에 등록된 로고를 수정 승인요청 합니다.  \n\n템플릿 등록 시 또는 메시지 발송 시 mTitleMedia, itemMedia 에는 로고 파일ID 만 지정이 가능합니다.  \n\n다음과 같은 사용은 실패를 유발하므로 주의가 필요합니다.  \n예1) 템플릿 등록 시 mTitleMedia 에 POST /brand/{brandId}/v2/messagebase/file 로 등록한 이미지 파일ID를 지정하면 등록 실패          \n예2) 메시지 발송 시 itemMedia 에 이통 메시지 파일 등록 API(POST /file)로 등록한 파일ID를 지정하면 발송 실패  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **수정 가능 상태 : 저장, 반려, 반려(수정), 승인**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/FileId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/RegBrandLogo"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="179">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 로고 ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록된 로고 ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BLG-BR.61hBmMP164-Jt1O"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}

{
    "error": {
        "code": "64321",
        "message": "Invalid approval status"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 로고 삭제(승인 이전)

## Request

## 브랜드에 등록된 승인 이전 상태의 로고를 삭제 합니다.<br>

> 브랜드에 등록된 승인 이전 상태의 로고를 삭제 합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*삭제 가능 상태 : 저장, 반려\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"FileId":{"name":"fileId","in":"path","schema":{"type":"string"},"required":true,"description":"파일ID Path Parameter 입니다.\n"}}},"paths":{"/brand/{brandId}/logo/{fileId}":{"delete":{"summary":"브랜드에 등록된 승인 이전 상태의 로고를 삭제 합니다.\n","description":"브랜드에 등록된 승인 이전 상태의 로고를 삭제 합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **삭제 가능 상태 : 저장, 반려**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/FileId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><strong><code>result</code></strong></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>삭제된 로고 ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>삭제된 로고 ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BLG-BR.61hBmMP164-Jt1O"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}

{
    "error": {
        "code": "64321",
        "message": "Invalid approval status"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대행사

이 문서는 대행사 관리 브랜드에 대한 API 정보를 안내합니다.


# 대행사 브랜드 목록 조회

## Request

## 대행사가 계약된 브랜드 리스트를 제공합니다.<br>

> 대행사가 계약된 브랜드 리스트를 제공합니다.  \
> 브랜드별 기업의 사업자등록번호를 함께 전달 하여 대행사에 등록된 기업 정보와 맵핑할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"AgencyId":{"name":"agencyId","in":"path","schema":{"type":"string","maxLength":20},"required":true,"description":"maxLength: 20 - RCS Biz Center에 등록된 대행사 ID 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/agency/{agencyId}/contract":{"get":{"summary":"대행사가 계약된 브랜드 리스트를 제공합니다.\n","description":"대행사가 계약된 브랜드 리스트를 제공합니다.  \n브랜드별 기업의 사업자등록번호를 함께 전달 하여 대행사에 등록된 기업 정보와 맵핑할 수 있습니다.  \n\n  + **계정 권한: 대행사**  \n","parameters":[{"$ref":"#/components/parameters/AgencyId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="122">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드와 대행사의 계약관계 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="191">필드명</th><th width="150">타입</th><th width="98" align="center">길이</th><th width="105" align="center">필수여부</th><th width="81">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>corpId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>RCS Biz Center에 등록된 기업 ID 입니다.</td></tr><tr><td><strong><code>corpRegNum</code></strong></td><td>string</td><td align="center">10</td><td align="center">O</td><td></td><td>RCS Biz Center에 등록된 기업의 사업자등록번호 입니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드 ID 입니다.</td></tr><tr><td><strong><code>brandName</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>브랜드 명 입니다.</td></tr><tr><td><strong><code>agencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>대행사 ID 입니다</td></tr><tr><td><a href="#contracts-array-less-than-string-greater-than"><mark style="color:blue;"><strong><code>contracts</code></strong></mark></a></td><td>array&#x3C;string></td><td align="center"></td><td align="center"></td><td></td><td><p>계약 유형 입니다</p><ul><li>a2p</li><li>chat</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>계약정보 등록일시 입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>계약정보 수정일시 입니다.</td></tr><tr><td><strong><code>brandDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>계약된 대상 브랜드의 최종 변경 일시 정보 입니다.</td></tr><tr><td><strong><code>chatbotDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.</td></tr><tr><td><strong><code>messagebaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.</td></tr><tr><td><strong><code>logoDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 브랜드 로고 중 가장 최근에 변경된 로고의 일시 정보 입니다.</td></tr><tr><td><strong><code>autoreplymsgDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 자동응답메시지 중 가장 최근에 변경된 자동응답메시지의 일시 정보 입니다.</td></tr></tbody></table>

### <mark style="color:blue;">**`contracts`**</mark> - **array\<string>**

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="78">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="86">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>Allowed</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>계약 유형 입니다.</p><ul><li>a2p</li><li>chat</li></ul></td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="88">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="86">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "corpId": "CO.l9ZohLN20I",
            "corpRegNum": "3148158360",
            "brandId": "BR.i3gC1762pT",
            "brandName": "테스트브랜드",
            "status": "검수완료(수정)",
            "agencyId": "hong",
            "contracts": [
                "a2p,chat"
            ],
            "registerDate": "2024-06-10T16:39:14.000+09",
            "updateDate": "2024-06-10T16:39:14.000+09",
            "brandDate": "2024-06-05T15:27:19.000+09",
            "chatbotDate": "2024-06-05T15:27:17.000+09",
            "messagebaseDate": "2024-06-05T15:27:21.000+09",
            "logoDate": null,
            "approvalDate": "2024-06-10T10:16:59.000+09"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="204" %}

```
{agencyId}에 브랜드가 할당되지 않은 경우에는 빈 contents가 리턴될 수 있음.
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대행사 브랜드 기업단위 목록 조회

## Request

## 대행사가 계약된 브랜드를 기업 단위로 조회합니다.<br>

> 대행사가 계약된 브랜드를 기업 단위로 조회합니다.  \
> 기업 단위 조회 시 사업자등록번호를 이용합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"AgencyId":{"name":"agencyId","in":"path","schema":{"type":"string","maxLength":20},"required":true,"description":"maxLength: 20 - RCS Biz Center에 등록된 대행사 ID 입니다.\n"},"CorpRegNum":{"name":"corpRegNum","in":"path","schema":{"type":"string","maxLength":10},"required":true,"description":"maxLength: 10 - 대상 기업의 사업자등록번호(10자리) 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/agency/{agencyId}/corp/{corpRegNum}/brand":{"get":{"summary":"대행사가 계약된 브랜드를 기업 단위로 조회합니다.\n","description":"대행사가 계약된 브랜드를 기업 단위로 조회합니다.  \n기업 단위 조회 시 사업자등록번호를 이용합니다.  \n\n  + **계정 권한: 대행사**  \n","parameters":[{"$ref":"#/components/parameters/AgencyId"},{"$ref":"#/components/parameters/CorpRegNum"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="121">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드와 대행사의 계약관계 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">**result**</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="187">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="81">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>corpId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>RCS Biz Center에 등록된 기업 ID 입니다.</td></tr><tr><td><strong><code>corpRegNum</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>RCS Biz Center에 등록된 기업의 사업자등록번호 입니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드 ID 입니다.</td></tr><tr><td><strong><code>brandName</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>브랜드 명 입니다.</td></tr><tr><td><strong><code>agencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>대행사 ID 입니다.</td></tr><tr><td><a href="#contracts-array-less-than-string-greater-than"><mark style="color:blue;"><strong><code>contracts</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td><p>계약 유형 입니다.</p><ul><li>a2p</li><li>chat</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>계약정보 등록일시 입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>계약정보 수정일시 입니다.</td></tr><tr><td><strong><code>brandDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>계약된 대상 브랜드의 최종 변경 일시 정보 입니다.</td></tr><tr><td><strong><code>chatbotDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.</td></tr><tr><td><strong><code>logoDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 로고이미지 중 가장 최근에 변경된 로고이미지의 일시 정보 입니다.</td></tr><tr><td><strong><code>autoreplymsgDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 자동응답메시지 중 가장 최근에 변경된 자동응답메시지의 일시 정보 입니다.</td></tr><tr><td><strong><code>messagebaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.</td></tr><tr><td><strong><code>logoDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 브랜드 로고 중 가장 최근에 변경된 로고의 일시 정보 입니다.</td></tr></tbody></table>

### <mark style="color:blue;">contracts</mark> - **array\<string>**

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="78">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="89">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>Allowed</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>계약 유형 입니다.</p><ul><li>a2p</li><li>chat</li></ul></td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="79">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="80">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "corpId": "CO.l9ZohLN20I",
            "corpRegNum": "3148158360",
            "brandId": "BR.i3gC1762pT",
            "brandName": "테스트브랜드",
            "status": "검수완료(수정)",
            "agencyId": "hong",
            "contracts": [
                "a2p,chat"
            ],
            "registerDate": "2024-06-10T16:39:14.000+09",
            "updateDate": "2024-06-10T16:39:14.000+09",
            "brandDate": "2024-06-05T15:27:19.000+09",
            "chatbotDate": "2024-06-05T15:27:17.000+09",
            "messagebaseDate": "2024-06-05T15:27:21.000+09",
            "logoDate": null,
            "approvalDate": "2024-06-10T10:16:59.000+09"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="204" %}

```
존재하지 않는 {corpRegNum}로 조회시에는빈 contents가 리턴될 수 있음.
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대행사 브랜드 상세 조회

## Request

## 계약된 브랜드 정보를 개별 조회 합니다.<br>

> 계약된 브랜드 정보를 개별 조회 합니다.  \
> 승인된 브랜드만 조회가 가능합니다.  \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"AgencyId":{"name":"agencyId","in":"path","schema":{"type":"string","maxLength":20},"required":true,"description":"maxLength: 20 - RCS Biz Center에 등록된 대행사 ID 입니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}}},"paths":{"/agency/{agencyId}/brand/{brandId}":{"get":{"summary":"계약된 브랜드 정보를 개별 조회 합니다.\n","description":"계약된 브랜드 정보를 개별 조회 합니다.  \n승인된 브랜드만 조회가 가능합니다.  \n  + **계정 권한: 대행사**  \n  + **브랜드 권한: 운영자**\n","parameters":[{"$ref":"#/components/parameters/AgencyId"},{"$ref":"#/components/parameters/BrandId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 상세 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="187">필드명</th><th width="140">타입</th><th width="68" align="center">길이</th><th width="104" align="center">필수여부</th><th width="79">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>name</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>브랜드 이름 - 브랜드 등록 시 지정합니다.</td></tr><tr><td><strong><code>brandKey</code></strong></td><td>string</td><td align="center">18</td><td align="center"></td><td></td><td>브랜드 Key - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 - 브랜드 등록 일시입니다.</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인일시 - 브랜드가 검수에서 승인된 일시입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 - 브랜드의 정보가 수정된 일시입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>브랜드의 상태 입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 브랜드 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.</li><li>검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다.<br>브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.</li></ul></td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>chatbotDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.</td></tr><tr><td><strong><code>logoDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 로고이미지 중 가장 최근에 변경된 로고이미지의 일시 정보 입니다.</td></tr><tr><td><strong><code>autoreplymsgDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 자동응답메시지 중 가장 최근에 변경된 자동응답메시지의 일시 정보 입니다.</td></tr><tr><td><strong><code>messagebaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.</td></tr><tr><td><strong><code>description</code></strong></td><td>string</td><td align="center">150</td><td align="center"></td><td></td><td>브랜드 설명에 등록된 내용입니다.</td></tr><tr><td><strong><code>tel</code></strong></td><td>string</td><td align="center">12</td><td align="center"></td><td></td><td>브랜드홈에 노출될 전화번호(대표발신번호와 별개) 입니다.</td></tr><tr><td><a href="#menus-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>menus</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center">3</td><td align="center"></td><td></td><td>브랜드 홈에는 최대 4개까지 표시됩니다. chat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.</td></tr><tr><td><strong><code>categoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 ID 입니다.</td></tr><tr><td><strong><code>categoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 명 입니다.</td></tr><tr><td><strong><code>subCategoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 하위 카테고리 ID 입니다.</td></tr><tr><td><strong><code>subCategoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 하위 카테고리 명 입니다.</td></tr><tr><td><strong><code>categoryOpt</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>검색용 키워드 임의 등록 할 수 있습니다.</td></tr><tr><td><strong><code>zipCode</code></strong></td><td>string</td><td align="center">5</td><td align="center"></td><td></td><td>브랜드 홈에 표시될 우편번호(5자리) 입니다.</td></tr><tr><td><strong><code>roadAddress</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 도로명주소 입니다.</td></tr><tr><td><strong><code>detailAddress</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 상세주소 입니다.</td></tr><tr><td><strong><code>email</code></strong></td><td>string</td><td align="center">30</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 이메일주소 입니다.</td></tr><tr><td><strong><code>webSiteUrl</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 홈페이지 주소 입니다.</td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>검수 시 반려 사유가 제공됩니다.</td></tr><tr><td><strong><code>brandFeedUrl</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 소식 URL 입니다. 브랜드 소식을 최초 등록하거나 브랜드 홈 기본 탭을 소식탭(FEED)로 설정하면 자동 생성됩니다.</td></tr><tr><td><strong><code>initTab</code></strong></td><td>string</td><td align="center">5</td><td align="center"></td><td>FEED</td><td><p>단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다. 미지정 시 기본값은 FEED 입니다.</p><ul><li>FEED: 소식탭을 기본 탭으로 지정합니다.</li><li>INFO: 정보탭을 기본 탭으로 지정합니다. 브랜드 최초 승인 시에만 선택이 가능하며 승인 이후에는 수정이 불가합니다.</li></ul></td></tr><tr><td><strong><code>initFeedItem</code></strong></td><td>array&#x3C;object></td><td align="center">6</td><td align="center"></td><td></td><td><p>하위 호환성을 위해 필드는 유지되지만, 동일한 용도의 initFeedItems 사용을 권고합니다.</p><ul><li>TEL: 소식탭에 전화걸기(=퀵버튼 call) 버튼이 표시됩니다.</li><li>HOME: 소식탭에 Web 연결(=퀵버튼 web) 버튼이 표시됩니다.</li><li>SEARCH: 소식탭에 포털검색 버튼이 표시되며, 소식탭 전용 퀵버튼입니다.</li></ul></td></tr><tr><td><strong><code>initFeedItems</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다. menus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다. menus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.</p><p>"call", "web", "store", "order", "buy", "tickets", "moreinfo", "portalsearch"</p></td></tr><tr><td><strong><code>templateColor</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.</td></tr><tr><td><strong><code>bizInfoYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>N</td><td>브랜드 소식탭에 운영정보 사용 여부를 설정합니다.</td></tr><tr><td><strong><code>bizInfoTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.</td></tr><tr><td><strong><code>bizInfoContent</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>N</td><td><p></p><p>안심마크 지정 기업 여부를 표시합니다.</p><ul><li>Y : 안심마크 지정</li><li>N : 안심마크 미지정</li></ul></td></tr></tbody></table>

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="80">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>typeName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미지</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">menus</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="85">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonType</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td><p>버튼 유형</p><p>"call", "web", "app", "store", "order", "buy", "tickets", "moreinfo"</p></td></tr><tr><td><a href="#applink-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>applink</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>APP Link의 패키지 Name, Action, URL 정보 객체입니다.</td></tr><tr><td><strong><code>weblink</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>buttonType call 을 제외한 모든 버튼은 Web URL을 입력해야 합니다. URL은 http:// 또는 https:// 로 시작하여야 합니다.</td></tr></tbody></table>

### <mark style="color:blue;">applink</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="158">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="79">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>packageName</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>App 실행을 위한 package name</td></tr><tr><td><strong><code>action</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>App 실행을 위한 Action</td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>App 실행을 위한 URI</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "검수완료(수정)",
            "chatbotDate": "2024-06-05T15:27:17.000+09",
            "messagebaseDate": "2024-06-05T15:27:21.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-06-10T10:16:59.000+09",
            "approvalDate": "2024-06-10T10:16:59.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ],
            "menus": [
                {
                    "buttonType": "tickets",
                    "weblink": "http://www.naver.com",
                    "feedinfoYn": "N"
                }
            ],
            "description": "테스트브랜드",
            "tel": "30000800",
            "categoryId": "EDU",
            "categoryName": "교육",
            "subCategoryId": "EDU007",
            "subCategoryName": "유학/연수",
            "categoryOpt": null,
            "zipCode": "55110",
            "roadAddress": "서울특별시",
            "detailAddress": "109-5",
            "email": "lng0415@naver.com",
            "webSiteUrl": "http://www.google.com",
            "brandFeedUrl": "https://biz-dev.chatplus.co.kr/brand/BR.i3gC1762pT",
            "initTab": "INFO",
            "initFeedItems": [],
            "templateColor": null,
            "bizInfoYn": "N",
            "bizInfoTitle": null,
            "bizInfoContent": null,
            "saftyStatusYn": "N"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대행사 지정상태 확인

## Request

## 사업자등록번호로 RBC 가입 여부와 브랜드 대행사 지정 상태를 확인할 수 있습니다.<br>

> 사업자등록번호로 RBC 가입 여부와 브랜드 대행사 지정 상태를 확인할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"AgencyId":{"name":"agencyId","in":"path","schema":{"type":"string","maxLength":20},"required":true,"description":"maxLength: 20 - RCS Biz Center에 등록된 대행사 ID 입니다.\n"},"CorpRegNum":{"name":"corpRegNum","in":"path","schema":{"type":"string","maxLength":10},"required":true,"description":"maxLength: 10 - 대상 기업의 사업자등록번호(10자리) 입니다.\n"}}},"paths":{"/agency/{agencyId}/corp/{corpRegNum}":{"get":{"summary":"사업자등록번호로 RBC 가입 여부와 브랜드 대행사 지정 상태를 확인할 수 있습니다.\n","description":"사업자등록번호로 RBC 가입 여부와 브랜드 대행사 지정 상태를 확인할 수 있습니다.  \n\n  + **계정 권한: 대행사**  \n","parameters":[{"$ref":"#/components/parameters/AgencyId"},{"$ref":"#/components/parameters/CorpRegNum"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>가입 여부, 대행사 지정 상태를 응답합니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="206">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="83">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>corpRegNum</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>조회 요청한 사업자등록번호</td></tr><tr><td><strong><code>conditionValue</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td><p>등록 여부 및 브랜드, 대행사 지정 현황 상태값</p><ul><li>0: RBC 미등록 사업자등록번호</li><li>1: RBC 등록 사업자등록번호이나 브랜드 등록 없음</li><li>2: 1건 이상의 브랜드 등록있으나 대행사 지정 건 없음</li><li>3: 1건 이상 브랜드 등록 및 1개 이상 대행사 지정 존재</li></ul></td></tr><tr><td><strong><code>conditionDescription</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>conditionValue 에 대한 설명<br>"RBC 미등록 사업자등록번호"</p><p>"RBC 등록 사업자등록번호이나 브랜드 등록 없음"</p><p>"1건 이상의 브랜드 등록있으나 대행사 지정 건 없음"</p><p>"1건 이상 브랜드 등록 및 1개 이상 대행사 지정 존재"</p></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "corpRegiNum": "3148158360",
            "conditionValue": 3,
            "conditionDescription": "1건 이상 브랜드 등록 및 1개 이상 대행사 지정 존재"
        }
    ],
    "status": 200
}

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "corpRegiNum": "31481583",
            "conditionValue": 0,
            "conditionDescription": "RBC 미등록 사업자등록번호"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대행사 브랜드 수정

## Request

## 대행사가 운영 중인 브랜드 정보를 수정 합니다. 브랜드명, 프로필/백그라운드 이미지가 수정되면 다시 승인을 받아야 합니다.<br>

> 대행사 계정으로 현재 운영 중인 브랜드 정보를 수정 합니다.   \
> \
> 브랜드 권한(Contract)이 있어야 수정이 가능하며 Header에 브랜드 Key를 삽입하여야 합니다.  \
> \
> \*\*브랜드명\*\* 또는 \*\*프로필/백그라운드 이미지\*\*가 수정되면 다시 승인을 받아야 합니다. 상태가 \*\*승인대기\*\*로 변경 됩니다.  \
> \
> 이외 정보 수정은 별도의 승인 과정 없이 업데이트 됩니다.  \
> \
> 수정된 데이터가 이통 3사로 전송되는 과정에서 전송이 지연되거나 장애로 인해 이통 3사 모두 전송이 완료되지 못한 경우,  \
> 브랜드 정보 조회 데이터와 단말에서 표시되는 브랜드 홈 정보가 상이할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한 : 운영자\*\*  \
> &#x20; \+ \*\*수정 가능 상태 : 승인, 반려(수정승인)\*\*  \
> &#x20; \+ \*\*수정 승인 요청 시 상태 : 승인대기(수정승인)\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"AgencyId":{"name":"agencyId","in":"path","schema":{"type":"string","maxLength":20},"required":true,"description":"maxLength: 20 - RCS Biz Center에 등록된 대행사 ID 입니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegBrandInfo":{"description":"브랜드 등록 정보 객체입니다.  \nObject 세부구성은 [RegBrandInfo](#/RegBrandInfo)를 참고하시기 바랍니다.  \n","type":"object","properties":{"regBrand":{"type":"object","required":["name","description","categoryId","subCategoryId"],"properties":{"name":{"type":"string","maxLength":20,"description":"maxLength: 20 - 브랜드 홈에 표시되는 브랜드 이름 입니다.\n"},"description":{"type":"string","maxLength":150,"description":"maxLength: 150 - 브랜드 홈에 표시되는 브랜드 설명 입니다.\n"},"tel":{"type":"string","maxLength":12,"description":"maxLength: 12 - 브랜드 홈에 노출될 전화번호(대표발신번호와 별개) 입니다.\n\n**2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 값 설정 시 무시됩니다.**\n","deprecated":true},"menus":{"description":"maximum: 3 - 브랜드 홈에는 최대 4개까지 표시됩니다.  \n\nchat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.  \n\n  + **2020년 12월 3일 기준 브랜드 menus 중 app 은 이통사 정책에 의거 한시적으로 등록이 불가하며 app 등록 시 error 리턴됩니다.**\n","type":"array","items":{"$ref":"#/components/schemas/MenuItemInfo"},"maximum":3},"categoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 카테고리 ID 입니다.\n"},"subCategoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 하위 카테고리 ID 입니다.\n"},"categoryOpt":{"type":"string","maxLength":20,"description":"maxLength: 20 - 검색용 키워드 임의 등록 할 수 있습니다.\n"},"zipCode":{"type":"string","maxLength":5,"description":"maxLength: 5 - 브랜드 홈에 표시될 우편번호(5자리) 입니다.\n"},"roadAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 도로명주소 입니다.\n"},"detailAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 상세주소 입니다.\n"},"email":{"type":"string","maxLength":100,"format":"email","description":"maxLength: 100 - 브랜드 홈에 표시되는 이메일주소 입니다.\n"},"webSiteUrl":{"type":"string","maxLength":128,"description":"maxLength: 128 - 브랜드 홈에 표시되는 홈페이지 주소 입니다.\n"},"initTab":{"type":"string","maxLength":5,"description":"maxLength: 5 - 단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다.  \n미지정 시 기본값은 FEED 입니다.  \n\n  + FEED: 소식탭을 기본 탭으로 지정합니다.   \n  + INFO: 정보탭을 기본 탭으로 지정합니다.  \n","enum":["FEED","INFO"],"default":"FEED"},"initFeedItem":{"type":"string","maxLength":6,"description":"maxLength: 6 - 하위 호환성을 위해 필드는 유지되지만, 동일한 용도의 initFeedItems 사용을 권고합니다.   \n\n  + TEL: 소식탭에 전화걸기(= 퀵버튼 call) 버튼이 표시됩니다. **2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**   \n  + HOME: 소식탭에 Web 연결(= 퀵버튼 web) 버튼이 표시됩니다.   \n  + SEARCH: 소식탭에 포털검색(= portalsearch) 버튼이 표시되며, 소식탭 전용 퀵버튼입니다.  \n","enum":["TEL","HOME","SEARCH"],"deprecated":true},"initFeedItems":{"description":"initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다.  \n\nmenus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다.  \n\nmenus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시 가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.  \n\n**call은 2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**\n","type":"array","items":{"type":"string","enum":["call","web","store","order","buy","tickets","moreinfo","portalsearch"]}},"templateColor":{"description":"maxLength: 10 - 브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.\n","type":"string","maxLength":10},"bizInfoYn":{"description":"브랜드 소식탭에 운영정보 사용 여부를 설정합니다.  \n","type":"string","enum":["Y","N"],"default":"N"},"bizInfoTitle":{"description":"maxLength: 20 - bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.  \n","type":"string","maxLength":20},"bizInfoContent":{"description":"maxLength: 200 - bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.\n","type":"string","maxLength":200}}}}},"MenuItemInfo":{"type":"object","description":"브랜드 홈에 표시 가능한 버튼 정보 객체입니다. AppLink와 WebLink가 모두 설정된 경우 단말에 app 이 설치되어 있으면 app을 실행하고 설치되지 않은 경우 weblink로 연결됩니다.\n","properties":{"buttonType":{"type":"string","maxLength":20,"description":"maxLength: 20 - 버튼 유형\n","enum":["call","web","app","store","order","buy","tickets","moreinfo"]},"applink":{"$ref":"#/components/schemas/AppLinkItemInfo"},"weblink":{"type":"string","maxLength":128,"description":"maxLength: 128 - buttonType call 을 제외한 모든 버튼은 Web URL을 입력해야 합니다. URL은 http:// 또는 https:// 로 시작하여야 합니다.\n"}},"required":["buttonType"]},"AppLinkItemInfo":{"type":"object","description":"APP Link의 패키지 Name, Action, URL 정보 객체입니다.\n","properties":{"packageName":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 package name 을 지정합니다.\n"},"action":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 Action 을 지정합니다.\n"},"uri":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 URI 지정합니다.\n"}},"required":["packageName","action","uri"]}}},"paths":{"/agency/{agencyId}/brand/{brandId}":{"put":{"summary":"대행사가 운영 중인 브랜드 정보를 수정 합니다. 브랜드명, 프로필/백그라운드 이미지가 수정되면 다시 승인을 받아야 합니다.\n","description":"대행사 계정으로 현재 운영 중인 브랜드 정보를 수정 합니다.   \n\n브랜드 권한(Contract)이 있어야 수정이 가능하며 Header에 브랜드 Key를 삽입하여야 합니다.  \n\n**브랜드명** 또는 **프로필/백그라운드 이미지**가 수정되면 다시 승인을 받아야 합니다. 상태가 **승인대기**로 변경 됩니다.  \n\n이외 정보 수정은 별도의 승인 과정 없이 업데이트 됩니다.  \n\n수정된 데이터가 이통 3사로 전송되는 과정에서 전송이 지연되거나 장애로 인해 이통 3사 모두 전송이 완료되지 못한 경우,  \n브랜드 정보 조회 데이터와 단말에서 표시되는 브랜드 홈 정보가 상이할 수 있습니다.  \n\n  + **계정 권한 : 대행사**  \n  + **브랜드 권한 : 운영자**  \n  + **수정 가능 상태 : 승인, 반려(수정승인)**  \n  + **수정 승인 요청 시 상태 : 승인대기(수정승인)**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/AgencyId"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"regBrand":{"$ref":"#/components/schemas/RegBrandInfo"},"brandProfile":{"description":"브랜드 프로필 이미지를 업로드합니다.  \n\n**최소사이즈 : 388X388px / 최대사이즈 : 1080X1080px / 1:1 비율 권장 / 파일형식\n: png (최대1MB)**\n","type":"string","format":"binary"},"brandBackground":{"description":"브랜드 백그라운드 이미지를 업로드합니다.  \n\n등록되어 있는 브랜드 백그라운드 이미지를 제거하기 위해서는 파일 없이 brandBackground form\nkey만 전송하면 됩니다.\\\n\n**최소사이즈 : 388X388px / 최대사이즈 : 1080X1080px / 1:1 비율 권장 / 파일형식\n: jpg, png (최대1MB)**\n","type":"string","format":"binary"},"seasonDocFile":{"description":"시즌 내 신청 생성된 가상기업에 등록되는 브랜드의 경우 별도 요구되는 서류를 파일로 등록합니다.\n\n**파일형식 jpg, jpeg, png, pdf, tiff, zip (최대 5MB)**\n","type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body form data sample

{% tabs %}
{% tab title="regBrand" %}

```
'regBrand="{
    \"regBrand\": {
        \"name\": \"대행사브랜드수정\",
        \"description\": \"대행사브랜드수정\",
        \"tel\": \"30000800\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"55110\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"109-5\",
        \"webSiteUrl\": \"http://www.google.com\",
        \"email\": \"lng0415@naver.com\",
        \"initTab\": \"INFO\",
        \"initFeedItem\": \"HOME\",
        \"menus\": [
            {
                \"buttonType\": \"tickets\",
                \"weblink\": \"http://www.google.com\"
            }
        ]
    }
}"' \
```

{% endtab %}
{% endtabs %}

## Response <a href="#response" id="response"></a>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 상세 정보 객체입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">**result**</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="187">필드명</th><th width="140">타입</th><th width="68" align="center">길이</th><th width="104" align="center">필수여부</th><th width="87">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>name</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td>브랜드 이름 - 브랜드 등록 시 지정합니다.</td></tr><tr><td><strong><code>brandKey</code></strong></td><td>string</td><td align="center">18</td><td align="center"></td><td></td><td>브랜드 Key - 브랜드 등록 시 자동 생성됩니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>등록일시 - 브랜드 등록 일시입니다.</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인일시 - 브랜드가 검수에서 승인된 일시입니다.</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정일시 - 브랜드의 정보가 수정된 일시입니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>브랜드의 상태 입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 브랜드 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.</li><li>검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다.<br>브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.</li></ul></td></tr><tr><td><a href="#mediaurl-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>mediaUrl</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.</td></tr><tr><td><strong><code>chatbotDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.</td></tr><tr><td><strong><code>logoDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 로고이미지 중 가장 최근에 변경된 로고이미지의 일시 정보 입니다.</td></tr><tr><td><strong><code>autoreplymsgDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 자동응답메시지 중 가장 최근에 변경된 자동응답메시지의 일시 정보 입니다.</td></tr><tr><td><strong><code>messagebaseDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.</td></tr><tr><td><strong><code>description</code></strong></td><td>string</td><td align="center">150</td><td align="center"></td><td></td><td>브랜드 설명에 등록된 내용입니다.</td></tr><tr><td><strong><code>tel</code></strong></td><td>string</td><td align="center">12</td><td align="center"></td><td></td><td>브랜드홈에 노출될 전화번호(대표발신번호와 별개) 입니다.</td></tr><tr><td><a href="#menus-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>menus</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center">3</td><td align="center"></td><td></td><td>브랜드 홈에는 최대 4개까지 표시됩니다. chat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.</td></tr><tr><td><strong><code>categoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 ID 입니다.</td></tr><tr><td><strong><code>categoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 카테고리 명 입니다.</td></tr><tr><td><strong><code>subCategoryId</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 하위 카테고리 ID 입니다.</td></tr><tr><td><strong><code>subCategoryName</code></strong></td><td>string</td><td align="center">64</td><td align="center"></td><td></td><td>브랜드 하위 카테고리 명 입니다.</td></tr><tr><td><strong><code>categoryOpt</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>검색용 키워드 임의 등록 할 수 있습니다.</td></tr><tr><td><strong><code>zipCode</code></strong></td><td>string</td><td align="center">5</td><td align="center"></td><td></td><td>브랜드 홈에 표시될 우편번호(5자리) 입니다.</td></tr><tr><td><strong><code>roadAddress</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 도로명주소 입니다.</td></tr><tr><td><strong><code>detailAddress</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 상세주소 입니다.</td></tr><tr><td><strong><code>email</code></strong></td><td>string</td><td align="center">30</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 이메일주소 입니다.</td></tr><tr><td><strong><code>webSiteUrl</code></strong></td><td>string</td><td align="center">128</td><td align="center"></td><td></td><td>브랜드 홈에 표시되는 홈페이지 주소 입니다.</td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>검수 시 반려 사유가 제공됩니다.</td></tr><tr><td><strong><code>brandFeedUrl</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 소식 URL 입니다. 브랜드 소식을 최초 등록하거나 브랜드 홈 기본 탭을 소식탭(FEED)로 설정하면 자동 생성됩니다.</td></tr><tr><td><strong><code>initTab</code></strong></td><td>string</td><td align="center">5</td><td align="center"></td><td>FEED</td><td><p>단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다. 미지정 시 기본값은 FEED 입니다.</p><ul><li>FEED: 소식탭을 기본 탭으로 지정합니다.</li><li>INFO: 정보탭을 기본 탭으로 지정합니다. 브랜드 최초 승인 시에만 선택이 가능하며 승인 이후에는 수정이 불가합니다.</li></ul></td></tr><tr><td><strong><code>initFeedItem</code></strong></td><td>array&#x3C;object></td><td align="center">6</td><td align="center"></td><td></td><td><p>하위 호환성을 위해 필드는 유지되지만, 동일한 용도의 initFeedItems 사용을 권고합니다.</p><ul><li>TEL: 소식탭에 전화걸기(=퀵버튼 call) 버튼이 표시됩니다.</li><li>HOME: 소식탭에 Web 연결(=퀵버튼 web) 버튼이 표시됩니다.</li><li>SEARCH: 소식탭에 포털검색 버튼이 표시되며, 소식탭 전용 퀵버튼입니다.</li></ul></td></tr><tr><td><strong><code>initFeedItems</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다. menus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다. menus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.</p><p>"call", "web", "store", "order", "buy", "tickets", "moreinfo", "portalsearch"</p></td></tr><tr><td><strong><code>templateColor</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.</td></tr><tr><td><strong><code>bizInfoYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>N</td><td>브랜드 소식탭에 운영정보 사용 여부를 설정합니다.</td></tr><tr><td><strong><code>bizInfoTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.</td></tr><tr><td><strong><code>bizInfoContent</code></strong></td><td>string</td><td align="center">200</td><td align="center"></td><td></td><td>bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.</td></tr></tbody></table>

### <mark style="color:blue;">mediaUrl</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="87">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>fileId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>url</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>typeName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>이미지의 사용 유형을 구분합니다.</p><ul><li>icon - 템플릿 양식 아이콘 이미지</li><li>profile - 브랜드 프로필 이미지</li><li>background - 브랜드 백그라운드 이미지</li></ul></td></tr><tr><td><strong><code>fileName</code></strong></td><td>string</td><td align="center">256</td><td align="center"></td><td></td><td>등록한 파일의 이름입니다.</td></tr></tbody></table>

### <mark style="color:blue;">menus</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="85">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>buttonType</code></strong></td><td>string</td><td align="center">20</td><td align="center">O</td><td></td><td><p>버튼 유형</p><p>"call", "web", "app", "store", "order", "buy", "tickets", "moreinfo"</p></td></tr><tr><td><a href="#applink-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>applink</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center"></td><td></td><td>APP Link의 패키지 Name, Action, URL 정보 객체입니다.</td></tr><tr><td><strong><code>weblink</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>buttonType call 을 제외한 모든 버튼은 Web URL을 입력해야 합니다. URL은 http:// 또는 https:// 로 시작하여야 합니다.</td></tr></tbody></table>

### <mark style="color:blue;">applink</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="158">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="81">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>packageName</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>App 실행을 위한 package name</td></tr><tr><td><strong><code>action</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>App 실행을 위한 Action</td></tr><tr><td><strong><code>uri</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>App 실행을 위한 URI</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz",
            "name": "더미브랜드308 - API 테스트",
            "brandKey": "BK.23v07bHR35Sc41q",
            "status": "승인대기(수정)",
            "chatbotDate": "2024-06-10T16:42:44.000+09",
            "messagebaseDate": "2024-06-07T11:11:10.000+09",
            "logoDate": null,
            "registerDate": "2024-06-07T11:11:10.000+09",
            "updateDate": "2024-06-11T17:31:31.000+09",
            "approvalDate": "2024-06-10T16:42:44.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-BR.0a81DDlZjz-POKn",
                    "fileName": "BR.275F8GY6nR-FD4DBi3W06i5.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/BR.0a81DDlZjz/LT-BR.0a81DDlZjz-POKn_1.png",
                    "typeName": "profile"
                }
            ],
            "menus": [
                {
                    "buttonType": "tickets",
                    "weblink": "http://www.naver.com",
                    "feedinfoYn": "N"
                }
            ],
            "description": "테스트 중 입니다. 수정 두했어요.",
            "tel": "30000800",
            "categoryId": "EDU",
            "categoryName": "교육",
            "subCategoryId": "EDU007",
            "subCategoryName": "유학/연수",
            "categoryOpt": null,
            "zipCode": "55110",
            "roadAddress": "서울특별시 송파구 송파대로 570 (신천동)",
            "detailAddress": "109-5",
            "email": "lng0415@naver.com",
            "webSiteUrl": "http://www.naver.com",
            "brandFeedUrl": null,
            "initTab": "INO",
            "initFeedItems": [],
            "templateColor": null,
            "bizInfoYn": "N",
            "bizInfoTitle": null,
            "bizInfoContent": null
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64345",
        "message": "invalid brand status."
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대행사 키 조회

## Request

## RBC에서 발급된 최종 대행사 키를 조회합니다.<br>

> RBC 에서 발급된 최종 대행사 키를 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  \
> \
> 대행사 키의 재발급, 삭제는 RBC 홈페이지에서만 가능합니다.  \
> 대행사 키 재발급 시,  \
> \
> &#x20; \+ 이전 대행사 키는 재발급 후 24시간 동안 유효하며, 24시간 경과 후 자동 삭제됩니다.  \
> \
> &#x20; \+ 대행사키의 유출이 우려되어 즉시 삭제를 원할 경우, RBC 웹사이트를 통해 직전 대행사키를 수동 삭제할 수 있습니다.  \
> &#x20;   이 경우 신규 대행사키로만 메시지 전송이 성공되며, 직전 대행사키로 메시지 전송 시 실패됩니다.  \
> &#x20;   ( 경로 : RBC대행사 계정 로그인 > 내 계정관리 > Agency Key )<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"AgencyId":{"name":"agencyId","in":"path","schema":{"type":"string","maxLength":20},"required":true,"description":"maxLength: 20 - RCS Biz Center에 등록된 대행사 ID 입니다.\n"}}},"paths":{"/agency/{agencyId}/agencyKey":{"get":{"summary":"RBC에서 발급된 최종 대행사 키를 조회합니다.\n","description":"RBC 에서 발급된 최종 대행사 키를 조회합니다.  \n\n  + **계정 권한: 대행사**  \n\n대행사 키의 재발급, 삭제는 RBC 홈페이지에서만 가능합니다.  \n대행사 키 재발급 시,  \n\n  + 이전 대행사 키는 재발급 후 24시간 동안 유효하며, 24시간 경과 후 자동 삭제됩니다.  \n\n  + 대행사키의 유출이 우려되어 즉시 삭제를 원할 경우, RBC 웹사이트를 통해 직전 대행사키를 수동 삭제할 수 있습니다.  \n    이 경우 신규 대행사키로만 메시지 전송이 성공되며, 직전 대행사키로 메시지 전송 시 실패됩니다.  \n    ( 경로 : RBC대행사 계정 로그인 > 내 계정관리 > Agency Key )\n","parameters":[{"$ref":"#/components/parameters/AgencyId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="119">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대행사 키 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="87">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>agencyKey</code></strong></td><td>string</td><td align="center">18</td><td align="center"></td><td></td><td>대행사 키 입니다.</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대행사키 등록일시 입니다.</td></tr><tr><td><strong><code>userName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대행사키 발급을 실행한 대상자 이름입니다.</td></tr><tr><td><strong><code>isSync</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대행사키 이통사 동기화 완료 여부</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "agencyKey": "AK.4bN4SIZ92g3ch3G",
            "userName": "system",
            "registerDate": "2024-06-10T11:26:16.000+09",
            "isSync": true
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대화방 등록 상태 확인

## Request

## 발신번호가 RBC에 대상 사업자의 발신번호로 등록되어 있는지 확인할 수 있습니다.<br>

> 발신번호가 RBC에 대상 사업자의 발신번호로 등록되어 있는지 확인할 수 있습니다.\
> \
> &#x20; \+ \*\*계정 권한: 대행사\*\*  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"AgencyId":{"name":"agencyId","in":"path","schema":{"type":"string","maxLength":20},"required":true,"description":"maxLength: 20 - RCS Biz Center에 등록된 대행사 ID 입니다.\n"},"CorpRegNum":{"name":"corpRegNum","in":"path","schema":{"type":"string","maxLength":10},"required":true,"description":"maxLength: 10 - 대상 기업의 사업자등록번호(10자리) 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}}},"paths":{"/agency/{agencyId}/corp/{corpRegNum}/chatbot/{chatbotId}":{"get":{"summary":"발신번호가 RBC에 대상 사업자의 발신번호로 등록되어 있는지 확인할 수 있습니다.\n","description":"발신번호가 RBC에 대상 사업자의 발신번호로 등록되어 있는지 확인할 수 있습니다.\n\n  + **계정 권한: 대행사**  \n","parameters":[{"$ref":"#/components/parameters/AgencyId"},{"$ref":"#/components/parameters/CorpRegNum"},{"$ref":"#/components/parameters/ChatbotId"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="121">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록 여부 확인 결과</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="205">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="80">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>corpRegNum</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>조회 요청한 사업자등록번호</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>조회 요청한 발신번호</td></tr><tr><td><strong><code>conditionValue</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td><p>발신번호 등록 여부 상태값</p><ul><li>0: RBC 미등록 발신번호</li><li>1: 해당 사업자로 등록된 발신번호</li><li>2: 해당 사업자로 등록된 발신번호가 아님</li></ul></td></tr><tr><td><strong><code>conditionDescription</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>conditionValue 에 대한 설명<br>"RBC 미등록 발신번호"</p><p>"해당 사업자로 등록된 발신번호"</p><p>"해당 사업자로 등록된 발신번호가 아님"</p></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "corpRegiNum": "3148158360",
            "chatbotId": "09046123177",
            "conditionValue": 1,
            "conditionDescription": "해당 사업자로 등록된 발신번호"
        }
    ],
    "status": 200
}

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "corpRegiNum": "3148158360",
            "chatbotId": "10008600",
            "conditionValue": 2,
            "conditionDescription": "해당 사업자로 등록된 발신번호가 아님"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 대행사 수신서버 URL

## Request

## 대행사에서 등록한 수신서버 URL을 통해 RBC에서 발생하는 데이터의 등록/수정/삭제 이벤트 정보를 전달합니다.<br>

> 대행사에서 등록한 수신서버 URL을 통해 RBC에서 발생하는 데이터의 등록/수정/삭제 이벤트 정보를 전달합니다.  \
> 등록/수정/삭제 알림 대상은 다음과 같습니다.  \
> &#x20; \+ 브랜드 계약(권한) 등록  \
> &#x20; \+ 브랜드 수정/반려  \
> &#x20; \+ 대화방 승인/수정/반려/삭제  \
> &#x20; \+ 템플릿 승인/수정/반려/삭제  \
> &#x20; \+ 자동응답메시지 등록/수정/삭제  \
> &#x20; \+ 신규 포멧/템플릿 상품 등록  \
> &#x20; \+ 대행사 키 재발급\
> &#x20; \+ 레아아웃 등록/수정/삭제\
> &#x20; \+ 로고 승인/수정/반려/삭제<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"WebhookUrl":{"name":"webhookUrl","in":"path","schema":{"type":"string"},"required":true,"description":"RBC에 등록된 대행사 계정 정보 상에 대행사가 직접 등록한 수신서버(Webhook) URL 정보입니다.\n"}},"schemas":{"NotiContract":{"description":"브랜드 운영 권한 Notification 입니다.\n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"contract"},"corpId":{"type":"string"},"corpRegNum":{"type":"string"},"brandId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.  \n\n  - rejected: 반려\n  - created: 승인 또는 신규등록\n  - modified: 수정\n  - deleted: 삭제\n","type":"string","enum":["rejected","created","modified","deleted"]},"reason":{"description":"\"method가 rejected 인 경우 사유를 제공합니다.\"\n","type":"string"}}},"NotiChatbot":{"description":"대화방 Notification 입니다.\n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"chatbot"},"brandId":{"type":"string"},"chatbotId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.  \n\n  - rejected: 반려\n  - created: 승인 또는 신규등록\n  - modified: 수정\n  - deleted': 삭제\n","type":"string","enum":["rejected","created","modified","deleted"]},"reason":{"description":"method가 rejected 인 경우 사유를 제공합니다.\n","type":"string"}}},"NotiMessagebaseForm":{"description":"템플릿 양식 Notification 입니다.  \n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"messagebaseform"},"messagebaseformId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.  \n\n  - rejected: 반려\n  - created: 승인 또는 신규등록\n  - modified: 수정\n  - deleted': 삭제\n","type":"string","enum":["rejected","created","modified","deleted"]},"reason":{"description":"\"method가 rejected 인 경우 사유를 제공합니다.\"\n","type":"string"}}},"NotiTemplate":{"description":"템플릿 Notification 입니다.  \n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"template"},"brandId":{"type":"string"},"messagebaseformId":{"type":"string"},"messagebaseId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.  \n\n  - rejected: 반려\n  - created: 승인 또는 신규등록\n  - modified: 수정\n  - deleted': 삭제\n","type":"string","enum":["rejected","created","modified","deleted"]},"reason":{"description":"method가 rejected 인 경우 사유를 제공합니다.\n","type":"string"}}},"NotiFormat":{"description":"포맷 Notification 입니다.  \n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"format"},"messagebaseformId":{"type":"string"},"messagebaseId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.  \n\n  - rejected: 반려\n  - created: 승인 또는 신규등록\n  - modified: 수정\n  - deleted': 삭제\n","type":"string","enum":["rejected","created","modified","deleted"]},"reason":{"description":"\"method가 rejected 인 경우 사유를 제공합니다.\"\n","type":"string"}}},"NotiBrand":{"description":"브랜드 Notification 입니다.\n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"brand"},"brandId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.  \n\n  - rejected: 반려\n  - modified: 수정\n","type":"string","enum":["rejected","modified"]},"reason":{"description":"method가 rejected 인 경우 사유를 제공합니다.\n","type":"string"}}},"NotiAutoReplyMsg":{"description":"자동응답 메시지 Notification 입니다.  \n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"autoreplymsg"},"brandId":{"type":"string"},"autoReplyMsgId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.  \n\n  - created: 신규등록 \n  - modified': 수정\n  - deleted: 삭제\n","type":"string","enum":["created","modified","deleted"]},"reason":{"description":"method가 rejected 인 경우 사유를 제공합니다.\n","type":"string"}}},"NotiAgencyKey":{"type":"object","description":"대행사 키가 재발급된 경우에 한하여 전달됩니다. 삭제 시에는 전송되지 않습니다.","required":["notiType","agencyKey"],"properties":{"notiType":{"description":"webhook 알림 타입 구분값 입니다.","type":"string","default":"agencykey"},"agencyKey":{"description":"재발급으로 새로 생성된 agencyKey 입니다.\n","type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.\n\n  - created: 재발급으로 새로운 agencyKey가 생성된 경우 표시됩니다.\n","type":"string","enum":["created"]},"date":{"description":"재발급 일시입니다..\n","type":"string"},"userName":{"description":"대행사 키를 재발급한 대행사 담당자의 이름입니다.\n","type":"string"}}},"NotiFormatBr":{"description":"브랜드 포맷(레이아웃) Notification 입니다.  \n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"formatbr"},"brandId":{"type":"string"},"messagebaseId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.  \n  - created: 승인 또는 신규등록\n  - modified': 수정\n  - deleted: 삭제\n","type":"string","enum":["rejected","created","modified","deleted"]},"reason":{"description":"method가 rejected 인 경우 사유를 제공합니다.\n","type":"string"}}},"NotiLogo":{"description":"브랜드 로고 Notification 입니다.  \n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","default":"logo"},"brandId":{"type":"string"},"fileId":{"type":"string"},"method":{"description":"대상별 처리 정보를 제공합니다.\n\n  - created: 승인 또는 신규등록\n  - rejected: 반려\n  - modified: 수정\n  - deleted': 삭제\n","type":"string","enum":["rejected","created","modified","deleted"]},"reason":{"description":"method가 rejected 인 경우 사유를 제공합니다.\n","type":"string"}}}}},"paths":{"/{webhookUrl}":{"post":{"summary":"대행사에서 등록한 수신서버 URL을 통해 RBC에서 발생하는 데이터의 등록/수정/삭제 이벤트 정보를 전달합니다.\n","description":"대행사에서 등록한 수신서버 URL을 통해 RBC에서 발생하는 데이터의 등록/수정/삭제 이벤트 정보를 전달합니다.  \n등록/수정/삭제 알림 대상은 다음과 같습니다.  \n  + 브랜드 계약(권한) 등록  \n  + 브랜드 수정/반려  \n  + 대화방 승인/수정/반려/삭제  \n  + 템플릿 승인/수정/반려/삭제  \n  + 자동응답메시지 등록/수정/삭제  \n  + 신규 포멧/템플릿 상품 등록  \n  + 대행사 키 재발급\n  + 레아아웃 등록/수정/삭제\n  + 로고 승인/수정/반려/삭제\n","parameters":[{"$ref":"#/components/parameters/WebhookUrl"}],"requestBody":{"description":"notiType에 설정된 다음의 대상 정보를 구분하여 Object를 제공합니다.\n\n  - contract: 브랜드 계약              \n  - chatbot: 대화방              \n  - messagebaseform: 템플릿 양식              \n  - template: 템플릿              \n  - format: 포멧(이통 제공 공통템플릿)              \n  - brand: 브랜드              \n  - autoreplymsg: 자동응답메시지              \n  - agencykey: 대행사 키\n  - formatbr: 브랜드에 등록된 레이아웃으로 만든 포멧  \n  - logo: 브랜드 로고\n","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/NotiContract"},{"$ref":"#/components/schemas/NotiChatbot"},{"$ref":"#/components/schemas/NotiMessagebaseForm"},{"$ref":"#/components/schemas/NotiTemplate"},{"$ref":"#/components/schemas/NotiFormat"},{"$ref":"#/components/schemas/NotiBrand"},{"$ref":"#/components/schemas/NotiAutoReplyMsg"},{"$ref":"#/components/schemas/NotiAgencyKey"},{"$ref":"#/components/schemas/NotiFormatBr"},{"$ref":"#/components/schemas/NotiLogo"}],"discriminator":{"propertyName":"notiType"}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="브랜드계약" %}

```
{
      "notiType": "contract",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="대화방" %}

```
{
      "notiType": "chatbot",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="템플릿양식" %}

```
{
      "notiType": "messagebaseform",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="템플릿" %}

```
{
      "notiType": "template",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="포멧" %}

```
{
      "notiType": "format",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="브랜드" %}

```
{
      "notiType": "brand",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="자동응답" %}

```
{
      "notiType": "autoreplymsg",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="대행사키" %}

```
{
      "notiType": "agencykey",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="레이아웃" %}

```
{
      "notiType": "formatbr",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}

{% tab title="로고" %}

```
{
      "notiType": "logo",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="88">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>200 : 성공적으로 알림을 수신하였을 경우 응답합니다.<br>400 : 대행사 측 청약이 우선 처리되지 않은 상태에서 'contract'가 전달된 경우 필히 응답되어야 합니다.</td></tr><tr><td><a href="#error-object"><mark style="color:blue;"><strong><code>error</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">error</mark> - object

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>message</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
  "status": "200",
  "error": {
    "code": "",
    "message": ""
  }
}
```

{% endtab %}

{% tab title="400" %}

```
{
  "status": "400",
  "error": {
    "code": "69999",
    "message": "No Subscription"
  }
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 양방향 중계사

이 문서는 중계사가 양방향 대화방의 대화 메뉴에 대한 API 정보를 안내합니다.


# 대화방 메뉴 사용 차단

## Request

## 중계사만 사용이 가능하며, 양방향 대화방의 대화방메뉴 사용을 중지 또는 재개합니다.<br>

> 양방향 대화방에 대화방메뉴 사용을 중지 또는 재개합니다.  \
> 양방향 대화방에 등록된 중계사만 사용이 가능합니다.  \
> 과금 미납 발생 등 특이사항이 발생한 경우 사용하며 대화방메뉴 중지에 대한 정보가 사용자에게 RBC 홈페이지에서 표시됩니다.  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}},"schemas":{"PausePersistentMenu":{"type":"object","properties":{"isPause":{"type":"boolean","description":"대화방메뉴 중지 여부","default":true}}}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}/persistentmenu/pause":{"put":{"summary":"중계사만 사용이 가능하며, 양방향 대화방의 대화방메뉴 사용을 중지 또는 재개합니다.\n","description":"양방향 대화방에 대화방메뉴 사용을 중지 또는 재개합니다.  \n양방향 대화방에 등록된 중계사만 사용이 가능합니다.  \n과금 미납 발생 등 특이사항이 발생한 경우 사용하며 대화방메뉴 중지에 대한 정보가 사용자에게 RBC 홈페이지에서 표시됩니다.  \n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PausePersistentMenu"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="대화방메뉴 중지 여부" %}

```
  "isPause": true
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="125">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방메뉴 사용을 중지여부</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="85">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방ID</td></tr><tr><td><strong><code>isPause</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>중지여부</td></tr><tr><td><strong><code>pausedDate</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td></td><td>isPause true 인 경우, 중지일시</td></tr><tr><td><strong><code>resumeDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>isPause false인 경우, 재개일시</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null
    "result": [
        {
            "chatbotId": "bot-aljr02btgnh",
            "isPause": true,
            "pausedDate": "2024-06-13T00:27:38.648Z",
            "resumeDate": "2024-06-13T00:27:38.648Z"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64360",
        "message": "chatbot is not bidirectional(twoway)"
    },
    "status": 400
}

{
    "error": {
        "code": "64385",
        "message": "This Menu dose not regist"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 양방향 중계사 수신서버 URL

## Request

## 양방향 서비스 제공 중계사에서 구현해야 하는 Webhook URI 입니다.<br>

> 양방향 서비스 제공 중계사에서 구현해야 하는 Webhook URI 입니다.\
> \
> RBC 대행사 정보의 수신서버 URL하위에 bidirctional 경로를 구현 제공해야 합니다.  \
> \
> 양방향 서비스 제공 중계사는 RBC에 등록되는 대행사의 양방향 메시지 중계사 지정, 양방향 대화방 등록, 대화방 메뉴 사용 시\
> 청약 여부와 같이 양방향 서비스 제공을 위해 필수 정보 연동이 필요합니다.  <br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"WebhookUrl":{"name":"webhookUrl","in":"path","schema":{"type":"string"},"required":true,"description":"RBC에 등록된 대행사 계정 정보 상에 대행사가 직접 등록한 수신서버(Webhook) URL 정보입니다.\n"}},"schemas":{"NotiBidirectional":{"description":"양방향 서비스와 관련된 양방향 중계사 전용 Notification 입니다.  \n","type":"object","required":["notiType"],"properties":{"notiType":{"type":"string","enum":["appointment","registration","subscription","persistentmenu"],"description":"+ appointment: 일반 대행사가 양방향 서비스 중계사 지정 알림\n+ registration: 양방향 대화방 등록 알림\n+ subscription: 대화방메뉴 사용 청약 확인 요청\n+ persistentmenu: 대화방메뉴 등록 알림\n"},"value":{"type":"object","properties":{"agencyCorpRegNum":{"type":"string","maxLength":10,"description":"maxLength: 10 - 대행사 사업자등록번호\n"},"agencyId":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대행사 ID\n"},"brandId":{"type":"string","maxLength":13,"description":"maxLength: 13 - 브랜드 ID\n"},"brandKey":{"type":"string","maxLength":18,"description":"maxLength: 18 - 브랜드 Key\n"},"chatbotId":{"type":"string","maxLength":15,"description":"maxLength: 15 - 대화방 ID\n"},"corpRegNum":{"type":"string","maxLength":10,"description":"maxLength: 10 - 기업 사업자등록번호\n"}}}}}}},"paths":{"/{webhookUrl}/bidirectional":{"post":{"summary":"양방향 서비스 제공 중계사에서 구현해야 하는 Webhook URI 입니다.\n","description":"양방향 서비스 제공 중계사에서 구현해야 하는 Webhook URI 입니다.\n\nRBC 대행사 정보의 수신서버 URL하위에 bidirctional 경로를 구현 제공해야 합니다.  \n\n양방향 서비스 제공 중계사는 RBC에 등록되는 대행사의 양방향 메시지 중계사 지정, 양방향 대화방 등록, 대화방 메뉴 사용 시\n청약 여부와 같이 양방향 서비스 제공을 위해 필수 정보 연동이 필요합니다.  \n","parameters":[{"$ref":"#/components/parameters/WebhookUrl"}],"requestBody":{"description":"notiType에 설정된 다음의 대상 정보를 구분하여 Object를 제공합니다.  \n\npersistentmenu는 registration의 의미를 포함하고 있습니다.  \n\n예를 들어, A중계사로 지정되어 있던 대화방메뉴를 갖는 양방향 대화방의 중계사를 B중계사로 변경한 경우, B중계사는\nregistration 수신 없이 persistentmenu를 수신하게 됩니다.  \n  \n- 'appointment': 일반 대행사가 양방향 서비스 중계사로 지정 알림\n  + 중계사는 대행사 지정에 대한 판단 후 성공(200) 또는 실패(404) 응답을 리턴하여야 함\n  \n  **[예시]**  \n  {\n    \"notiType\": \"appointment\",\n    \"value\": {\n      \"agencyCorpRegNum\": \"1148196221\"\n    }\n  }\n  \n- 'registration': 양방향 대화방 등록 알림 (agencyId는 RBC에 등록된 대행사 ID 이며, noti를\n받은 중계사를 지정한 대행사의 ID 또는 중계사의 ID) \n  + 양방향 대화방 생성 후 단순 통지, 중계사는 수신시 성공(200) 응답을 리턴하여야 함 \n\n  **[예시]**  \n  {\n    \"notiType\": \"registration\",\n    \"value\": {\n      \"agencyId\": \"noagency\",\n      \"brandId\": \"BR.Q63creSjku\",\n      \"brandKey\": \"BK.SD8X63r9uJaApN9\",\n      \"chatbotId\": \"bd_chatbot_v1\",\n      \"corpRegNum\": \"1148196221\"\n    }\n  }\n\n- 'subscription': 대화방메뉴 자동응답메시지 사용 청약 확인을 RBC가 중계사로 요청함  \n  + 중계사는 corpRegNum으로 대화방메뉴 자동응답메시지 사용 청약 여부를 확인 후 성공(200) 또는 실패(404) 응답을 리턴하여야 함\n  \n  **[예시]**  \n  {\n    \"notiType\": \"subscription\",\n    \"value\": {\n      \"agencyId\": \"noagency\",\n      \"brandId\": \"BR.Q63creSjku\",\n      \"brandKey\": \"BK.SD8X63r9uJaApN9\",\n      \"chatbotId\": \"bd_chatbot_v1\",\n      \"corpRegNum\": \"1148196221\"\n    }\n  }\n\n- 'persistentmenu': 대화방메뉴 등록 알림 (agencyId는 RBC에 등록된 대행사 ID 이며, noti를\n받은 중계사를 지정한 대행사의 ID 또는 중계사의 ID)\n  + 양방향 대화방 대화방메뉴 등록 후 단순 통지, 중계사는 수신시 성공(200) 응답을 리턴하여야 함\n\n  **[예시]**  \n  {\n    \"notiType\": \"persistentmenu\",\n    \"value\": {\n      \"agencyId\": \"noagency\",\n      \"brandId\": \"BR.Q63creSjku\",\n      \"brandKey\": \"BK.SD8X63r9uJaApN9\",\n      \"chatbotId\": \"bd_chatbot_v1\",\n      \"corpRegNum\": \"1148196221\"\n    }\n  }\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotiBidirectional"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="양방향 서비스 중계사 지정 알림" %}

```
{
    "notiType": "appointment",
    "value": {
        "agencyCorpRegNum": "1148196221"
    }
}
```

{% endtab %}

{% tab title="양방향 대화방 등록 알림" %}

```
{
    "notiType": "registration",
    "value": {
        "agencyId": "noagency",
        "brandId": "BR.Q63creSjku",
        "brandKey": "BK.SD8X63r9uJaApN9",
        "chatbotId": "bd_chatbot_v1",
        "corpRegNum": "1148196221"
    }
}
```

{% endtab %}

{% tab title="대화방메뉴 사용 청약 확인 요청" %}

```
{
    "notiType": "subscription",
    "value": {
        "agencyId": "noagency",
        "brandId": "BR.Q63creSjku",
        "brandKey": "BK.SD8X63r9uJaApN9",
        "chatbotId": "bd_chatbot_v1",
        "corpRegNum": "1148196221"
    }
}
```

{% endtab %}

{% tab title="대화방메뉴 등록 알림" %}

```
{
    "notiType": "persistentmenu",
    "value": {
        "agencyId": "noagency",
        "brandId": "BR.Q63creSjku",
        "brandKey": "BK.SD8X63r9uJaApN9",
        "chatbotId": "bd_chatbot_v1",
        "corpRegNum": "1148196221"
    }
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="82">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>200 : 성공적으로 알림을 수신하였을 경우 응답합니다.<br>400 : 대행사 측 청약이 우선 처리되지 않은 상태에서 'contract'가 전달된 경우 필히 응답되어야 합니다.</td></tr><tr><td><mark style="color:blue;"><strong><code>error</code></strong></mark></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">error</mark> - object

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="83">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr><tr><td><strong><code>message</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
  "status": "200",
  "error": {
    "code": "",
    "message": ""
  }
}
```

{% endtab %}

{% tab title="400" %}

```
{
  "status": "400",
  "error": {
    "code": "69999",
    "message": "No Subscription"
  }
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}


# 에러코드

### RCS Biz Center - Response body error code

```json
{
    "error": {
        "code": "60004",
        "message": "No Content"
    },
    "status": 204
}
```

* 204 error code

{% hint style="warning" %}
request 처리 결과는 성공적이나 제공할 데이터가 없는 경우 응답됩니다.

60004 "No Content" : 요청을 성공적으로 처리했으나 데이터가 없음
{% endhint %}

* 400 error code

{% hint style="warning" %}
잘못된 Request에 대하여 응답됩니다. 요구되는 헤더가 누락되거나 Request에 필요한 데이터 누락/오류 등에 해당하는 경우 응답됩니다.

64001 "Missing X-RCS-BrandKey header" : 헤더에 브랜드 키가 없습니다.\
64002 "Invalid Brand Key" : 잘못된 브랜드 키 입니다.\
64101 "Invalid brandId on path parameter" : 브랜드ID 파라미터 값이 없습니다.\
64102 "Invalid agencyId on path parameter" : 대행사ID 파라미터 값이 없습니다.\
64103 "Invalid corpRegNum on path parameter" : 잘못된 사업자 등록번호 입니다.\
64104 "Invalid personId on path parameter" : 잘못된 personId 입니다.\
64105 "Invalid chatbotId on path parameter" : 잘못된 chatbotId 입니다.\
64106 "Invalid messagebaseId on path parameter" : 잘못된 messagebaseId 입니다.\
64107 "Invalid messagebaseformId on path parameter" : 잘못된 messagebaseformId 입니다.\
64108 "Invalid autoReplyMsgId on path parameter" : 잘못된 autoReplyMsgId 입니다.\
64109 "Invalid fileId on path parameter" : 잘못된 fileId 입니다.\
64202 "Invalid query parameter value %s" : 쿼리 파라미터의 값이 잘못되었습니다. (%s)\
64203 "query parameter required \[%s]" : 요청 파라미터가 존재하지 않습니다.\
64301 "Missing Body data" : BODY 데이터 값이 없습니다.\
64302 "Invalid JSON format" : JSON 형식이 잘못 되었습니다.\
64305 "Missing Certification document" : 통신서비스 이용증명원 파일이 누락되었습니다.\
64306 "Exceed MDN registration quantity" : 등록 허용 MDN 개수를 초과하였습니다.\
64308 "Invalid MDN format" : 유효하지 않은 MDN 형식 입니다.\
64309 "Missing chatbot name" : 대화방명 값이 없습니다.\
64310 "Invalid display format" : 유효하지 않은 display 형식 입니다.\
64311 "Invalid rcsReply format" : 유효하지 않은 rcsReply 형식 입니다.\
64313 "Invalid messagebaseformId" : 알 수 없는 messagebaseformId 입니다.\
64315 "Missing brandId" : 브랜드 ID가 누락되었습니다.\
64316 "Invalid brandId" : 알 수 없는 브랜드 ID 입니다.\
64317 "Invalid agencyId" : 알 수 없는 대행사 ID 입니다.\
64318 "Invalid formattedString format %s" : 잘못된 포맷스트링 입니다. %s\
64319 "Duplicate MDN : \[%s]" : 이미 등록된 발신번호 입니다. \[%s]\
64320 "Duplicate messagebaseId" : 중복된 템플릿 ID 입니다.\
64321 "Invalid approval status" : 현재 수정 또는 삭제 할 수 없는 상태입니다.\
64322 "file does not exist" : 파일이 존재하지 않습니다.\
64323 "No changes" : 변경된 내용이 없습니다.\
64324 "Invalid custTmpltId format" : 잘못된 템플릿 아이디 입니다.\
64325 "Invalid chatbot service type" : 유효하지 않은 대화방 서비스 유형 입니다.\
64326 "Invalid chatbot webhook format" : 챗봇의 웹훅 형식이 잘못되었습니다.\
64327 "Not allowed delete" : 삭제 할 수 없습니다.\
64328 "Not allowed modification" : 수정 할 수 없습니다.\
64329 "Missing profile image" : 프로필 이미지가 누락되었습니다.\
64331 "brand profile / background image file is up to 1Mb" : 브랜드 프로필/백그라운드 이미지는 최대 1메가까지 등록 가능 합니다.\
64332 "brand profile file is only png" : 브랜드 프로필 이미지는 png 파일만 가능합니다.\
64334 "image property does not match file extension" : 등록된 파일의 확장자가 파일 형식과 다릅니다.\
64335 "only files of minimum size (388X388px) and maximum size (1080X1080px) can be uploaded." : 최소 388X388px, 최대 1080X1080px 사이즈의 파일만 업로드 가능합니다.\
64336 "required value: \[%s]" : 필수 값 확인이 필요합니다.: \[%s]\
64337 "invalid value: \[%s]" : 존재하지 않거나 유효하지 않은 값: \[%s]\
64338 "invalid value: \[%s], %s" : 유효하지 않은 값: \[%s], %s\
64339 "value is too long: \[%s], maxsize is %s" : 허용 값 초과: \[%s], maxsize is %s\
64341 "Duplicate MDN in chatbots : \[%s]" : 발신번호가 중복되었습니다. \[%s]\
64343 "%s must be key/value pairs. check the %s" : %s 은(는) 키/값 으로 구성 되어야 합니다. %s 를 확인하세요.\
64345 "invalid brand status." : 유효하지 않은 브랜드 상태 입니다.\
64346 "user not found: %s" : 사용자를 찾을 수 없습니다. \[%s]\
64348 "%s is already registered." : 이미 등록된 값 입니다. \[%s]\
64350 "Templateform not found." : 템플릿폼을 찾을 수 없습니다.\
64351 "%s exists. need to delete all %s before deleting the brand." : %s 이 처리 중 또는 존재 합니다. %s 처리 완료 및 삭제 후 브랜드 삭제가 가능합니다.\
64353 "%s is temporarily unavailable." : 현재 지원하지 않는 기능입니다.\
64354 "Attached file capacity overflow" : %sMB 이하의 파일만 업로드 할 수 있습니다.\
64355 "Not allowed file extension" : 허용되지 않는 파일 확장자입니다.\
64357 "Invalid body format \[%s]" : BODY 형식이 잘못 되었습니다. \[%s]\
64358 "Invalid buttons format \[%s]" : 버튼 형식이 잘못 되었습니다. \[%s]\
64359 "Invalid chipList format \[%s]" : 칩리스트 형식이 잘못 되었습니다. \[%s]\
64361 "chatbotId does not match subnum" : 대화방ID와 회신번호가 일치하지 않습니다.\
64363 "botAgencyId dose not found." : 중계사 정보를 찾을 수 없습니다.\
64364 "Invalid inputField format" : 유효하지 않은 메시지입력란 형식 입니다.\
64366 "chabotId is duplicated" : 중복된 챗봇ID 입니다.\
64367 "Used by Twoway Chatbot \[%s]" : 양방향대화방에서 사용중인 자동응답은 삭제 불가 합니다. ( %s )\
64369 "Missing chatbotId" : 대화방ID 값이 없습니다.\
64373 "Invalid chatbotId format" : 유효하지 않은 대화방ID 형식 입니다.\
64377 "Invalid\_menu\_format \[%s]" : 대화방 메뉴 형식이 올바르지 않습니다. \[%s]\
64378 "Failed to confirm subscription status" : 청약 확인에 실패했습니다.\
64380 "This Agency is not support chat service" : 양방향 서비스를 지원하지 않는 대행사 입니다.\
64381 "Invalid subnum format" : 유효하지 않은 회신번호 형식 입니다.\
64382 "The contracted information could not be found" : 계약정보를 찾을 수 없습니다.\
64383 "the value of subnum does not exist or is not valid" : 회신번호 대화방이 없거나 상태가 올바르지 않습니다.\
64384 "Duplicated PostbackId \[%s]" : 포스트백 아이디가 중복 되었습니다. \[%s]\
64392 "botAgencyId does not match userId" : 중계사 정보와 일치하지 않습니다.\
64394 "brand profile / background image must be 1:1 ratio" : 브랜드의 프로필 이미지와 백그라운드 이미지는 1:1 비율이어야 합니다.\
64395 "file is up to %sMb" : 파일은 최대 %sMB까지 업로드 가능합니다.\
64396 "check file extension (%s)" : 파일 확장자를 확인해주세요. (%s)\
64397 "invalid body %s" : 잘못된 템플릿 body 입니다.\
64398 "must be entered in pairs, following:%s / required:%s" : %s와 %s는 같이 입력되어야 합니다.\
64399 "there is no value for image size (param:%s, fileId:%s)" : 이미지 크기에 대한 값이 없습니다. (param:%s, fileId:%s)\
64400 "required %sx%s, image resolution is %sx%s (param:%s, fileId:%s)" : %sx%s 규격의 이미지가 업로드 되어야 합니다. 업로드된 이미지는 %sx%s 입니다.\
64401 "file's total capacity is up to %sMb, attached capacity: %sMb" : 파일의 총 용량은 최대 %sMB 입니다. 첨부된 용량은 %sMB 입니다.\
64402 "check subnum display status" : 회신번호가 비전시상태 입니다.\
64404 "can not deleted chatbot. check the bidirectional(twoway) chatbot status" : 해당 대화방은 삭제할 수 없습니다.\
64405 "before approval, the display value cannot be modified" : 승인 전에는 전시 여부를 수정할 수 없습니다.\
64407 "check bidirectional(twoway) status" : 미사용 처리 대상 대화방(연결된 대화방) 상태가 올바르지 않습니다.\
64409 "invalid paging number" : 유효하지 않는 페이징 번호 입니다.\
64410 "the paging start number is invalid" : 페이징 시작 번호가 유효하지 않습니다.\
64411 "the file upload path is incorrect" : 파일 업로드 경로가 잘못 되었습니다.\
64413 "file information does not exist" : 파일 정보가 존재하지 않습니다.\
64414 "the file cannot be deleted" : 파일을 삭제 할 수 없습니다.\
64440 "There are no accounts matching the information you entered." : 입력하신 정보와 일치하는 계정이 없습니다.\
64443 "the calling number is duplicate or incorrect" : 발신번호가 중복이거나 올바르지 않습니다.\
64446 "There is no company information matching the information you entered." : 입력하신 정보와 일치하는 기업정보가 없습니다.\
64452 "brand not found" : 입력하신 정보와 일치하는 브랜드정보가 없습니다.\
64453 "violates integrity constraints DB.PK" : 무결성 제약 조건(DB.PK)에 위배됩니다.\
64454 "There is no template information that matches the information you entered." : 입력하신 정보와 일치하는 템플릿정보가 없습니다.\
64455 "There is an error in the input information of the file you registered." : 등록하신 파일의 입력 정보에 오류가 있습니다.\
64456 "template id is duplicated" : 템플릿ID가 중복되었습니다.\
64473 "there is no template form information available" : 사용가능한 템플릿 폼 정보가 없습니다.\
64478 "there are duplicate numbers in excel" : 엑셀내에 중복번호가 있습니다.\
64487 "default templates cannot be modified or deleted" : 기본 템플릿은 수정 또는 삭제 할 수 없습니다.\
64488 "approved templates cannot be modified" : 승인 된 템플릿은 수정 할 수 없습니다.\
64517 "Currently, automatic response information cannot be modified or deleted." : 현재 자동응답정보는 수정 또는 삭제 할 수 없는 상태입니다.\
64520 "there is an error in the content" : 내용에 오류가 있습니다.\
64522 "there is an error in the file : %s" : 파일에 오류가 있습니다. : %s\
64523 "there is an error in the variable" : 변수에 오류가 있습니다.\
64525 "there are items under review" : 검수 중인 항목이 있습니다.\
64526 "It's already been processed." : 이미 처리 되었습니다.\
64529 "The reply number is not displayed." : 회신번호가 비전시상태 입니다.\
64532 "There is no relay information." : 중계사 정보가 없습니다.\
64533 "There is no relay company receiving server URL information." : 중계사 수신서버 URL 정보가 없습니다.\
64534 "Subscription information not found." : 청약 정보를 찾을 수 없습니다.\
64536 "Invalid approval parameter value" : 유효하지 않은 상태 파라미터 값 입니다.\
64539 "Used by AutoReplyMsg Button \[%s]" : 사용중인 자동응답 버튼이 있습니다. \[%s]\
64541 "The AutoReplyMsg button is not valid." : 자동응답 연결 버튼이 유효하지 않습니다.\
64542 "Duplicate invitation email." : 중복된 초대 메일 입니다.\
64545 "Invalid layoutId" : 레이아웃 정보가 없습니다.\
64546 "Invalid product code" : 상품코드 정보가 없습니다.\
64549 "The bodyComposition is required." : 레이아웃의 바디 영역은 필수 입력요소 입니다.\
64550 "Only one component is available for headerComposition." : 헤더 영역에는 하나의 컴포넌트만 사용 가능합니다.\
64552 "%s component is not available for %s." : 이 컴포넌트는 해당 영역에 올 수 없습니다.\
64600 "Invalid Component Id" : 컴포넌트 아이디가 잘못되었습니다.\
64601 "Only one component is available for footerComposition." : 풋터 영역에는 하나의 컴포넌트만 사용 가능합니다.\
64603 "Invalid sampleLayoutId" : 샘플 레이아웃 ID가 아닙니다.\
64604 "Different components that belong to the same groupComponentId cannot be used together." : 같은 그룹 컴포넌트는 하나만 쓸 수 있습니다.\
64606 "only one size (300x300px) can be uploaded." : 300x300px 사이즈의 파일만 업로드 가능합니다.\
64607 "The maximum number of logos allowed: %s" : 로고는 최대 %s개까지 등록 가능합니다.\
64608 "invalid template status (%s)" : 템플릿 상태를 체크하세요.\
64612 "There is no RCS MO Message Webhook URL information." : 중계사 양방향 대화방 수신 URL 정보가 없습니다.\
64617 "This is a account whose season has ended." : 시즌이 종료된 기업 계정입니다.\
64619 "can not modify display status that have been blocked by an admin." : 시스템 및 운영자가 비전시 처리한 대화방은 전시 처리할 수 없습니다.\
64624 "\[%s] must begin with a fixed text." : \[%s] 은 고정부로 시작되어야 합니다.\
64629 "Template productCode cannot be changed." : 템플릿 상품 코드를 변경할 수 없습니다.
{% endhint %}

* 401 error code

{% hint style="warning" %}
인증에 필요한 정보가 누락되거나 값이 잘못된 경우 응답됩니다.

61001 "Missing Authorization header Authorization"\
61002 "Missing Token Authorization"\
61003 "Invalid token "\
61004 "Token has expired"\
61005 "Invalid client id"\
61006 "Invalid secret key"\
61007 "not allowed IP. unregistered %s"
{% endhint %}

* 403 error code

{% hint style="warning" %}
대상에 대한 접근 권한이 없는 경우 응답됩니다.

63001 "No Brand Permission"\
63002 "No Permission"
{% endhint %}


# 변경이력

**1.1.17 변경 사항(2026년 5월 14일 배포)**

* &#x20;브랜드 내 가장 최근 업데이트된 자동응답메시지 일자 정보 추가(autoreplymsgDate)
  * [브랜드 목록 조회](/rbc-api/brand/get_brand_list#result-array-less-than-object-greater-than)
  * [브랜드 상세 조회](/rbc-api/brand/get_brand_detail#result-array-less-than-object-greater-than)
  * [브랜드 수정](/rbc-api/brand/put_brand#result-array-less-than-object-greater-than)
  * [대행사 브랜드 목록 조회](/rbc-api/agency/get_contract_list#result-array-less-than-object-greater-than)
  * [대행사 브랜드 기업단위 목록 조회](/rbc-api/agency/get_corp_brand_list#result-array-less-than-object-greater-than)
  * [대행사 브랜드 상세 조회](/rbc-api/agency/get_brand_detail#result-array-less-than-object-greater-than)
  * [대행사 브랜드 수정](/rbc-api/agency/put_brand#result-array-less-than-object-greater-than)

**1.1.16 변경 사항(2026년 4월 20일 배포)**

* &#x20;자동응답메시지 통합RCS 규격 전환 관련 내용 업데이트
  * [자동응답메시지 등록](/rbc-api/autoreplymsg/post_autoreplymsg)
  * [자동응답메시지 수정](/rbc-api/autoreplymsg/put_autoreplymsg)
  * [자동응답메시지 상세 조회](/rbc-api/autoreplymsg)

**1.1.15 변경 사항(2025년 7월 31일 배포)**

* 브랜드 정보 내 전화번호(tel) 필드에 설정된 값은 더 이상 사용되지 않으므로 등록/수정 시 입력된 값 무시

  * 변경 이전  등록된 tel 은 브랜드 정보 상세 조회 시 표시
  * [브랜드 등록 승인 요청](/rbc-api/brand/post_brand#regbrand)

  <figure><img src="https://612615354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd84oUZux8rbfQrKjV98I%2Fuploads%2FehVm5Cc43Sgx9HOXPmPb%2Fimage.png?alt=media&amp;token=91f1cfe1-8e0d-4c89-b8a6-5eab57200535" alt=""><figcaption></figcaption></figure>
* 브랜드 홈 소식 탭 메뉴 표시 대상(initFeedItems) 설정  항목 중call 제외,  등록/수정 시 입력할 경우 무시

  * 변경 이전 등록된 call은 브랜드 상세 조회 시 표시
  * [브랜드 등록 승인 요청](/rbc-api/brand/post_brand#regbrand)

  <figure><img src="https://612615354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd84oUZux8rbfQrKjV98I%2Fuploads%2FVEPAVbtct7UgSm6tgSUC%2Fimage.png?alt=media&amp;token=bdbf5613-00b7-4fd6-9ea4-f4f64084dc7f" alt=""><figcaption></figcaption></figure>

**1.1.14 변경 사항(2025년 5월 28일 배포)**

* 템플릿 등록/수정 시 viewAll(모두보기) 접힘 기준 글자수 설정 규격(viewAll) 추가

  * [템플릿 양식 상세 조회](/rbc-api/template/get_form_detail#params-array-less-than-object-greater-than)
  * [템플릿 상세 조회](/rbc-api/template/get_template_detail#params-array-less-than-object-greater-than)
  * [템플릿 등록\_V2](/rbc-api/template/post_template_v2#post-brand-brandid-v2-messagebase)
  * [템플릿 수정\_V2](/rbc-api/template/put_template_v2#put-brand-brandid-v2-messagebase-messagebaseid)

  <figure><img src="https://612615354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd84oUZux8rbfQrKjV98I%2Fuploads%2FQPSl4AKFw0fAEhknuYhk%2Fimage.png?alt=media&amp;token=15f743ce-5948-4f67-bf74-b1f514239b12" alt=""><figcaption></figcaption></figure>
* 레이아웃 등록/수정 시 viewAll(모두보기) 접힘 기준 글자수 설정 규격(viewAll) 추가

  * [샘플 레이아웃 상세 조회](/rbc-api/layout/get_sample_layout_detail#options-object-2)
  * [레이아웃 상세 조회](/rbc-api/layout/get_layout_detail#options-object-2)
  * [레이아웃 등록](/rbc-api/layout/post_layout#request)
  * [레이아웃 수정](/rbc-api/layout/put_layout#request)

  <figure><img src="https://612615354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd84oUZux8rbfQrKjV98I%2Fuploads%2FWki8K14OyBfESZHWLDff%2Fimage.png?alt=media&amp;token=7c5a0044-f8e8-41e5-b0c0-3c2f2ac11586" alt=""><figcaption></figcaption></figure>

**1.1.13 변경 사항(2024년 12월 19일 배포)**

* 템플릿 등록/수정 시 viewAll(모두보기) 제어 규격(setViewAll) 추가

  * [템플릿 양식 상세 조회](/rbc-api/template/get_form_detail#params-array-less-than-object-greater-than)
  * [템플릿 상세 조회](/rbc-api/template/get_template_detail#params-array-less-than-object-greater-than)
  * [템플릿 등록\_V2](/rbc-api/template/post_template_v2#request)
  * [템플릿 수정\_V2](/rbc-api/template/put_template_v2#request)

  <figure><img src="https://612615354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd84oUZux8rbfQrKjV98I%2Fuploads%2FTEJaiy7wn27ridRwoopr%2Fimage.png?alt=media&amp;token=513df412-d10d-41a0-bfb0-f11a08efd488" alt=""><figcaption></figcaption></figure>
* 레이아웃 등록/수정 시 viewAll(모두보기) 제어 규격(ctrlViewAll) 추가

  * [컴포넌트 목록 조회](/rbc-api/layout/get_component_list#options-object-2)
  * [샘플 레이아웃 상세 조회](/rbc-api/layout/get_sample_layout_detail#options-object-2)
  * [레이아웃 상세 조회](/rbc-api/layout/get_layout_detail#options-object-2)
  * [레이아웃 등록](/rbc-api/layout/post_layout#request)
  * [레이아웃 수정](/rbc-api/layout/put_layout#request)

  <figure><img src="https://612615354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd84oUZux8rbfQrKjV98I%2Fuploads%2FFSwoSs4AZWJeO0jqtgDz%2Fimage.png?alt=media&amp;token=e07b1317-f188-4511-9076-92f6dcc9de7a" alt=""><figcaption></figcaption></figure>

**1.1.12 추가 변경 사항(2024년 11월 21일 배포)**

* 브랜드 등록/수정 API의 Request.body 내 seasonDocFile 규격 추가

  * [브랜드 등록 승인 요청](/rbc-api/brand/post_brand#corp-brand)
  * [반려 브랜드 등록 재승인 요청](/rbc-api/brand/put_rejected_brand#corp-brand-brandid)
  * [브랜드 수정 승인 요청](/rbc-api/brand/put_brand#corp-personid-brand-brandid)
  * [대행사 브랜드 수정](/rbc-api/agency/put_brand#agency-agencyid-brand-brandid)

  <div align="left"><figure><img src="https://612615354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd84oUZux8rbfQrKjV98I%2Fuploads%2F8zoQ5l39tXahUwDUlZjB%2Fimage.png?alt=media&amp;token=31b19a64-1dee-4fb9-a893-bf6845668369" alt=""><figcaption></figcaption></figure></div>

**1.1.12 추가 변경 사항(2024년 9월 26일 배포)**

* 브랜드 상세 정보 내 안심마크 지정 여부 정보 추가
  * 기업  브랜드 상세 조회 API 응답 결과 [브랜드 상세 조회](/rbc-api/brand/get_brand_detail#result-array-less-than-object-greater-than) 내 **`saftyStatusYn`** 추가
  * 대행사 브랜드 상세 조회 API 응답 결과 [대행사 브랜드 상세 조회](/rbc-api/agency/get_brand_detail#result-array-less-than-object-greater-than) 내 **`saftyStatusYn`** 추가

**1.1.12 주요 변경 사항**

* RBC 기본 아이콘 및 브랜드 로고 신규 API 추가 신규로고 API
  * 브랜드 로고는 승인 후 사용 가능
  * GET /logo/common : RBC 제공 기본 아이콘 조회
  * GET /brand/{brandId}/logo : 브랜드 로고 조회
  * POST /brand/{brandId}/logo : 브랜드 로고 등록
  * GET /brand/{brandId}/logo/{fileId} : 브랜드 로고 단건 조회
  * PUT /brand/{brandId}/logo/{fileId} : 브랜드 로고 수정
  * DELETE /brand/{brandId}/logo/{fileId} : 브랜드 로고 단건 삭제
  * PUT /brand/{brandId}/logo/{fileId}/cancel : 브랜드 로고 승인요청 취소
* 템플릿 또는 메시지 발송 시, 변수 mTitleMedia, itemMedia 에 사용할 이미지는 브랜드 로고(logo) 등록 후 발급된 fileId를 지정해야 합니다.
* 브랜드 로고 추가에 따른 Webhook Noti 추가
  * notiType logo 추가 스키마

**1.1.11 주요 변경사항**

* 고객반응 메시지/대화방메뉴 통계 제공 필드 추가
  * GET /statQuery/message/{brandId} 응답 결과 내 messagebaseId 필드 추가 > 관련 스키마 MessageStatData
  * GET /statQuery/messageButton/{brandId} 응답 결과 내 reactionType, cardNum, buttonNum 필드 추가 > 관련 스키마 MessageButtonStatData
  * GET /statQuery/persistentMenu/{brandId} 응답 결과 내 자동응답메시지인 경우, messagebaseId, reactionType, cardNum, buttonNum 필드 추가 > 관련 스키마 PersistentMenuStatData.menuList.subList
  * 동영상 스트리밍 actionType 구분 iframeplayB 추가

**1.1.10 주요 변경사항**

* 계정, 권한 구분 용어 변경
  * 기업관리자 : 마스터
  * 기업담당자 : 매니저
  * 브랜드 관리자 : 대표운영자
  * 브랜드 부관리자 : 운영자
  * 브랜드 대행사 : 운영자
* 브랜드 생성 권한 확대 : 마스터, 매니저 계정
* 브랜드 수정 권한 확대 : 브랜드 대표운영자(마스터), 브랜드 운영자(마스터, 매니저, 대행사)
* 브랜드 영업정보, 브랜드 컬러 등 추가 설정 사항
* 대화방 안심마크 표시 여부 설정
* 양방향 대화방 전환, 양방향 대행사 설정 없는 botId 대화방 등록
* 양방향 대행사 설정 없는 대화방메뉴 등록/수정
* 텍스트 템플릿 타이틀 선택형의 아이콘 이미지 변경
  * 아이콘 이미지 변경으로 formattedString 상의 fileId 변경
* 자동응답메시지 간 연결(버튼, 칩리스트)
* 자동응답메시지, 대화방메뉴 브랜드 소식 연결
* 대행사 대상 레이아웃 기능
* 신규 템플릿 상품 지원(규격 변경 사항 없음)
* 신규 또는 기능 추가/변경된 API
  * POST /corp/brand
  * PUT /corp/brand/{brandId}
  * PUT /corp/{personId}/brand/{brandId}
  * GET /corp/{personId}/brand/{brandId}
  * DELETE /corp/{personId}/brand/{brandId}
  * DELETE /corp/{personId}/brand/{brandId}/privilege
  * POST /brand/{brandId}/chatbot
  * GET /brand/{brandId}/chatbot
  * PUT /brand/{brandId}/chatbot/{chatbotId}
  * GET /brand/{brandId}/chatbot/{chatbotId}
  * GET /brand/{brandId}/bidirectional/chatbot
  * POST /brand/{brandId}/bidirectional/chatbot
  * PUT /brand/{brandId}/bidirectional/chatbot/{chatbotId}
  * GET /brand/{brandId}/bidirectional/chatbot/{chatbotId}
  * DELETE /brand/{brandId}/bidirectional/chatbot/{chatbotId}
  * POST /brand/{brandId}/autoreplymsg
  * PUT /brand/{brandId}/autoreplymsg/{autoReplyMsgId}
  * POST /brand/{brandId}/bidirectional/chatbot/{chatbotId}/persistentmenu
  * PUT /brand/{brandId}/bidirectional/chatbot/{chatbotId}/persistentmenu
  * (신규) PUT /corp/brand/{brandId}/cancel
  * (신규) PUT /corp/{personId}/brand/{brandId}/cancel
  * (신규) PUT /agency/{agencyId}/brand/{brandId}
  * (신규) GET /messagebase/messagebaseform/{messagebaseformId}/logo
  * (신규) GET /baselayout/component
  * (신규) GET /baselayout/sample
  * (신규) GET /baselayout/sample/{sampleLayoutId}
  * (신규) GET /baselayout/product/rule
  * (신규) GET /brand/{brandId}/layout
  * (신규) POST /brand/{brandId}/layout
  * (신규) GET /brand/{brandId}/layout/{layoutId}
  * (신규) PUT /brand/{brandId}/layout/{layoutId}
  * (신규) DELETE /brand/{brandId}/layout/{layoutId}

**1.1.9 추가 변경사항(2023.03.16 변경 사항)**

* 대화방 승인 취소 API 추가
  * PUT /brand/{brandId}/chatbot/{chatbotId}/cancel
* 대화방명 변경 시 운영자 검수 승인 필요
  * POST /brand/{brandId}/bidirectional/chatbot/{chatbotId} 발신번호 양방향 대화방 전환 시 대화방명 수정된 경우
  * POST /brand/{brandId}/bidirectional/chatbot/{chatbotId} 대화방ID 양방향 대화방의 대화방명
  * PUT /brand/{brandId}/chatbot/{chatbotId} 발신번호 대화방명 수정 시
  * PUT /brand/{brandId}/bidirectional/chatbot/{chatbotId} 양방향 대화방 대화방명 수정 시
* 브랜드 채널 노출/검색 허용에 따른 대화방(chatbot) API display value 허용값 변경
  * '11' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 전시
  * '10' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 비전시
  * '01' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 전시
  * '00' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 비전시

**1.1.9 추가 변경사항**

* 메시지 보안성 강화 agencyKey API 추가
  * GET /agency/{agencyId}/agencyKey
  * RBC 홈페이지에서 agencyKey 재발급시 Webhook noti 전송(notiType agencyKey)
* 양방향 대화방 ID 정책변경에 따라 service 구분이 'CHAT'인 대화방ID(chatbotId)의 포맷 규칙이 변경
  * POST /brand/{brandId}/bidirectional/chatbot
  * GET /usableQuery/chatbotId/{chatbotId}
* 브랜드 등록 시 브랜드 홈 기본 탭 선택 항목 추가
  * POST /corp/brand
  * properties 추가: initTab, initFeedItem
  * 추가 항목은 별도 지정하지 않더라도 기본값으로 처리됨

**1.1.8 추가 변경사항(2022.12.08 상용 배포)**

* 대화방ID 등록 가능여부 조회 API 추가
  * GET /usableQuery/chatbotId/{chatbotId}
  * 대화방ID 등록 전 등록 가능여부 조회

**1.1.8 변경사항**

* 이미지 템플릿 추가에 따른 신규 템플릿 등록 API 추가
  * 이미지 템플릿 및 모든 템플릿 등록 시 사용 가능 ( api/1.1 지원, api/1.0 미지원 )
  * 이미지 템플릿용 파일 등록 POST /brand/{brandId}/v2/messagebase/file
  * 이미지 템플릿용 파일 상세 조회 GET /brand/{brandId}/v2/messagebase/file/{fileId}
  * 템플릿 등록(v2) POST /brand/{brandId}/v2/messagebase
  * 템플릿 수정(v2) POST /brand/{brandId}/v2/messagebase/{messagebaseId}
* 타이틀 자유형(구 테마 강조형A) Description 우측 타이틀 허용
  * 타이틀 자유형의 타이틀 영역 중 우측 타이틀 영역에 Cell 템플릿과 마찬가지로 본문과 버튼에 설정한 변수부 중 1개를 설정할 수 있도록 변경

**1.1.7 변경사항**

* 타이틀 자유형(구 테마 강조형A) 템플릿 messagebaseform 조회 지원
  * 타이틀 자유형(구 테마 강조형A) Description, Cell
* 타이틀 자유형(구 테마 강조형A) 템플릿 messagebase 조회/등록/수정/삭제 지원
  * 타이틀 자유형(구 테마 강조형A) 등록 JSON 예시 추가(POST /brand/{brandId}/messagebase)
  * 타이틀 자유형(구 테마 강조형A) 조회 시 버튼 정보 표시 방식 변경(신규 openrichcard 규격)
* 대행사용 API 추가
  * RBC 등록된 사업자 확인 GET /agency/{agencyId}/corp/{corpRegNum}
  * RBC 에 등록된 발신번호 확인 GET /agency/{agencyId}/corp/{corpRegNum}/chatbot/{chatbotId}
* 고객반응통계 조회 API 수정
  * 대화방 메뉴 자동응답메시지 설정 정책 변경에 따른 Data Object 구조 변경
  * 대상 API GET /statQuery/persistentMenu/{brandId}
* 양방향 대화방 메뉴 설정 정책 변경 반영
  * 하위 메뉴 자동응답메시지 설정 허용
  * 액션 버튼 설정 dialerAction 만 가능(지정 불가 액션 버튼 - urlAction, mapAction, calendarAction, clipboardAction, composeAction, localBrowserAction)

**1.1.6 변경사항**

* 고객반응통계 조회 API 추가
  * 캠페인 발송/읽음확인 통계 GET /statQuery/message/{brandId}
  * 캠페인 메시지 버튼 클릭 통계 GET /statQuery/messageButton/{brandId}
  * 대화방 메뉴 클릭 통계 GET /statQuery/persistentMenu/{brandId}
* 신규 공통템플릿 정보 추가
  * 규격 상의 변경점은 없으며 추가된 공통템플릿 정보 데이터 제공되도록 변경함
  * GET /messagebase/common
  * GET /messagebase/common/{messagebaseId}

**1.1.5 변경사항**

* \[주의] 신규 추가된 API는 /api/1.1 만 지원됨
* Brand 정보 내 브랜드 소식 URL 정보 추가
  * botFeedUrl (브랜드 소식 등록 시 자동 추가)
* 양방향 대화방 API 추가
  * POST, GET /brand/{brandId}/bidirectional/chatbot
  * PUT, DELETE, GET /brand/{brandId}/bidirectional/chatbot/{chatbotId}
  * POST, PUT, DELETE /brand/{brandId}/bidirectional/chatbot/{chatbotId}/persistentmenu
  * POST, GET /brand/{brandId}/autoreplymsg
  * PUT, DELETE, GET /brand/{brandId}/autoreplymsg/{autoReplyMsgId}
  * POST /brand/{brandId}/autoreplymsg/file
  * GET /brand/{brandId}/autoreplymsg/file/{fileId}
* 양방향 대화방 중계사 연동 Webhook 추가
  * POST /{webhookUrl}/bidirectional
  * PUT /brand/{brandId}/bidirectional/chatbot/{chatbotId}/persistentmenu/pause
* 대행사 Noti webhook NotiType 추가
  * 자동응답메시지(notiType: autoreplymsg)

**1.1.4 추가 변경사항**

* 템플릿 승인 후 수정 허용
  * 기승인 템플릿의 내용 수정 허용(수정 시 재승인 필요)
  * 수정 허용에 따른 approvalResult 제공 값 변경
* 템플릿 승인요청 취소 API 추가
  * PUT /brand/{brandId}/messagebase/{messagebaseId}/cancel
  * approvalResult가 승인대기, 승인대기(수정) 인 경우만 취소 가능
* 템플릿 승인상태 구분 추가 : 검수시작, 검수시작(수정), 승인대기(수정), 반려(수정), 검수완료(수정)
* 대화방 승인상태 구분 추가 : 검수시작
* 브랜드 승인상태 구분 추가 : 검수시작, 검수시작(수정)
* 스타일(Cell) 템플릿 formattedString 구성 시 textStyle 허용값 중 italic 제외(예, bold|italic 설정 시 bold 로 처리됨)

**1.1.3 추가 변경사항**

* 브랜드 상세조회 제공 항목 추가(2021/02/25)
  * fileName - 업로드 된 파일의 이름
  * approvalReason - 검수 시 반려 사유
* 브랜드 상세조회/수정/삭제 API 추가
  * PUT /corp/brand/{brand}
  * GET /corp/{personId}/brand/{brandId}
  * PUT /corp/{personId}/brand/{brandId}
  * DELETE /corp/{personId}/brand/{brandId}
  * POST /corp/{personId}/brand/{brandId}/privilege
  * PUT /corp/{personId}/brand/{brandId}/privilege
  * GET /corp/{personId}/brand/{brandId}/privilege
  * DELETE /corp/{personId}/brand/{brandId}/privilege/{id}
* 기업/대행사/규격서 버전별 API 분류(TAG)
* 템플릿 API 등 설명 내용 보완
* **2020년 12월 3일 기준 브랜드 등록 항목 menus 중 app 은 이통사 정책에 의거 한시적으로 등록이 불가하며 app 등록 시 error 리턴됩니다.**
* 브랜드 상태 구분 추가 : 승인대기(수정), 반려(수정), 검수완료(수정)

**1.1.2 변경사항**

* 브랜드 등록 API 추가
  * 기업관리자 계정으로만 등록 가능
  * 브랜드 등록 시 입력되는 카테고리1, 2 정보 조회 API 추가
  * GET /corp/brand/categories
  * POST /corp/brand

**1.1.1 변경사항**

* GuideInfo 내 리치카드용 세부 정보 추가
  * GET /messagebase/common/{messagebaseId} 조회 상세 정보 중 guideInfo.detailInfo 추가
  * 리치카드를 이용하여 발송된 RCS 메시지가 단말에서 표시될 경우 잘림 없이 표시 가능한 조건 정보 제공을 위하여 추가

**1.1.0 변경사항**

* API 1.0, 1.1 버전 병행 지원 - 이후 일부 개선 사항은 API 1.0에 제공이 불가 할 수 있으므로 1.1 버전 사용 권장
* ContractInfo.regDate, ContractInfo.modDate Key Name 변경\
  -> ContractInfo.registerDate, ContractInfo.updateDate
* 각 API별 Response Body의 result key의 type을 array로 통일하였으며 변경된 API는 다음과 같음
  * GET /agency/{agencyId}/brand/{brandId}
  * GET /messagebase/common
  * GET /messagebase/common/{messagebaseId}
  * GET /messagebase/messagebaseform/{messagebaseformId}
  * POST /brand/{brandId}/messagebase
  * GET /brand/{brandId}/messagebase
  * GET /brand/{brandId}/messagebase/{messagebaseId}
  * PUT /brand/{brandId}/messagebase/{messagebaseId}
  * DELETE /brand/{brandId}/messagebase/{messagebaseId}
  * POST /brand/{brandId}/chatbot
  * GET /brand/{brandId}/chatbot
  * GET /brand/{brandId}/chatbot/{chatbotId}
  * PUT /brand/{brandId}/chatbot/{chatbotId}
  * DELETE /brand/{brandId}/chatbot/{chatbotId}

**2020.07.07 수정사항**

* BrandInfo 내 제공 정보 추가
  * brandKey : API를 이용하여 브랜드Key 확인 가능
  * chatbotDate : 브랜드 하위 대화방 데이터 최종 변경 일시 정보
  * messagebaseDate : 브랜드 하위 템플릿 최종 변경 일시 정보
* Get List API Pagination 기능 추가
  * Query 파라미터를 이용하여 전체를 페이징하여 조회하도록 제공
  * offset : 조회 기준 ROW (default = 0)
  * limit : offset 으로부터 조회되는 건수 제한(default = 100, max = 1000)
  * Response body 내 pagination, links 제공
* messagebaseform 조회시 bizCondition 정보가 코드로 표시되는 문제 수정

**2020.05.19 수정사항**

* 대행사-브랜드 계약 정보인 ContractInfo 내에 key 추가
  * GET /agency/{agencyId}/contract
  * GET /agency/{agencyId}/corp/{corpRegNum}/brand
  * 추가 Key : brandDate, chatbotDate, messagebaseDate
  * 브랜드, 해당 브랜드 하위 대화방/템플릿 데이터의 최종 변경 일시 정보를 제공하여 상세 조회 이전에 변경사항 여부를 판단할 수 있도록 개선

**2020.03.12 수정사항**

* date-time 예시 추가

**2020.02.19 수정사항**

* ParamInfo 내 isMandatory 추가

**2020.02.11 수정사항**

* GET /brand/{brandId}/chatbot Chatbots 를 chatbots로 수정

**2020.02.07 수정사항**

* Widget, WidgetPolicy 설명 추가
* API 문의처 정보 추가
* POST /brand/{brandId}/chatbot 시 rcsReply 필수 입력 추가(2/13 상용 적용)

**2020.01.06 수정사항**

* API 서버 구분 추가

**2019.12.17 수정사항**

* X-RCS-Brandkey의 format 변경 (uuid -> random key)

**2019.11.25 수정사항**

* 템플릿, 발신번호(대화방) UPDATE, DELETE Method 처리가능 상태 설명 추가
* 전체 200 OK 응답 형식 수정
* chatbot UPDATE시 profileImage 삭제
* chatbot UPDATE시 통신서비스이용증명원 업로드 추가

**2019.11.19 수정사항**

* messagebaseform의 bizService 오타 수정
* BrandInfo.mediaUrl 추가
* ChabotDetail.mediaUrl 추가

**2019.11.05 수정사항**

* RegChatbotInfo.smsMo 삭제
* ChatbotDetail 수정
  * smsMo 삭제, rcsReply 추가
  * rcsReply default 1(RCS Postback 수신)

**2019.10.29 수정사항**

* {webhookUrl} NotiTemplate.brandId 추가
* chatbot Attributes 설명 수정

**2019.10.23 수정사항**

* {webhookUrl} 설명 내용 수정
  * Brand Key 제공 내용 삭제
  * nType을 notiType으로 명칭 변경
* webhook notification에 대한 대행사 return code 추가
* messagebase, messagebaseform 의 formattedString type string에서 object로 변경
* messagebaseform의 bizCondition type을 string 에서 array로 변경
* messagebaseform 상세 조회시 양식 유형 이미지 링크 제공
  * MessagebaseFormInfo.mediaUrl 추가

**2019.10.02 RCS Biz Center API 1.0.1 배포**


# 참고문서

\+ [**버튼 Action 목록 Link (2023.12.14)**](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)

\+ [**RCS A2P(단방향) 포맷 리스트 (24.02.07 공유버전)**](https://file-qa.rcsbizcenter.com/240319170900114/TS-240319170900114-segSiw_1.xlsx)

\+ [**RCS 양방향 포맷 리스트 (22.10.28 공유 버전)**](https://file-qa.rcsbizcenter.com/221027084901492/TS-221027084901492-mIfP_1.xlsx)


# 브랜드 소식 Open API

## **RCS Biz Center Brand Feed API Version 1.0.1**

본 문서는 기업과 대행사에 제공되는 RCS Biz Center 브랜드 소식 API의 규격을 기술합니다.

브랜드 소식 API의 사용을 위해서는 사전에 RCS Biz Center에 기업/대행사 등록 및 브랜드 등록이 필요합니다.

추가적인 보안을 위해 API를 연동하는 Client의 IP 를 RCS Biz Center에 사전 등록하여야 합니다.

RCS Biz Center 홈페이지 "내 정보관리"에서 등록하실 수 있습니다.

API를 연동하고자 하는 경우 검수(STG) 환경에 가입 및 승인 후 사전 개발 진행할 수 있도록 제공하고 있습니다.

1. 검수(STG) - <https://api-qa.rcsbizcenter.com/bfapi/1.0>
2. 상용(PRD) - <https://api.rcsbizcenter.com/bfapi/1.0>

RCS Biz Center 에서 제공하는 API는 이통 3사가 정의한 정책에 의거하여 정보를 제공합니다. 따라서 일부 정보 제공 상의 제약이 있을 수 있습니다.

#### <mark style="color:blue;">☎</mark> **API 문의처 : 1522-5739 / <tech@rcsbizcenter.com>**


# 브랜드 소식

이 문서는 브랜드 소식에 대한 API를 안내합니다.




---

[Next Page](/llms-full.txt/1)