API

프리미엄 비디오형

작성일 2026.03.01 | 수정일 2026.03.01

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

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

필수 파라미터

NameTypeDescription
kakaoOptions.bms.videoObject동영상 설정
videoUrl 또는 imageId 중 1개 이상 입력 권장
kakaoOptions.bms.video.videoUrlString동영상 URL
"https://tv.kakao.com/" 형식만 허용
kakaoOptions.bms.video.imageIdString동영상 썸네일 이미지 ID

선택 파라미터

NameTypeDescription
kakaoOptions.bms.headerString헤더
최대 20자, 줄바꿈 불가
messages[].textString동영상 카드 본문
최대 76자, 줄바꿈 최대 1개
kakaoOptions.bms.video.imageLinkString동영상 썸네일 이미지 클릭 링크
kakaoOptions.bms.buttons[]Array버튼 오브젝트
최대 1개
kakaoOptions.bms.couponObject쿠폰 오브젝트
kakaoOptions.bms.adultBoolean성인 인증 (기본값: false)

video 오브젝트 규격

NameTypeRequiredDescription
videoUrlStringtrue동영상 URL
"https://tv.kakao.com/" 형식만 허용
imageIdString동영상 썸네일 이미지 ID
videoUrl 또는 imageId 중 1개 이상 입력 권장
imageLinkString동영상 썸네일 이미지 클릭 링크

chat

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


요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "kakaoOptions": {
        "pfId": "PFxxxxxxxxxxxxxxxx",
        "bms": {
          "targeting": "I",
          "chatBubbleType": "CAROUSEL_FEED",
          "carousel": {
            "list": [
              {
                "header": "카드 1 제목",
                "content": "카드 1 본문입니다.",
                "imageId": "IMG_CARD1_xxxxxxxxxxxxxxxx",
                "buttons": [
                  {
                    "name": "열기",
                    "linkType": "WL",
                    "linkMobile": "https://example.com/1"
                  }
                ]
              },
              {
                "header": "카드 2 제목",
                "content": "카드 2 본문입니다.",
                "imageId": "IMG_CARD2_xxxxxxxxxxxxxxxx",
                "buttons": [
                  {
                    "name": "열기",
                    "linkType": "AL",
                    "linkMobile": "https://example.com/2"
                  }
                ]
              }
            ],
            "tail": {
              "linkMobile": "https://example.com/more"
            }
          }
        }
      }
    }
  ]
}