Kakao

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

Changed on Nov 3, 2026

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

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

Request

Base URL
https://api.sendon.io
URL
https://api.sendon.io/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/wide
Auth
HTTP basic

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://mud-kage.kakao.com/dn/RY8ZN/btsgQf4Srpr/TjD5XrZmdJMngMT6zoZ8U0/img_l.jpg",
  "imageName": "이벤트 배너 이미지",
  "imageLink": "https://m.example.com/event",
  "buttons": [
    {
      "name": "자세히 보기",
      "linkType": "WL",
      "linkM": "https://m.example.com",
      "linkP": "https://www.example.com",
      "linkI": "myapp://page/123",
      "linkA": "myapp://page/123"
    }
  ],
  "coupon": {
    "title": "10% 할인 쿠폰",
    "description": "첫 구매 시 10% 할인 혜택",
    "linkM": "https://m.example.com/coupon/ABC123",
    "linkP": "https://www.example.com/coupon/ABC123",
    "linkI": "myapp://coupon/ABC123",
    "linkA": "myapp://coupon/ABC123"
  },
  "fallback": {
    "senderNumber": "01012345678",
    "message": "#{고객명}님, 브랜드메시지가 발송되지 못하여 대체문자로 발송됩니다.",
    "title": "대체문자 안내",
    "images": [
      "https://mud-kage.kakao.com/dn/bgUWpm/btsgfyhWuWn/L9SHkckn2VXHOayfGa9ok1/img_l.jpg"
    ],
    "groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111"
  }
}

Response

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

codenumber required

HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.

messagestring required

API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.

Example response

{
  "code": 200,
  "message": "OK",
  "data": {
    "templateId": "tpl_bm_123456",
    "templateCode": "BM_TEMPLATE_20240515001"
  }
}

Changes

Nov 3, 202671dc377792d9 Revision changes
- breaking
  request body became required
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the response's property type changed from object to no type for status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- info
  api operation id createWideBrandMessageTemplate removed and replaced with BrandMessageTemplateController_createWideBrandMessageTemplate
- info
  the endpoint scheme security basic was added to the API
- info
  added to the response property allOf list for the response status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response's property default value 200 was removed for the status
- info
  the response's property default value 성공 was removed for the status

Operation history