엔드포인트, 요청 본문, 응답 구조 등 자세한 정보는 메시지 발송 공통 문서에서 확인해주세요
BMS_FREE는 카카오 브랜드 메시지(Brand Message)를 템플릿 등록 없이 발송할 때 사용하는 유형입니다.
kakaoOptions.bms.chatBubbleType에 따라 필수 필드와 사용 가능 필드가 달라집니다.
| 항목 | 내용 |
|---|
| 대체발송 | 미지원 |
| autoTypeDetect 조건 | kakaoOptions.bms.chatBubbleType 존재 |
공통 필수 파라미터
| name | type | Description |
|---|
| messages[].to | String | 수신번호 |
| messages[].kakaoOptions.pfId | String | 카카오 채널 프로필 ID
또는 senderKey 사용 가능 |
| messages[].kakaoOptions.bms.targeting | String | 타겟팅 설정 (M, N, I) |
| messages[].kakaoOptions.bms.chatBubbleType | String | 말풍선 타입 (아래 목록 참고) |
chatBubbleType (말풍선 타입)
| Name | Description | 상세 문서 |
|---|
| TEXT | 텍스트형 | TODO |
| IMAGE | 이미지형 | |
| WIDE | 와이드형 | |
| WIDE_ITEM_LIST | 와이드 아이템 리스트형 | |
| COMMERCE | 커머스형 | |
| CAROUSEL_FEED | 캐러셀 피드형 | |
| CAROUSEL_COMMERCE | 캐러셀 커머스형 | |
| PREMIUM_VIDEO | 프리미엄 비디오형 | |
공통 선택 파라미터
| name | Type | Description |
|---|
| messages[].kakaoOptions.bms.adult | Boolean | 성인 인증 여부. 기본값: false |
공통 하위 오브젝트 규격
아래 오브젝트는 여러 chatBubbleType에서 공통으로 사용됩니다.
buttons[] 오브젝트
| Name | Type | req | Description |
|---|
| name | String | | 버튼명 TEXT/IMAGE 최대 14자
그 외 최대 8자
linkType=AC인 경우 무시 |
| linkType | String | true | 버튼 링크 유형 WL(웹링크), AL(앱링크), AC(채널추가)
CAROUSEL_FEED/CAROUSEL_COMMERCE/COMMERCE에서는 WL/AL만 허용 |
| linkMobile | String | | WL인 경우 필수
AL인 경우 linkAndroid/linkIos가 없을 때 대체 사용 |
| linkPc | String | | PC용 웹링크 |
| linkAndroid | String | | AL인 경우 linkMobile/linkAndroid/linkIos 중 1개 이상 필요 |
| linkIos | String | | AL인 경우 linkMobile/linkAndroid/`linkIos 중 1개 이상 필요 |
버튼 개수 제한
| chatBubbleType | 최대 개수 | 쿠폰 사용 시 |
|---|
| TEXT, IMAGE | 5개 | 4개 |
| WIDE | 2개 | - |
| WIDE_ITEM_LIST | 2개 | - |
| COMMERCE | 1~2개 | - |
| CAROUSEL_FEED, CAROUSEL_COMMERCE | 카드당 1~2개 | - |
| PREMIUM_VIDEO | 1개 | - |
coupon 오브젝트
| Name | Type | Required | Description |
|---|
| title | String | true | 쿠폰 제목
아래 5가지 형식만 허용
${숫자}원 할인 쿠폰(1~99,999,999)
${숫자}% 할인 쿠폰(1~100)
배송비 할인 쿠폰
${7자 이내} 무료 쿠폰
${7자 이내} UP 쿠폰 |
| description | String | true | 쿠폰 설명
WIDE/WIDE_ITEM_LIST최대 18자
그 외 최대 12자 |
| linkMobile | String | | 쿠폰 링크 |
| linkPc | String | | 쿠폰 링크 (PC) |
| linkAndroid | String | | 쿠폰 링크 (Android) |
| linkIos | String | | 쿠폰 링크 (iOS) |
WIDE_ITEM_LIST 오브젝트
mainWideItem (메인 아이템)
| field | Type | Required | Description |
|---|
| title | String | | 메인 아이템 제목
최대 25자, 줄바꿈 최대 1개 |
| imageId | String | true | 이미지 ID
메인 BMS_WIDE_MAIN_ITEM_LIST 타입 |
| linkMobile | String | true | 모바일 링크 |
| linkPc | String | | PC 링크 |
| linkAndroid | String | | Android 링크 |
| linkIos | String | | iOS 링크 |
subWideItemList[] (서브 아이템)
| field | Type | Required | Description |
|---|
| title | String | true | 서브 아이템 제목 (최대 30자) |
| imageId | String | true | 이미지 ID
BMS_WIDE_SUB_ITEM_LIST 타입 |
| linkMobile | String | true | 모바일 링크 |
| linkPc | String | | PC 링크 |
| linkAndroid | String | | Android 링크 |
| linkIos | String | | iOS 링크 |
carousel 오브젝트
| field | Type | Required | Description |
|---|
| list | Array | true | 캐러셀 카드 리스트
head 사용 시 1~5개, 미사용 시 2~6개 |
| head | Object | | CAROUSEL_COMMERCE 에서만 사용 가능 |
| tail | Object | | CAROUSEL_FEED/CAROUSEL_COMMERCE에서 사용 가능 |
carousel.head CAROUSEL_COMMERCE 전용 인트로
| field | Type | Required | Description |
|---|
| header | String | true | 최대 20자 |
| content | String | true | 최대 50자, 줄바꿈 최대 2개 |
| imageId | String | true | BMS_CAROUSEL_COMMERCE_LIST 타입 이미지 |
| linkMobile | String | | linkPc/linkAndroid/linkIos 중 1개라도 있으면 필수 |
| linkPc | String | | PC 링크 |
| linkAndroid | String | | Android 링크 |
| linkIos | String | | iOS 링크 |
carousel.tail (캐러셀 더보기)
| field | Type | Required | Description |
|---|
| linkMobile | String | true | 필수 |
| linkPc | String | | PC 링크 |
| linkAndroid | String | | Android 링크 |
| linkIos | String | | iOS 링크 |
타겟팅 설정
브랜드 메시지는 kakaoOptions.bms.targeting 값에 따라 발송 대상이 결정됩니다.
| value | Name | Description |
|---|
| M | 마케팅 수신 동의자 | 브랜드 등록 필요 |
| N | 마케팅 수신 동의자 − 채널친구 | 브랜드 등록 필요 |
| I | 채널친구 | 브랜드 등록 불필요 |
I를 제외한 타겟팅은 카카오 측에서 인허가된 비즈니스 채널만 사용할 수 있습니다. 관련 인허가 문의는 고객센터로 문의해주세요
