템플릿 등록_V2

Request

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

post

/brand/{brandId}/v2/messagebase

브랜드 내에서 사용할 템플릿을 등록합니다.

모든 템플릿 등록이 가능하며, 템플릿 등록 시 사용되는 messagebaseformId의 params의 각 항목 중 템플릿에 표시될 내용을 입력하여 원하는 템플릿을 등록할 수 있습니다.

등록된 템플릿은 RCS Biz Center 운영자의 승인이 필요합니다.

계정 권한: 마스터, 매니저, 대행사
브랜드 권한: 브랜드 대표운영자, 운영자
지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿

Authorizations

AuthorizationstringRequired

인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.

Path parameters

brandIdstring · max: 13Required

maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.

Header parameters

X-RCS-Brandkeystring · max: 18Optional

maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.

대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.

Body

템플릿 등록 시 사용되는 Object 입니다.

brandIdstring · max: 13Required

maxLength: 13 - 브랜드ID

messagebaseformIdstring · max: 10Required

maxLength: 10 - 템플릿 양식 ID

custTmpltIdstring · max: 25Required

maxLength: 25 - 사용자 지정 템플릿ID로 영문/숫자 25자 이내만 가능

tmpltNamestring · max: 40Required

maxLength: 40 - 템플릿명

agencyIdstring · max: 20Optional

maxLength: 20 - 대행사ID

Responses

200

페이지 내 Response 섹션 참조

No content

post

/brand/{brandId}/v2/messagebase

POST /api/1.1/brand/{brandId}/v2/messagebase HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 420

{
  "brandId": "text",
  "messagebaseformId": "text",
  "custTmpltId": "text",
  "tmpltName": "text",
  "agencyId": "text",
  "body": [
    {
      "param": "text",
      "value": "text",
      "setViewAll": true,
      "viewAll": 150,
      "decoration": {
        "textSize": "text",
        "textAlignment": "textStart",
        "textStyle": "bold",
        "textColor": "text"
      }
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "displayText": "text",
            "postback": {
              "data": "text"
            },
            "urlAction": {
              "openUrl": {
                "url": "https://example.com"
              }
            }
          }
        }
      ]
    }
  ]
}

200

페이지 내 Response 섹션 참조

No content

❖ request body sample

{
  "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"
            }
          }
        },
        {}
      ]
    }
  ]
}

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

{
  "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": "{{이것}}의 긍정적인 부분은 이 숫자 역시 빠르게 회복 중이라는 것"
    }
  ]
}{

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

{
  "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": []
}

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

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

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

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

{
  "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": []
}

Response

필드명

타입

길이

필수여부

기본값

설명

result

array<object>

등록된 템플릿ID(= messagebaseId)

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

messagebaseId

string

등록된 템플릿ID(= messagebaseId)

❖ response body sample

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

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

error code는 RCS Biz Center - Response body error code 참조

Previous템플릿 삭제 Next템플릿 수정_V2

Last updated 7 months ago

Was this helpful?