API

커머스형

작성일 2026.02.28 | 수정일 2026.03.25

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

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

필수 파라미터

NameTypeDescription
kakaoOptions.bms.imageIdString이미지 ID
kakaoOptions.bms.commerce.titleString상품명
kakaoOptions.bms.buttons[]Array버튼 오브젝트 1~2개
WL/AL만 허용
각 버튼 name, linkType 필수
WL이면 linkMobile 필수
AL이면 linkMobile/linkAndroid/linkIos 중 1개 필수

선택 파라미터

NameTypeDescription
kakaoOptions.bms.additionalContentString추가 문구 (최대 34자)
kakaoOptions.bms.commerce.regularPriceString정가 (숫자 문자열)
kakaoOptions.bms.commerce.discountPriceString할인가 (숫자 문자열)
kakaoOptions.bms.commerce.discountRateString할인율 (숫자 문자열)
kakaoOptions.bms.commerce.discountFixedString고정 할인액 (숫자 문자열)
kakaoOptions.bms.couponObject쿠폰 오브젝트
kakaoOptions.bms.adultBoolean성인 인증 (기본값 false)

commerce 오브젝트 규격

NameTypeRequiredDescription
titleStringtrue상품명
regularPriceNumber정가
discountPriceNumber할인가
discountRateNumber할인율
discountFixedNumber고정 할인액

chat

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


요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "kakaoOptions": {
        "pfId": "PFxxxxxxxxxxxxxxxx",
        "bms": {
          "targeting": "I",
          "chatBubbleType": "COMMERCE",
          "imageId": "IMGxxxxxxxxxxxxxxxx",
          "additionalContent": "무료배송",
          "commerce": {
            "title": "상품명",
            "regularPrice": "12000",
            "discountPrice": "9900",
            "discountRate": "18"
          },
          "buttons": [
            {
              "name": "구매하기",
              "linkType": "WL",
              "linkMobile": "https://example.com/buy"
            }
          ]
        }
      }
    }
  ]
}