# 템플릿 등록 요청 ## Request 브랜드 내에서 사용할 텍스트 템플릿을 등록합니다.\ POST /brand/{brandId}/v2/messagebase 를 이용하면 모든 유형의 템플릿을 등록할 수 있습니다.
----------------------------------------------------------------------- > 브랜드 내에서 사용할 텍스트 템플릿을 등록합니다. \ > 등록된 템플릿은 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 단위 제거 할 수 있음 \ > 단, 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)은 템플릿 내 정의된 변수만 입력 가능(예시 참조) \ > \ > \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\ > \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\ > \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형)\*\*
```json {"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.12"},"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
필드명타입길이필수여부기본값설명
resultarray<object>O등록된 템플릿ID(= messagebaseId)
codestring5O20000000
statusinteger3O200
descstringO
### result - array\
필드명타입길이필수여부기본값설명
messagebaseIdstringO등록된 템플릿ID(= messagebaseId)
### ❖ 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](https://apidocs.rcsbizcenter.com/error_code#rcs-biz-center-response-body-error-code) 참조 {% endhint %}