브랜드 메세지 개인화 필드

1. 채널 타입별 개인화 가능 영역

채널 타입	개인화 가능 영역	대응 필드명
텍스트 / 이미지 / 와이드 이미지형	내용	content
	버튼별 URL	buttons
	쿠폰	coupon
와이드 아이템 리스트형	헤더 텍스트, 아이템 리스트	content
	버튼별 URL	buttons
	쿠폰	coupon
캐러셀 피드형	캐러셀 피드	carousel
비디오형	헤더, 내용	content
	버튼	buttons
	쿠폰	coupon
커머스형	부가 정보(텍스트 등)	content
	상품명, 상품가격	commerce
	버튼	buttons
	쿠폰	coupon
캐러셀 커머스형	인트로(상단 영역)	content
	캐러셀 커머스	carousel_commerce
	더보기 버튼	content

---

2. 개인화 필드 Payload

필드명	타입	설명	관련 JSON 스펙
content	json	본문, 헤더, 부가정보 등 텍스트 및 콘텐츠 영역
coupon	json	쿠폰 정보 (할인 금액/율 등)	[2-1. Coupon] 참조
buttons	json	버튼별 URL, 텍스트 등
commerce	json	상품 정보 (상품명, 가격 등)	[2-2. Commerce] 참조
carousel	array	캐러셀 피드 콘텐츠	[2-3. Carousel] 참조
carousel_commerce	array	캐러셀 커머스형 콘텐츠	[2-4. CarouselCommerce] 참조

---

2-1. Coupon

필드명	설명	비고	타입
title	쿠폰 제목	템플릿 생성 시 쿠폰 타입별 할인 정보를 입력하지 않은 경우, 쿠폰 타입 별 기본 카카오 변수로 치환 가능합니다.	json
common	공통 영역	쿠폰 설명 및 URL (모바일/PC/Android/iOS 스킴 포함)	json

쿠폰 타입별 기본 카카오 개인화 변수

쿠폰 타입	기본 카카오 개인화 변수
할인 금액	할인 금액
할인율	쿠폰 퍼센트
무료 증정	상품명
업그레이드	상품명

2-2. Commerce

필드명	설명	비고
content	부가 텍스트 또는 설명
product_name	상품 이름
price	가격 정보	[5. Price(JSON)] 참조

---

2-3. Carousel

필드명	설명	비고
content	부가정보
coupon	쿠폰 정보	[1. Coupon(JSON)] 참조
buttons	버튼 리스트

---

2-4. CarouselCommerce

필드명	설명	비고	타입
content	부가정보 (인트로/텍스트 등)		json
buttons	버튼 리스트		json
coupon	쿠폰 정보	[1. Coupon(JSON)] 참조	json
product_name	상품명		json
price	가격 정보	[5. Price(JSON)] 참조	json

---

2-5. Price

브랜드 메시지 템플릿 생성 시 가격 영역의 모든 값을 미입력한 경우 카카오 측의 기본(고정) 변수로 자동 개인화가 적용됩니다. 아래 조합으로 개인화 필드를 사용할 수 있습니다.

1. 정상가격

2. 정상가격 + 할인가격 + 할인율

3. 정상가격 + 할인가격 + 정액할인가격

4. 정상가격 + 할인가격 + 할인율 + 정액할인가격

필드명	설명	타입
regular_price	정상가	json
discount_price	할인가	json
discount_rate	할인율	json
discount_fixed	정액할인가	json

---

3. 브랜드 메시지 개인화 필드 조회 API

카카오 브랜드 메시지 개인화 필드 조회

get

지정한 프로젝트 및 템플릿 ID에 대해 브랜드 메시지의 개인화 가능한 필드 구조를 더미값으로 반환합니다.

Query parameters

project_idstringRequired

프로젝트 ID

Example: bhlc6fn

template_idstringRequired

카카오 브랜드 메시지 템플릿 ID

Example: xflm3cp

Responses

200

조회 성공

application/json

codeintegerOptionalExample: 200000

messagestringOptionalExample: Success

400

잘못된 요청 (필수 파라미터 누락 등)

401

인증 실패 (토큰 누락/만료)

get

https://crm.marketap.io/api/v1/sender/kakao-brand-message/fields

HTTPcURLJavaScriptPython

GET https://crm.marketap.io/api/v1/sender/kakao-brand-message/fields?project_id=text&template_id=text HTTP/1.1
Accept: */*

{
  "data": {
    "content": {
      "부가정보": "dummy"
    },
    "coupon": {
      "title": {
        "할인금액": "dummy"
      },
      "common": {
        "쿠폰설명": "dummy",
        "쿠폰URL": "dummy"
      }
    },
    "buttons": {
      "버튼URL": "dummy"
    },
    "commerce": {
      "product_name": {
        "상품명": "dummy"
      },
      "price": {
        "regular_price": {
          "정상가격": "dummy"
        },
        "discount_price": {
          "할인가격": "dummy"
        },
        "discount_rate": {
          "할인율": "dummy"
        },
        "discount_fixed": {
          "정액할인가격": "dummy"
        }
      }
    },
    "carousel": []
  },
  "code": 200000,
  "message": "Success"
}

4. 브랜드 메시지 템플릿 조회 API

브랜드 메시지 템플릿 조회

get

지정한 프로젝트의 브랜드 메시지 템플릿 목록을 조회합니다. 이 API는 인증 토큰과 project_id 검증이 필요합니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

프로젝트 ID

Responses

200

성공적으로 템플릿 목록을 조회한 경우

application/json

codeintegerOptionalExample: 200000

messagestringOptionalExample: Success

400

필수 파라미터 누락 또는 잘못된 요청

401

인증 실패

500

서버 내부 오류

get

/api/v1/sender/kakao-brand-message/templates

HTTPcURLJavaScriptPython

GET /api/v1/sender/kakao-brand-message/templates?project_id=text HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "template_id": "abc123",
      "template_name": "가을 정기 세일",
      "message_type": "TEXT",
      "is_tracking_required": false
    }
  ]
}