API
솔라피 시작하기
API

커머스형

작성일 2026.02.28 | 수정일 2026.02.28

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

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

필수 파라미터

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)

buttons[] 오브젝트

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": "COMMERCE",
          "imageId": "IMGxxxxxxxxxxxxxxxx",
          "additionalContent": "무료배송",
          "commerce": {
            "title": "상품명",
            "regularPrice": "12000",
            "discountPrice": "9900",
            "discountRate": "18"
          },
          "buttons": [
            {
              "name": "구매하기",
              "linkType": "WL",
              "linkMobile": "https://example.com/buy"
            }
          ]
        }
      }
    }
  ]
}