Sign in

v1

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

템플릿 수정

등록된 알림톡 템플릿의 내용을 수정합니다. 검수 완료된 템플릿은 수정할 수 없으며, 검수 대기 중이거나 반려된 템플릿만 수정할 수 있습니다.

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

Path parameters

sendProfileIdstring required
Example:1234567890

수정할 템플릿이 속한 채널의 ID입니다.

templateIdstring required
Example:1234567890

수정할 템플릿의 ID입니다. 검수 완료된 템플릿은 수정할 수 없습니다.

Request body

templateNamestring

수정할 템플릿의 이름입니다. 템플릿을 구분하기 위한 이름을 설정할 수 있습니다.

templateContentstring

수정할 알림톡 템플릿의 본문 내용입니다.

글자수 제약:

  • 한/영 구분없이 최대 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자
templateEmphasizeType'NONE' | 'TEXT' | 'IMAGE' | 'ITEM_LIST'

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

templateExtrastring

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

사용 목적:

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

글자수 제약:

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

변수 및 URL:

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

표시 위치:

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

강조표기형 템플릿의 제목입니다.

사용 목적:

  • 중요한 정보를 강조하여 사용자의 주목을 끌기 위해 사용
  • 본문 상단에 볼드체로 노출되어 시각적 강조 효과 제공

글자수 제약:

  • Android: 최대 23자 (24자부터 말줄임 처리)
  • iOS: 최대 28자 (29자부터 말줄임 처리)

변수 사용:

  • 변수 등록 불가

사용 조건:

  • Subtitle과 함께 등록되어야 함
  • 단독 노출 불가
templateSubtitlestring

강조표기형 템플릿의 부제목입니다.

사용 목적:

  • 제목과 함께 사용하여 추가적인 정보를 제공
  • 제목보다 더 구체적인 내용을 담아 메시지의 명확성 향상

글자수 제약:

  • Android: 최대 18자 (19자부터 말줄임 처리)
  • iOS: 최대 21자 (22자부터 말줄임 처리)

변수 사용:

  • 변수 등록 불가

사용 조건:

  • Title과 함께 등록되어야 함
  • 단독 노출 불가
securityFlagboolean

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

templateImageNamestring

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

templateImageUrlstring

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

Example request

{
  "templateName": "수정된 주문 확인 템플릿",
  "templateContent": "안녕하세요 #{고객명}님, 주문이 완료되었습니다.",
  "templateEmphasizeType": "TEXT",
  "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": "성공"
}