브랜드 템플릿 목록 조회
작성일 2026.03.09 | 수정일 2026.03.09
GET
/kakao/v2/brand-templates/Query
name— 브랜드 템플릿 이름 (지원 연산자: eq, ne, like)
pfId— 플러스친구 아이디
pfGroupId— 플러스친구 그룹 아이디
brandTemplateId— 브랜드 템플릿 아이디
chatBubbleType— 채팅 버블 타입
status— 템플릿 상태 (ACTIVE, INACTIVE, DELETED)
startKey— 페이징 시작 키
limit— 조회 개수 제한
dateCreated— 생성일 필터 (지원 연산자: eq, gte, lte, gt, lt)
dateUpdated— 수정일 필터 (지원 연산자: eq, gte, lte, gt, lt)
현재 계정에 등록된 브랜드 템플릿의 목록을 조회합니다. 채널별, 상태별, 버블 타입별로 필터링할 수 있으며, 페이지네이션을 지원합니다.
Response
브랜드 템플릿 객체 리스트를 반환합니다. 자세한 사항은 공통 응답 스키마를 참조해주세요
Structure
Response
{
"brandTemplateList": [
{
"brandTemplateId": "KA01BP240101000000001",
"accountId": "AC01000000000001",
"name": "테스트 텍스트 템플릿",
"pfId": "PF01",
"pfGroupId": null,
"assignType": "CHANNEL",
"chatBubbleType": "TEXT",
"content": "안녕하세요 #{이름}님",
"header": null,
"imageId": null,
"imageLink": null,
"additionalContent": null,
"adult": false,
"allowCopy": false,
"isDeleted": false,
"buttons": [],
"coupon": null,
"carousel": null,
"mainWideItem": null,
"subWideItemList": [],
"video": null,
"commerce": null,
"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"
}
]
}