v1

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

Kakao

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

이미지형 브랜드 메시지 템플릿을 등록합니다. 대표 이미지와 메시지 본문, 버튼 구성을 함께 저장하여 시각적 홍보에 활용할 수 있습니다.

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

Path parameters

sendProfileIdstring required

Example:@bizmsg_official

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

Request body

templateNamestring required

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

contentstring required

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

변수 사용: #{변수명} 형식으로 변수 치환 가능합니다. 이미지와 함께 표시되므로 간결하게 작성 권장합니다.

imageUrlstring uri required

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

imageNamestring

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

imageLinkstring uri

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

Example request

{
  "templateName": "신상품 출시 안내",
  "content": "#{고객명}님을 위한 특별한 신상품!\\n지금 확인해 보세요.",
  "imageUrl": "https://cdn.example.com/brand-message/image-500x250.jpg",
  "imageName": "신상품 대표 이미지",
  "imageLink": "https://m.example.com/product/new",
  "buttons": [
    {
      "name": "자세히 보기",
      "linkType": "WL",
      "linkM": "https://m.example.com/product/new",
      "linkP": "https://www.example.com/product/new"
    }
  ],
  "coupon": {
    "title": "런칭 기념 5,000원 쿠폰",
    "description": "신제품 구매 시 자동 적용",
    "linkM": "https://m.example.com/coupon/new"
  },
  "fallback": {
    "senderNumber": "01011112222",
    "type": "LMS",
    "message": "#{고객명}님, 신상품 출시 소식을 문자로 알려드립니다.",
    "title": "신상품 출시",
    "images": null,
    "isAd": true,
    "groupId": null
  }
}

Response

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

codenumber

응답 코드

messagestring

응답 메시지

Example response

{
  "code": 200,
  "message": "성공",
  "data": {
    "templateId": "tpl_bm_123789",
    "templateCode": "BM_TEMPLATE_20240516001"
  }
}