v1

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

Kakao

텍스트형 브랜드 메시지 템플릿 등록

텍스트형 브랜드 메시지 템플릿을 등록합니다. 메시지 본문과 버튼 구성을 함께 받아 저장하며, 생성 직후 바로 발송 요청에 사용할 수 있습니다.

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

Path parameters

sendProfileIdstring required

Example:@bizmsg_official

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

Request body

templateNamestring required

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

contentstring required

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

변수 사용: #{변수명} 형식으로 변수 치환 가능 예시: "안녕하세요 #{고객명}님, 가입을 환영합니다!"

Example request

{
  "templateName": "회원가입 환영 안내",
  "content": "안녕하세요 #{고객명}님!\\n회원가입을 진심으로 환영합니다.\\n지금 로그인하고 웰컴 혜택을 확인해 보세요.",
  "buttons": [
    {
      "name": "혜택 확인",
      "linkType": "WL",
      "linkM": "https://m.example.com/welcome"
    }
  ],
  "coupon": {
    "title": "첫 구매 전용 10% 할인",
    "description": "앱 첫 구매 고객 전용 할인 쿠폰",
    "linkM": "https://m.example.com/coupon/welcome"
  },
  "fallback": {
    "senderNumber": "01011112222",
    "type": "SMS",
    "message": "#{고객명}님, 신규 가입 혜택을 문자로 안내해 드립니다.",
    "title": null,
    "images": null,
    "isAd": false,
    "groupId": null
  }
}

Response

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

codenumber

응답 코드

messagestring

응답 메시지

Example response

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