API

캐러셀 피드형

작성일 2026.03.01 | 수정일 2026.03.01

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

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

필수 파라미터

NameTypeDescription
kakaoOptions.bms.carousel.list[]Array캐러셀 카드 배열 (2~6개)
kakaoOptions.bms.carousel.list[].headerString카드 제목 (최대 20자, 줄바꿈 불가)
kakaoOptions.bms.carousel.list[].contentString카드 본문 (최대 180자, 줄바꿈 최대 2개)
kakaoOptions.bms.carousel.list[].imageIdString카드 이미지 ID
BMS_CAROUSEL_COMMERCE_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)

buttons[] 오브젝트

CAROUSEL_COMMERCE 에서는 WL(웹링크)/AL(앱링크)만 허용됩니다 (1~2개)

NameTypereqDescription
nameStringtrue버튼명 최대 8자
linkTypeStringtrueWL 또는 AL만 허용
linkMobileStringWL이면 필수
AL이면 linkAndroid/linkIos 없을 때 대체 사용
linkPcStringPC용 웹링크
linkAndroidStringAL인 경우 linkMobile/linkAndroid/linkIos 중 1개 이상 필요
linkIosStringAL인 경우 linkMobile/linkAndroid/`linkIos 중 1개 이상 필요

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"
            }
          }
        }
      }
    }
  ]
}