브랜드 템플릿 업데이트
작성일 2026.03.09 | 수정일 2026.03.09
PUT
/kakao/v2/brand-templates/:brandTemplateIdParameters
brandTemplateId— 수정할 브랜드 템플릿 ID
기존에 등록된 브랜드 템플릿의 내용을 수정합니다.
템플릿 이름, 본문, 이미지, 버튼 등 대부분의 속성을 변경할 수 있습니다. 단, biz 서비스에 등록되어 있고 ACTIVE 상태인 템플릿만 업데이트가 가능하며, 구체적으로는 codes 배열에 service가 biz이고 status가 ACTIVE인 코드가 존재해야 합니다. name을 입력하지 않으면 기존 이름이 자동으로 유지됩니다.
chat
브랜드 템플릿 객체를 반환합니다. 응답 구조는 공통 응답 스키마를 참고하세요.
Body Params
Structure
Request
{
"chatBubbleType": "CAROUSEL_COMMERCE",
"name": "수정된 쇼핑 안내",
"content": null,
"adult": false,
"header": "수정된 특가 상품",
"imageId": "IMG01_UPDATED",
"imageLink": "https://example.com/event-updated",
"additionalContent": "수정된 부가정보입니다.",
"carousel": {
"head": {
"header": "수정된 특가",
"content": "최대 60% 할인",
"imageId": "IMG_HEAD01_UPDATED",
"linkPc": "https://example.com/sale-updated",
"linkMobile": "https://m.example.com/sale-updated",
"linkAndroid": "exampleapp://sale-updated",
"linkIos": "exampleapp://sale-updated"
},
"list": [
{
"header": "상품 A (수정)",
"content": "수정된 상품 A 설명",
"additionalContent": "한정 수량 50개",
"imageId": "IMG_ITEM01_UPDATED",
"imageLink": "https://example.com/product/a-updated",
"commerce": {
"title": "프리미엄 상품 A",
"regularPrice": "50000",
"discountPrice": "30000",
"discountRate": "40",
"discountFixed": "20000"
},
"buttons": [
{
"name": "구매하기",
"linkType": "WL",
"linkMobile": "https://m.example.com/product/a",
"linkPc": "https://example.com/product/a",
"linkAndroid": null,
"linkIos": null
}
],
"coupon": {
"title": "수정된 쿠폰",
"description": "10% 추가 할인",
"linkMobile": "https://m.example.com/coupon/a",
"linkPc": "https://example.com/coupon/a",
"linkAndroid": null,
"linkIos": null
}
},
{
"header": "상품 B (수정)",
"content": "수정된 상품 B 설명",
"additionalContent": null,
"imageId": "IMG_ITEM02_UPDATED",
"imageLink": "https://example.com/product/b-updated",
"commerce": {
"title": "프리미엄 상품 B",
"regularPrice": "30000",
"discountPrice": "20000",
"discountRate": "33",
"discountFixed": "10000"
},
"buttons": [
{
"name": "구매하기",
"linkType": "WL",
"linkMobile": "https://m.example.com/product/b",
"linkPc": "https://example.com/product/b",
"linkAndroid": null,
"linkIos": null
}
],
"coupon": null
}
],
"tail": {
"linkPc": "https://example.com/products-updated",
"linkMobile": "https://m.example.com/products-updated",
"linkAndroid": "exampleapp://products-updated",
"linkIos": "exampleapp://products-updated"
}
},
"mainWideItem": {
"title": "수정된 메인 상품",
"imageId": "IMG_WIDE01_UPDATED",
"linkMobile": "https://m.example.com/main-updated",
"linkPc": "https://example.com/main-updated",
"linkAndroid": "exampleapp://main-updated",
"linkIos": "exampleapp://main-updated"
},
"subWideItemList": [
{
"title": "수정된 서브 상품 1",
"imageId": "IMG_WIDE02_UPDATED",
"linkMobile": "https://m.example.com/sub1-updated",
"linkPc": "https://example.com/sub1-updated",
"linkAndroid": null,
"linkIos": null
}
],
"video": {
"videoUrl": "https://example.com/video/intro-updated.mp4",
"imageId": "IMG_THUMB01_UPDATED"
},
"commerce": {
"title": "수정된 상품",
"regularPrice": "50000",
"discountPrice": "30000",
"discountRate": "40",
"discountFixed": "20000"
},
"buttons": [
{
"name": "수정된 버튼",
"linkType": "WL",
"linkMobile": "https://m.example.com/updated",
"linkPc": "https://example.com/updated",
"linkAndroid": "exampleapp://updated",
"linkIos": "exampleapp://updated"
}
],
"coupon": {
"title": "수정된 쿠폰",
"description": "15% 할인",
"linkMobile": "https://m.example.com/coupon-updated",
"linkPc": "https://example.com/coupon-updated",
"linkAndroid": "exampleapp://coupon-updated",
"linkIos": "exampleapp://coupon-updated"
}
}