API

와이드형

작성일 2026.02.28 | 수정일 2026.02.28

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

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

필수 파라미터

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

선택 파라미터

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

chat

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


요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "text": "와이드형 예시(76자/줄바꿈 1개 제한).",
      "kakaoOptions": {
        "pfId": "PFxxxxxxxxxxxxxxxx",
        "bms": {
          "targeting": "I",
          "chatBubbleType": "WIDE",
          "imageId": "IMGxxxxxxxxxxxxxxxx",
          "buttons": [
            {
              "name": "자세히",
              "linkType": "WL",
              "linkMobile": "https://example.com/detail"
            }
          ]
        }
      }
    }
  ]
}