API

템플릿 정보 수정

작성일 2026.03.08 | 수정일 2026.03.08

PUT/kakao/v2/templates/:templateId
Parameters
templateId— 템플릿 고유 ID

등록된 알림톡 템플릿의 내용, 버튼, 카테고리 등 상세 정보를 수정합니다.
검수에서 반려된 템플릿을 수정하여 다시 검수 요청하거나, 검수 전 상태의 템플릿 내용을 변경할 때 사용합니다.
수정 후에는 다시 템플릿 검수 요청 API를 통해 검수를 받아야 발송에 사용할 수 있습니다.

요청 시 블랙리스트 계정/멤버 체크가 수행됩니다.
삭제된 템플릿은 수정할 수 없습니다.

Body Params

NameTypeRequiredDescription
namestring템플릿 이름
contentstring템플릿 내용
buttonsarray버튼 목록
buttonTypestring*버튼 타입
buttonNamestring*버튼 이름
linkMostring모바일 링크
linkPcstringPC 링크
linkAndstring안드로이드 링크
linkIosstringiOS 링크
chatExtrastring상담톡/봇 전환 시 전달할 메타 정보
targetOutboolean아웃링크 사용 여부
quickRepliesarray바로연결 목록
categoryCodestring카테고리 코드
extrastring부가정보 (최대 500자, null 허용)
adstring광고 문구 (최대 80자, null 허용)
emphasizeTitlestring강조표기 제목 (최대 50자, null 허용)
emphasizeSubtitlestring강조표기 보조문구 (최대 50자, null 허용)
messageTypestring메시지 유형 (BA, EX, AD, MI)
emphasizeTypestring강조 유형 (NONE, TEXT, IMAGE, ITEM_LIST)
headerstring헤더 (최대 16자, null 허용)
highlightobject하이라이트 정보
titlestring*하이라이트 제목
descriptionstring*하이라이트 설명
imageIdstring하이라이트 이미지 ID
itemobject아이템 리스트 정보
listarray*아이템 목록
titlestring*아이템 제목
descriptionstring*아이템 설명
summaryobject아이템 요약 정보
titlestring*요약 제목
descriptionstring*요약 설명
securityFlagboolean보안 메시지 여부
imageIdstring이미지 ID

Response

템플릿 객체를 반환합니다. 응답 구조는 공통 응답 스키마 - 템플릿 객체를 참고하세요.

{
  "templateId": "TP01ABC",
  "name": "배송 알림 v2",
  "channelId": "CH01ABC",
  "channelGroupId": null,
  "assignType": "CHANNEL",
  "accountId": "AC01ABC",
  "securityFlag": false,
  "categoryCode": "003002",
  "isHidden": false,
  "isDeleted": false,
  "content": "#{이름}님, 주문이 배송 시작되었습니다.\n송장번호: #{송장번호}",
  "buttons": [
    {
      "buttonType": "WL",
      "buttonName": "배송 조회",
      "linkMo": "https://example.com/tracking",
      "linkPc": "https://example.com/tracking",
      "linkAnd": "exampleapp://tracking",
      "linkIos": "exampleapp://tracking",
      "chatExtra": null,
      "targetOut": false
    }
  ],
  "quickReplies": [],
  "highlight": {
    "title": null,
    "description": null,
    "imageId": null
  },
  "item": {
    "list": null,
    "summary": null
  },
  "comments": [],
  "code": "template_001",
  "commentable": true,
  "status": "PENDING",
  "messageType": "EX",
  "emphasizeType": "NONE",
  "extra": "본 메시지는 정보통신망법에 의거하여 발송되었습니다.",
  "ad": null,
  "emphasizeTitle": null,
  "emphasizeSubtitle": null,
  "imageId": null,
  "header": null,
  "dateCreated": "2024-01-01T00:00:00.000Z",
  "dateUpdated": "2024-01-15T00:00:00.000Z",
  "variables": [
    { "name": "이름" },
    { "name": "송장번호" }
  ]
}