> For the complete documentation index, see [llms.txt](https://apidocs.rcsbizcenter.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.rcsbizcenter.com/rbc-api/history.md).
# 변경이력
**1.1.17 변경 사항(2026년 5월 14일 배포)**
* 브랜드 내 가장 최근 업데이트된 자동응답메시지 일자 정보 추가(autoreplymsgDate)
* [브랜드 목록 조회](/rbc-api/brand/get_brand_list.md#result-array-less-than-object-greater-than)
* [브랜드 상세 조회](/rbc-api/brand/get_brand_detail.md#result-array-less-than-object-greater-than)
* [브랜드 수정](/rbc-api/brand/put_brand.md#result-array-less-than-object-greater-than)
* [대행사 브랜드 목록 조회](/rbc-api/agency/get_contract_list.md#result-array-less-than-object-greater-than)
* [대행사 브랜드 기업단위 목록 조회](/rbc-api/agency/get_corp_brand_list.md#result-array-less-than-object-greater-than)
* [대행사 브랜드 상세 조회](/rbc-api/agency/get_brand_detail.md#result-array-less-than-object-greater-than)
* [대행사 브랜드 수정](/rbc-api/agency/put_brand.md#result-array-less-than-object-greater-than)
**1.1.16 변경 사항(2026년 4월 20일 배포)**
* 자동응답메시지 통합RCS 규격 전환 관련 내용 업데이트
* [자동응답메시지 등록](/rbc-api/autoreplymsg/post_autoreplymsg.md)
* [자동응답메시지 수정](/rbc-api/autoreplymsg/put_autoreplymsg.md)
* [자동응답메시지 상세 조회](/rbc-api/autoreplymsg.md)
**1.1.15 변경 사항(2025년 7월 31일 배포)**
* 브랜드 정보 내 전화번호(tel) 필드에 설정된 값은 더 이상 사용되지 않으므로 등록/수정 시 입력된 값 무시
* 변경 이전 등록된 tel 은 브랜드 정보 상세 조회 시 표시
* [브랜드 등록 승인 요청](/rbc-api/brand/post_brand.md#regbrand)
* 브랜드 홈 소식 탭 메뉴 표시 대상(initFeedItems) 설정 항목 중call 제외, 등록/수정 시 입력할 경우 무시
* 변경 이전 등록된 call은 브랜드 상세 조회 시 표시
* [브랜드 등록 승인 요청](/rbc-api/brand/post_brand.md#regbrand)
**1.1.14 변경 사항(2025년 5월 28일 배포)**
* 템플릿 등록/수정 시 viewAll(모두보기) 접힘 기준 글자수 설정 규격(viewAll) 추가
* [템플릿 양식 상세 조회](/rbc-api/template/get_form_detail.md#params-array-less-than-object-greater-than)
* [템플릿 상세 조회](/rbc-api/template/get_template_detail.md#params-array-less-than-object-greater-than)
* [템플릿 등록\_V2](/rbc-api/template/post_template_v2.md#post-brand-brandid-v2-messagebase)
* [템플릿 수정\_V2](/rbc-api/template/put_template_v2.md#put-brand-brandid-v2-messagebase-messagebaseid)
* 레이아웃 등록/수정 시 viewAll(모두보기) 접힘 기준 글자수 설정 규격(viewAll) 추가
* [샘플 레이아웃 상세 조회](/rbc-api/layout/get_sample_layout_detail.md#options-object-2)
* [레이아웃 상세 조회](/rbc-api/layout/get_layout_detail.md#options-object-2)
* [레이아웃 등록](/rbc-api/layout/post_layout.md#request)
* [레이아웃 수정](/rbc-api/layout/put_layout.md#request)
**1.1.13 변경 사항(2024년 12월 19일 배포)**
* 템플릿 등록/수정 시 viewAll(모두보기) 제어 규격(setViewAll) 추가
* [템플릿 양식 상세 조회](/rbc-api/template/get_form_detail.md#params-array-less-than-object-greater-than)
* [템플릿 상세 조회](/rbc-api/template/get_template_detail.md#params-array-less-than-object-greater-than)
* [템플릿 등록\_V2](/rbc-api/template/post_template_v2.md#request)
* [템플릿 수정\_V2](/rbc-api/template/put_template_v2.md#request)
* 레이아웃 등록/수정 시 viewAll(모두보기) 제어 규격(ctrlViewAll) 추가
* [컴포넌트 목록 조회](/rbc-api/layout/get_component_list.md#options-object-2)
* [샘플 레이아웃 상세 조회](/rbc-api/layout/get_sample_layout_detail.md#options-object-2)
* [레이아웃 상세 조회](/rbc-api/layout/get_layout_detail.md#options-object-2)
* [레이아웃 등록](/rbc-api/layout/post_layout.md#request)
* [레이아웃 수정](/rbc-api/layout/put_layout.md#request)
**1.1.12 추가 변경 사항(2024년 11월 21일 배포)**
* 브랜드 등록/수정 API의 Request.body 내 seasonDocFile 규격 추가
* [브랜드 등록 승인 요청](/rbc-api/brand/post_brand.md#corp-brand)
* [반려 브랜드 등록 재승인 요청](/rbc-api/brand/put_rejected_brand.md#corp-brand-brandid)
* [브랜드 수정 승인 요청](/rbc-api/brand/put_brand.md#corp-personid-brand-brandid)
* [대행사 브랜드 수정](/rbc-api/agency/put_brand.md#agency-agencyid-brand-brandid)
**1.1.12 추가 변경 사항(2024년 9월 26일 배포)**
* 브랜드 상세 정보 내 안심마크 지정 여부 정보 추가
* 기업 브랜드 상세 조회 API 응답 결과 [브랜드 상세 조회](/rbc-api/brand/get_brand_detail.md#result-array-less-than-object-greater-than) 내 **`saftyStatusYn`** 추가
* 대행사 브랜드 상세 조회 API 응답 결과 [대행사 브랜드 상세 조회](/rbc-api/agency/get_brand_detail.md#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 배포**