API

템플릿 목록 엑셀 다운로드

작성일 2026.03.05 | 수정일 2026.03.25

GET/kakao/v2/excel/templates
Query
channelId— 템플릿을 다운로드할 카카오톡 채널 ID
templateId— 다운로드 대상 템플릿 ID
isHidden— 숨김 처리된 템플릿 포함 여부 (기본값: false)
status— 템플릿 상태로 필터링

알림톡 템플릿 목록을 엑셀 파일(.xlsx)로 다운로드합니다. 채널(CHANNEL) 타입 템플릿만 지원하며 그룹 템플릿은 포함되지 않습니다.

chat
  • 삭제된 템플릿은 자동 제외됩니다.

  • 숨김 처리된 템플릿도 기본적으로 제외되지만 isHidden 파라미터로 변경할 수 있습니다.

  • 날짜 필드는 KST(Asia/Seoul) 시간대의 YYYY-MM-DD HH:mm:ss 형식으로 출력됩니다.

  • buttons·quickReplies·highlight·item·variables 등 복합 필드는 JSON 문자열로 출력됩니다.

  • 채널명(channelName)은 채널 ID를 기반으로 자동 조회되어 추가됩니다.

  • 다운로드된 엑셀 파일은 템플릿 목록 엑셀 업로드 API의 입력 양식으로 바로 사용할 수 있습니다.

엑셀 컬럼 구조

NameDescription
accountId계정 ID
channelId채널 ID
channelName채널명
templateId템플릿 ID
name템플릿 이름
content템플릿 내용
status상태
securityFlag보안 메시지 여부
categoryCode카테고리 코드
isHidden숨김 여부
messageType메시지 유형
emphasizeType강조 유형
extra부가정보
ad광고 문구
emphasizeTitle강조표기 제목
emphasizeSubtitle강조표기 보조문구
imageId이미지 ID
header헤더
highlight하이라이트 (JSON)
item아이템 리스트 (JSON)
buttons버튼 (JSON)
quickReplies바로연결 (JSON)
variables변수 목록 (JSON)
dateCreated생성 일시 (KST)
dateUpdated수정 일시 (KST)