API

캐러셀 커머스형

작성일 2026.03.01 | 수정일 2026.03.01

엔드포인트, 요청 본문, 응답 구조 등 자세한 정보는 메시지 발송 공통 문서에서 확인해주세요
브랜드메시지 자유형 공통 규격을 참조해 주세요

chatBubbleTypeCAROUSEL_COMMERCE 인 경우의 브랜드 메시지 자유형 발송입니다.

필수 파라미터

NameTypeDescription
kakaoOptions.bms.carousel.list[]Arrayhead 사용 시 1~5개
미사용 시 2~6개
kakaoOptions.bms.carousel.list[].commerce.titleString상품명
kakaoOptions.bms.carousel.list[].imageIdString카드 이미지 ID
BMS_CAROUSEL_FEED_LIST 타입
kakaoOptions.bms.carousel.list[].buttons[]Array카드별 버튼 (1~2개, WL/AL만 허용)

선택 파라미터

NameTypeDescription
kakaoOptions.bms.carousel.headObject인트로 영역
CAROUSEL_COMMERCE 전용
kakaoOptions.bms.carousel.tailObject더보기 영역
tail.linkMobile 필수
변수 사용 불가
kakaoOptions.bms.additionalContentString캐러셀 상단 추가 문구 (최대 34자)
kakaoOptions.bms.carousel.list[].additionalContentString카드별 추가 문구
(최대 34자, 줄바꿈 최대 1개)
kakaoOptions.bms.carousel.list[].imageLinkString이미지 클릭 링크
kakaoOptions.bms.carousel.list[].couponObject카드별 쿠폰 오브젝트
kakaoOptions.bms.carousel.list[].commerce.regularPriceString정가
kakaoOptions.bms.carousel.list[].commerce.discountPriceString할인가
kakaoOptions.bms.carousel.list[].commerce.discountRateString할인율
kakaoOptions.bms.carousel.list[].commerce.discountFixedString고정 할인액
kakaoOptions.bms.adultBoolean성인 인증(기본값: false)

오브젝트 규격

carousel.list[] 카드 오브젝트

NameTypeRequiredDescription
commerce.titleString상품명
commerce.regularPriceNumber정가
commerce.discountPriceNumber할인가
commerce.discountRateNumber할인율
commerce.discountFixedNumber고정 할인액
imageIdStringtrue카드 이미지 ID
BMS_CAROUSEL_COMMERCE_LIST 타입
buttons[]Arraytrue카드별 버튼 (1~2개, WL/AL만 허용)
additionalContentString카드별 추가 문구 (최대 34자, 줄바꿈 최대 1개)
imageLinkString이미지 클릭 링크
couponObject카드별 쿠폰 오브젝트

carousel.head 오브젝트

캐러셀 커머스 전용 오브젝트입니다.
인트로 영역 사용 시 카드는 1~5개, 미사용 시 2~6개로 제한됩니다.

NameTypeRequiredDescription
headerStringtrue최대 20자
contentStringtrue최대 50자, 줄바꿈 최대 2개
imageIdStringtrueBMS_CAROUSEL_COMMERCE_LIST 타입 이미지
linkMobileStringlinkPc/linkAndroid/linkIos 중 1개라도 있으면 필수
linkPcStringPC 링크
linkAndroidStringAndroid 링크
linkIosStringiOS 링크

carousel.tail 오브젝트

NameTypeRequiredDescription
linkMobileStringtrue모바일 링크 (필수)
linkPcStringPC 링크
linkAndroidStringAndroid 링크
linkIosStringiOS 링크

chat

브랜드 메시지 자유형 공통 하위 오브젝트 규격을 확인해주세요!


요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "kakaoOptions": {
        "pfId": "PFxxxxxxxxxxxxxxxx",
        "bms": {
          "targeting": "I",
          "chatBubbleType": "CAROUSEL_COMMERCE",
          "additionalContent": "연말 특가",
          "carousel": {
            "head": {
              "header": "지금 구매하세요",
              "content": "최대 50% 할인",
              "imageId": "IMG_HEAD_xxxxxxxxxxxxxxxx",
              "linkMobile": "https://example.com/event"
            },
            "list": [
              {
                "imageId": "IMG_C1_xxxxxxxxxxxxxxxx",
                "commerce": {
                  "title": "상품 1",
                  "regularPrice": "20000",
                  "discountPrice": "15000",
                  "discountRate": "25"
                },
                "buttons": [
                  {
                    "name": "구매",
                    "linkType": "WL",
                    "linkMobile": "https://example.com/p1"
                  }
                ]
              },
              {
                "imageId": "IMG_C2_xxxxxxxxxxxxxxxx",
                "additionalContent": "사은품 증정",
                "commerce": {
                  "title": "상품 2",
                  "regularPrice": "30000",
                  "discountPrice": "24000",
                  "discountRate": "20"
                },
                "buttons": [
                  {
                    "name": "구매",
                    "linkType": "WL",
                    "linkMobile": "https://example.com/p2"
                  }
                ]
              }
            ],
            "tail": {
              "linkMobile": "https://example.com/more"
            }
          }
        }
      }
    }
  ]
}