Sign in

v1

latestOpenAPI 3.0.2서비스 이용약관2026-07-265758331.1 KB
Kakao

와이드형 브랜드 메시지 템플릿 등록

와이드형 브랜드 메시지 템플릿을 등록합니다. 800x600 이미지와 짧은 문구, 버튼 구성을 저장하여 주요 프로모션을 돋보이게 합니다.

post/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/wide

Path parameters

sendProfileIdstring required
Example:@bizmsg_official

템플릿을 등록할 카카오 채널(발신 프로필) ID입니다.

Request body

templateNamestring required

템플릿의 이름입니다. 최대 50자로 관리용으로 활용합니다.

contentstring required

메시지 본문입니다. 최대 76자까지 작성할 수 있습니다.

와이드 이미지가 주요 콘텐츠이므로 매우 간결한 문구 사용 변수 사용: #{변수명} 형식 지원

imageUrlstring uri required

권장 크기가 800x190px이고 최대 용량이 500KB인 와이드 이미지 URL입니다.

imageNamestring

접근성을 위한 이미지 대체 텍스트입니다.

imageLinkstring uri

이미지를 클릭했을 때 이동할 URL입니다.

Example request

{
  "templateName": "봄 시즌 메인 배너",
  "content": "#{고객명}님 단독! 최대 50% 세일",
  "imageUrl": "https://cdn.example.com/brand-message/wide-800x600.jpg",
  "imageName": "봄 세일 배너",
  "imageLink": "https://m.example.com/event/spring",
  "buttons": [
    {
      "name": "이벤트 참여",
      "linkType": "WL",
      "linkM": "https://m.example.com/event/spring"
    }
  ],
  "coupon": {
    "title": "한정 수량 20% 할인쿠폰",
    "description": "이벤트 기간 내 사용 가능",
    "linkM": "https://m.example.com/coupon/event"
  },
  "fallback": {
    "senderNumber": "01011112222",
    "type": "SMS",
    "message": "#{고객명}님, 프로모션 소식을 문자로 안내해 드립니다.",
    "title": null,
    "images": null,
    "isAd": true,
    "groupId": null
  }
}

Response

등록 처리 결과입니다. 오류가 발생해도 HTTP 200으로 응답하므로, 실패 여부는 본문의 code와 errorCode를 확인하세요.

codenumber

응답 코드

messagestring

응답 메시지

Example response

{
  "code": 200,
  "message": "성공",
  "data": {
    "templateId": "tpl_bm_123987",
    "templateCode": "BM_TEMPLATE_20240516015"
  }
}