API

와이드 리스트형

작성일 2026.02.28 | 수정일 2026.02.28

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

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

필수 파라미터

NameTypeDescription
kakaoOptions.bms.headerString헤더 (최대 20자, 줄바꿈 불가)
kakaoOptions.bms.mainWideItem.imageIdString이미지 ID
BMS_WIDE_MAIN_ITEM_LIST에 맞는 이미지 타입이 아니면 검증 실패
kakaoOptions.bms.mainWideItem.linkMobileString메인 아이템 모바일 링크
kakaoOptions.bms.subWideItemList[]Array서브 아이템 배열
title, imageId, linkMobile 필수

선택 파라미터

NameTypeDescription
kakaoOptions.bms.mainWideItem.titleString메인 아이템 제목 (최대 25자)
kakaoOptions.bms.mainWideItem.linkPcStringPC 링크
kakaoOptions.bms.mainWideItem.linkAndroidStringAndroid 링크
kakaoOptions.bms.mainWideItem.linkIosStringiOS 링크
kakaoOptions.bms.subWideItemList[].linkPcString서브 아이템 PC 링크
kakaoOptions.bms.subWideItemList[].linkAndroidString서브 아이템 Android 링크
kakaoOptions.bms.subWideItemList[].linkIosString서브 아이템 iOS 링크
kakaoOptions.bms.buttons[]Array버튼 오브젝트 (최대 2개)
kakaoOptions.bms.couponObject쿠폰 오브젝트
kakaoOptions.bms.adultBoolean성인 인증 (기본값 false)

chat

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


요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "kakaoOptions": {
        "pfId": "PFxxxxxxxxxxxxxxxx",
        "bms": {
          "targeting": "I",
          "chatBubbleType": "WIDE_ITEM_LIST",
          "header": "추천 상품",
          "mainWideItem": {
            "title": "메인 상품",
            "imageId": "IMG_MAIN_xxxxxxxxxxxxxxxx",
            "linkMobile": "https://example.com/main"
          },
          "subWideItemList": [
            {
              "title": "서브 상품 1",
              "imageId": "IMG_SUB1_xxxxxxxxxxxxxxxx",
              "linkMobile": "https://example.com/sub1"
            },
            {
              "title": "서브 상품 2",
              "imageId": "IMG_SUB2_xxxxxxxxxxxxxxxx",
              "linkMobile": "https://example.com/sub2"
            }
          ],
          "buttons": [
            {
              "name": "전체 보기",
              "linkType": "WL",
              "linkMobile": "https://example.com/all"
            }
          ]
        }
      }
    }
  ]
}