엔드포인트, 요청 본문, 응답 구조 등 자세한 정보는 메시지 발송 공통 문서에서 확인해주세요
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 | 텍스트형 |
| 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) |
타겟팅 설정
브랜드 메시지는 kakaoOptions.bms.targeting 값에 따라 발송 대상이 결정됩니다.
| value | Name | Description |
|---|
| M | 마케팅 수신 동의자 | 브랜드 등록 필요 |
| N | 마케팅 수신 동의자 − 채널친구 | 브랜드 등록 필요 |
| I | 채널친구 | 브랜드 등록 불필요 |
I를 제외한 타겟팅은 카카오 측에서 인허가된 비즈니스 채널만 사용할 수 있습니다. 관련 인허가 문의는 고객센터로 문의해주세요
대체발송
브랜드 메시지 자유형 발송이 실패하면 문자(LMS)로 대체 발송할 수 있습니다(선택 사항).
문자로 대체 발송 시 광고 표기"(광고)"가 필수 포함됩니다.
이미지형(IMAGE)의 경우 MMS가 아닌 LMS로 대체되며, 이미지는 URL 링크 형태로 본문에 포함됩니다.
자세한 내용은 대체발송 문서를 참조하세요.
