본문으로 건너뛰기

템플릿 정보 수정

목차

Request

[PUT] https://api.solapi.com/kakao/v2/templates/:templateId

템플릿의 정보를 수정합니다.


Authorization 인증 필요

Authorization 인증이란?

계정 권한회원 권한계정 상태회원 상태계정 인증
kakao:writerole-kakao:writeACTIVEACTIVEO

Path Parameters

NameDescription
:templateId템플릿 고유 아이디

Request Structure

{
"name": "string",
"content": "string",
"buttons": [
{
"buttonType": "string",
"buttonName": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string"
}
],
"quickReplies": [
{
"name": "string",
"linkType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string"
}
],
"categoryCode": "string",
"extra": "string",
"ad": "string",
"emphasizeTitle": "string",
"emphasizeSubtitle": "string",
"messageType": "string",
"emphasizeType": "string",
"header": "string",
"highlight": {
"title": "string",
"description": "string",
"imageId": "string"
},
"item": {
"list": [
{
"title": "string",
"description": "string"
}
],
"summary": {
"title": "string",
"description": "string"
}
},
"securityFlag": "boolean",
"imageId": "string"
}

Body Params

NameTypeRequiredDescription
namestring알림톡 이름. 최대 100자
contentstring템플릿 내용
buttonsarray템플릿에 들어가는 버튼들
quickRepliesarray바로 연결. 최소 1개, 최대 10개.
categoryCodestring카카오톡 채널 카테고리 코드
extrastring부가정보. 변수 포함 불가능. 최대 500자
adstring채널 추가 문구. 문구는 채널 추가하고 이 채널의 광고와 마케팅 메시지를 카카오톡으로 받기 고정입니다.
emphasizeTitlestring강조 표기 문구. 변수가 들어갈 수 있습니다. 템플릿 강조유형이 강조표기형일 때만 사용할 수 있습니다. 최대 50자
emphasizeSubtitlestring강조 표기 보조 문구. 변수가 들어갈 수 없습니다. 템플릿 강조유형이 강조표기형일 때만 사용할 수 있습니다. 최대 50자
messageTypestring메시지 유형. 기본값: BA
  • BA: 기본형
  • EX: 부가정보형
  • AD: 채널추가형
  • MI: 복합형
emphasizeTypestring강조 유형. 기본값: NONE
  • NONE: 선택안함
  • TEXT: 강조표기형
  • IMAGE: 이미지형
  • ITEM_LIST: 아이템 리스트
headerstring알림톡 헤더. 강조 유형이 아이템 리스트일 때만 사용 가능합니다. 변수 포함 가능. 최대 16자
highlightobject알림톡 하이라이트. 강조 유형이 아이템 리스트일 때만 사용 가능합니다.
itemobject알림톡 아이템. 목록과 요약이 있습니다. 강조 유형이 아이템 리스트일 때만 사용 가능합니다.
securityFlagboolean보안 템플릿 여부. true일 경우 해당 템플릿을 PC에서는 확인할 수 없습니다. 기본값: false
imageIdstring알림톡에 사용되는 이미지 고유 아이디
Body / buttons
NameTypeRequiredDescription
buttonTypestringO버튼 유형(DS:배송조회, WL:웹링크, AL:앱링크, BK:봇키워드 MD: 메시지전달 BC: 상담톡 전환 BT: 봇전환 AC: 채널추가)
buttonNamestring버튼 이름. 변수 포함 불가능. 최대 14자.
linkMostring모바일 링크(WL 웹링크)
linkPcstring웹 링크(WL 웹링크)
linkAndstring안드로이드 링크(AL 앱링크)
linkIosstringIOS 링크(AL 앱링크)
Body / quickReplies
NameTypeRequiredDescription
namestringO바로 연결 이름. 변수 포함 불가능
linkTypestringO링크 타입(WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달, BC: 상담톡 전환, BT: 봇전환)
linkMostring모바일 링크(WL 웹링크)
linkPcstring웹 링크(WL 웹링크)
linkAndstring안드로이드 링크(AL 앱링크)
linkIosstringIOS 링크(AL 앱링크)
Body / highlight
NameTypeRequiredDescription
titlestring알림톡 하이라이트 제목. 변수 포함 가능. 최대 30자
descriptionstring알림톡 하이라이트 내용. 변수 포함 불가능. 최대 16자
imageIdstring알림톡에 사용되는 이미지 고유 아이디. 이미지 타입이 ATA일 경우에만 사용 가능합니다.
이미지 관리 페이지 (로그인 필요)
이미지 관리 API
Body / item
NameTypeRequiredDescription
listarray알림톡 아이템 리스트. 최소 2개, 최대 10개까지 등록할 수 있습니다.
summaryobject알림톡 아이템 리스트 요약.
Body / item / list
NameTypeRequiredDescription
titlestringO알림톡 아이템 리스트 제목. 변수 포함 불가능. 최대 6자
descriptionstringO알림톡 아이템 리스트 제목. 변수 포함 가능. 최대 23자
Body / item / summary
NameTypeRequiredDescription
titlestring알림톡 아이템 리스트 요약 제목. 변수 포함 불가능. 최대 6자
descriptionstring알림톡 아이템 리스트 요약 내용. 변수 포함 가능. 화폐 단위, 숫자, 쉼표, 마침표만 사용 가능합니다. 최대 14자.

문서 생성일 : 2024-10-29