캐러셀 커머스형
작성일 2026.03.01 | 수정일 2026.03.01
엔드포인트, 요청 본문, 응답 구조 등 자세한 정보는 메시지 발송 공통 문서에서 확인해주세요
브랜드메시지 자유형 공통 규격을 참조해 주세요
chatBubbleType 이 CAROUSEL_COMMERCE 인 경우의 브랜드 메시지 자유형 발송입니다.
필수 파라미터
선택 파라미터
오브젝트 규격
carousel.list[] 카드 오브젝트
carousel.head 오브젝트
캐러셀 커머스 전용 오브젝트입니다.
인트로 영역 사용 시 카드는 1~5개, 미사용 시 2~6개로 제한됩니다.
carousel.tail 오브젝트
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"
}
}
}
}
}
]
}