API

이미지형

작성일 2026.02.28 | 수정일 2026.02.28

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

chatBubbleTypeIMAGE 를 포함하는 경우의 브랜드 메시지 자유형 발송입니다.

필수 파라미터

NameTypeDescription
messages[].textString메시지 본문 (400자 이내, 줄바꿈 29개 이내)
kakaoOptions.bms.imageIdString이미지 ID
chatBubbleType에 맞는 이미지 타입이 아니면 검증 실패

선택 파라미터

NameTypeDescription
kakaoOptions.bms.imageLinkString이미지 클릭 링크
kakaoOptions.bms.buttons[]Array버튼 오브젝트
최대 5개 (쿠폰 사용 시 4개)
kakaoOptions.bms.couponObject쿠폰 오브젝트
kakaoOptions.bms.adultBoolean성인 인증
기본값: false

chat

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


요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "text": "이미지형 브랜드 메시지 예시입니다.",
      "kakaoOptions": {
        "pfId": "PFxxxxxxxxxxxxxxxx",
        "bms": {
          "targeting": "I",
          "chatBubbleType": "IMAGE",
          "imageId": "IMGxxxxxxxxxxxxxxxx",
          "buttons": [
            {
              "name": "구매하기",
              "linkType": "WL",
              "linkMobile": "https://example.com/buy"
            }
          ]
        }
      }
    }
  ]
}