API

자유형 발송

작성일 2026.02.28 | 수정일 2026.02.28

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

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	말풍선 타입 (아래 목록 참고)

name	Type	Description
messages[].from	String	발신번호
messages[].kakaoOptions.senderKey	String	발신 프로필 키 (pfId 대체)
messages[].kakaoOptions.buttons	Array	버튼 목록 (템플릿별 상이)
messages[].kakaoOptions.coupon	Object	쿠폰 정보 (템플릿별 상이)
messages[].kakaoOptions.replacements	Object	대체 텍스트