브랜드 메시지 템플릿
작성일 2026.03.05 | 수정일 2026.03.09
브랜드 템플릿의 등록, 조회, 수정, 삭제 및 복사를 위한 API 레퍼런스입니다.
브랜드 템플릿은 알림톡 템플릿과 달리 검수 절차 없이 바로 사용할 수 있는 브랜드 메시지 전용 템플릿으로, 다양한 버블 타입(텍스트, 이미지, 와이드, 캐러셀, 커머스, 프리미엄 비디오 등)을 지원합니다.
공통 응답 스키마
대부분의 브랜드 템플릿 API는 아래 구조의 브랜드 템플릿 객체를 응답으로 반환합니다.
Structure
{
"brandTemplateId": "KA01BP240101000000001",
"accountId": "AC01000000000001",
"name": "프리미엄 쇼핑 안내",
"pfId": "PF01",
"pfGroupId": null,
"assignType": "CHANNEL",
"chatBubbleType": "CAROUSEL_COMMERCE",
"content": null,
"header": "오늘의 특가 상품",
"imageId": "IMG01",
"imageLink": "https://example.com/event",
"additionalContent": "자세한 내용은 홈페이지를 참고하세요.",
"adult": false,
"allowCopy": true,
"isDeleted": false,
"buttons": [
{
"name": "홈페이지 바로가기",
"linkType": "WL",
"linkMobile": "https://m.example.com",
"linkPc": "https://example.com",
"linkAndroid": "exampleapp://main",
"linkIos": "exampleapp://main"
}
],
"coupon": {
"title": "신규 가입 쿠폰",
"description": "10% 할인",
"linkMobile": "https://m.example.com/coupon",
"linkPc": "https://example.com/coupon",
"linkAndroid": "exampleapp://coupon",
"linkIos": "exampleapp://coupon"
},
"carousel": {
"head": {
"header": "이번 주 특가",
"content": "최대 50% 할인 상품을 만나보세요",
"imageId": "IMG_HEAD01",
"linkPc": "https://example.com/sale",
"linkMobile": "https://m.example.com/sale",
"linkAndroid": "exampleapp://sale",
"linkIos": "exampleapp://sale"
},
"list": [
{
"header": "상품 A",
"content": "인기 상품 A를 특가로 만나보세요",
"additionalContent": "한정 수량 100개",
"imageId": "IMG_ITEM01",
"imageLink": "https://example.com/product/a",
"commerce": {
"title": "프리미엄 상품 A",
"regularPrice": "50000",
"discountPrice": "35000",
"discountRate": "30",
"discountFixed": "15000"
},
"buttons": [
{
"name": "구매하기",
"linkType": "WL",
"linkMobile": "https://m.example.com/product/a",
"linkPc": "https://example.com/product/a",
"linkAndroid": null,
"linkIos": null
}
],
"coupon": {
"title": "상품 A 전용 쿠폰",
"description": "5% 추가 할인",
"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",
"imageLink": "https://example.com/product/b",
"commerce": {
"title": "프리미엄 상품 B",
"regularPrice": "30000",
"discountPrice": "25000",
"discountRate": "17",
"discountFixed": "5000"
},
"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",
"linkMobile": "https://m.example.com/products",
"linkAndroid": "exampleapp://products",
"linkIos": "exampleapp://products"
}
},
"mainWideItem": {
"title": "메인 상품 안내",
"imageId": "IMG_WIDE01",
"linkMobile": "https://m.example.com/main",
"linkPc": "https://example.com/main",
"linkAndroid": "exampleapp://main",
"linkIos": "exampleapp://main"
},
"subWideItemList": [
{
"title": "서브 상품 1",
"imageId": "IMG_WIDE02",
"linkMobile": "https://m.example.com/sub1",
"linkPc": "https://example.com/sub1",
"linkAndroid": null,
"linkIos": null
},
{
"title": "서브 상품 2",
"imageId": "IMG_WIDE03",
"linkMobile": "https://m.example.com/sub2",
"linkPc": "https://example.com/sub2",
"linkAndroid": null,
"linkIos": null
}
],
"video": {
"videoUrl": "https://example.com/video/intro.mp4",
"imageId": "IMG_THUMB01"
},
"commerce": {
"title": "프리미엄 상품 A",
"regularPrice": "50000",
"discountPrice": "35000",
"discountRate": "30",
"discountFixed": "15000"
},
"codes": [
{
"code": "CODE01",
"status": "ACTIVE",
"service": "biz",
"isMain": true
}
],
"variables": [
{
"name": "이름"
}
],
"dateCreated": "2024-01-01T00:00:00.000Z",
"dateUpdated": "2024-01-01T00:00:00.000Z"
}