Sign in

v1

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

템플릿 생성

알림톡 발송을 위한 새로운 템플릿을 생성합니다. 생성된 템플릿은 카카오 검수 승인 후 사용할 수 있습니다.

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

Path parameters

sendProfileIdstring required
Example:@profile_12345

템플릿을 생성할 채널(발신프로필)의 ID입니다.

Request body

templateNamestring

템플릿의 이름입니다. 템플릿을 구분하고 관리하기 위한 이름입니다.

templateContentstring required

알림톡 템플릿의 본문 내용입니다. 고객에게 반드시 전달되어야하는 정보를 발송할 수 있습니다.

글자수 제약:

  • 한/영 구분없이 최대 1,000자까지 입력 가능
  • 모든 템플릿 타입에서 본문은 1,000자 제한

변수 사용:

  • 개인화된 텍스트 영역은 #{변수명} 형식으로 작성 가능
  • 예: #{고객명}, #{주문번호}, #{배송일자} 등

템플릿 타입별 총 길이:

  • 기본형(BA): 본문 1,000자
  • 부가정보형(EX): 본문 1,000자 + 부가정보 500자 = 총 1,500자
  • 채널추가형(AD): 본문 1,000자 + 채널추가 안내 80자 = 총 1,080자
  • 복합형(MI): 본문 1,000자 + 부가정보 500자 + 채널추가 안내 80자 = 총 1,580자
templateMessageType'BA' | 'EX' | 'AD' | 'MI'

템플릿의 메시지 타입입니다. BA(기본형), EX(부가 정보형), AD(채널추가형), MI(복합형) 중 선택합니다.

templateEmphasizeType'NONE' | 'TEXT' | 'IMAGE' | 'ITEM_LIST'

템플릿의 강조 표시 타입입니다. NONE(강조 없음), TEXT(텍스트 강조), IMAGE(이미지 강조), ITEM_LIST(아이템 리스트 강조) 중 선택합니다.

templateExtrastring

부가정보는 알림톡 메시지의 본문 하단에 노출되는 보조적인 정보입니다.

사용 목적:

  • 고객에게 고정적인 부가 정보에 대한 안내가 지속적으로 필요한 경우
  • 이용안내 등 보조적인 정보메시지 안내

글자수 제약:

  • 최대 500자 입력 가능
  • 광고성 요소와 동시 사용 시 부가정보 + 광고성 문구 총 500자 제한
  • 본문과 합쳐 총 1,000자를 넘을 수 없음

변수 및 URL:

  • 변수 사용 불가능
  • URL 포함 가능

표시 위치:

  • 본문과 버튼 사이 Description 영역에 노출
  • 본문 대비 사이즈 -1pt, 컬러차 자동 적용
templateTitlestring

강조표기형 알림톡의 제목(Title)입니다. 본문 내용 중 고객에게 강조하여 표현할 내용을 말풍선 상단 영역에 강조 표시합니다.

글자수 제약:

  • 안드로이드: 최대 2줄 23자 (24자부터 말줄임 처리)
  • iOS: 최대 2줄 27자 (28자부터 말줄임 처리)
  • 말줄임 처리가 되지 않는 길이로 발송 권장

변수 사용:

  • 변수 사용 가능 (#{변수명} 형식)

사용 조건:

  • Title과 Subtitle은 함께 등록되어야 함
  • 각각 단독으로 노출될 수 없음

취소선 적용:

  • 텍스트 끝에 \s 추가 시 취소선 적용 (카카오톡 10.0.0 버전 이상)
  • 예: "87,000원\s"
templateSubtitlestring

강조표기형 알림톡의 부제목(Subtitle)입니다. Title에 어떤 내용이 들어가는지에 대한 부연 설명을 제공합니다.

글자수 제약:

  • 안드로이드: 최대 18자 (19자부터 말줄임 처리)
  • iOS: 최대 21자 (22자부터 말줄임 처리)
  • 말줄임 처리가 되지 않는 길이로 발송 권장

변수 사용:

  • 변수 등록 불가

사용 조건:

  • Title과 Subtitle은 함께 등록되어야 함
  • 각각 단독으로 노출될 수 없음
securityFlagboolean

템플릿의 보안 수준을 나타내는 플래그입니다. true인 경우 높은 보안이 적용된 템플릿임을 의미합니다.

templateImageNamestring

템플릿에 포함된 이미지의 파일명입니다. 이미지 관리를 위해 사용됩니다.

templateImageUrlstring

템플릿에 포함된 이미지의 URL입니다. 업로드된 이미지에 접근하기 위한 웹 주소입니다.

Example request

{
  "templateName": "이벤트 알림 템플릿",
  "templateContent": "안녕하세요 #{고객명}님\n\n주문하신 상품이 배송 준비 중입니다.\n주문번호: #{주문번호}\n배송예정일: #{배송일자}\n\n감사합니다.",
  "templateMessageType": "BA",
  "templateEmphasizeType": "NONE",
  "templateExtra": "■ 이용안내\n- 운영시간: 평일 09:00~18:00\n- 고객센터: 1588-1234\n- 홈페이지: https://shop.example.com\n\n※ 주말/공휴일 배송불가",
  "templateTitle": "123,456원",
  "templateSubtitle": "승인내역",
  "templateImageName": "template_banner.png",
  "templateImageUrl": "https://example.com/images/template_banner.png",
  "buttons": [
    {
      "name": "자세히 보기",
      "ordering": 1,
      "urlMobile": "https://example.com/mobile",
      "urlPc": "https://example.com/pc"
    }
  ]
}

Response

템플릿 생성 요청의 처리 결과입니다. 성공 시 생성된 템플릿의 상세 정보가 포함됩니다.

codenumber

응답 코드

messagestring

응답 메시지

Example response

{
  "code": 200,
  "message": "성공",
  "data": {
    "profileId": "profile_12345",
    "id": "template_67890",
    "templateName": "주문 확인 알림 템플릿",
    "status": "APPROVED",
    "templateMessageType": "BA",
    "templateEmphasizeType": "TEXT",
    "templateContent": "안녕하세요 #{고객명}님, 주문이 완료되었습니다.",
    "buttons": [
      {
        "name": "자세히 보기",
        "ordering": 1,
        "urlMobile": "https://example.com/mobile",
        "urlPc": "https://example.com/pc"
      }
    ],
    "fallback": {
      "groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111"
    },
    "templateComments": [
      {
        "commentContent": "템플릿 내용이 명확하지 않아 수정이 필요합니다.",
        "commentCreateAt": "2024-01-15T10:30:00Z",
        "commentSeqno": 1,
        "commentStatus": "ACTIVE",
        "commentUserName": "검수담당자",
        "regBy": "admin@example.com",
        "regDate": "2024-01-15T10:30:00Z",
        "updateBy": "admin@example.com",
        "updateDate": "2024-01-15T11:00:00Z"
      }
    ],
    "templateTitle": "123,456원",
    "templateSubtitle": "승인내역",
    "templateImageName": "template_banner.png",
    "templateImageUrl": "https://example.com/images/template_banner.png",
    "templateExtra": "■ 이용안내\n- 운영시간: 평일 09:00~18:00\n- 고객센터: 1588-1234\n- 홈페이지: https://shop.example.com\n\n※ 주말/공휴일 배송불가",
    "createdAt": "2024-01-01T09:00:00Z",
    "updatedAt": "2024-01-15T10:30:00Z",
    "syncedAt": "2024-01-15T11:00:00Z",
    "lastUsedAt": "2024-01-15T12:00:00Z"
  }
}