v1

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

캐러셀 피드형 브랜드 메시지 템플릿 등록

캐러셀 피드형 브랜드 메시지 템플릿을 등록합니다. 여러 장의 카드를 순차로 구성해 다양한 상품과 버튼을 함께 소개할 수 있습니다.

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

Path parameters

sendProfileIdstring required
Example:@bizmsg_official

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

Request body

templateNamestring required

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

Example request

{
  "templateName": "추천 상품 캐러셀",
  "carousel": {
    "list": [
      {
        "header": "베스트셀러 1위",
        "content": "고객님께 추천하는 베스트 상품!\\n특별 할인가로 만나보세요.",
        "imageUrl": "https://cdn.example.com/brand-message/carousel-1.jpg",
        "imageLink": "https://m.example.com/product/best1",
        "buttons": [
          {
            "name": "구매하기",
            "linkType": "WL",
            "linkM": "https://m.example.com/product/best1"
          }
        ]
      },
      {
        "header": "인기 상품",
        "content": "놓치면 아쉬운 인기 상품을 만나보세요.",
        "imageUrl": "https://cdn.example.com/brand-message/carousel-2.jpg",
        "buttons": [
          {
            "name": "자세히 보기",
            "linkType": "WL",
            "linkM": "https://m.example.com/product/best2"
          }
        ]
      }
    ],
    "tail": {
      "linkM": "https://m.example.com/more",
      "linkP": "https://www.example.com/more"
    }
  },
  "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_125001",
    "templateCode": "BM_TEMPLATE_20240516035"
  }
}