템플릿 목록 조회
작성일 2026.03.08 | 수정일 2026.03.08
GET
/kakao/v2/templates/Query
name— 템플릿 이름 (지원 연산자: eq, ne, like)
channelId— 카카오톡 채널 ID
channelGroupId— 채널 그룹 ID
templateId— 템플릿 ID
isHidden— 숨김 여부
status— 템플릿 상태 (PENDING, INSPECTING, APPROVED, REJECTED)
isMine— 내 템플릿만 조회
startKey— 페이징 시작 키
limit— 조회 건수
dateCreated— 생성 일시 (지원 연산자: eq, gte, lte, gt, lt)
dateUpdated— 수정 일시 (지원 연산자: eq, gte, lte, gt, lt)
chat
지원 연사자를 사용하실 경우 Query Operator 가이드를 참조하세요
등록된 알림톡 템플릿의 목록을 조회합니다. 채널별, 그룹별, 상태별 등 다양한 조건으로 필터링할 수 있으며, 페이지네이션을 지원합니다.
Response
템플릿 객체의 자세한 사항은 공통 응답 스키마를 참조해주세요
Structure
Response
{
"templateList": [
{
"templateId": "TP01ABC",
"name": "주문 알림",
"channelId": "CH01ABC",
"channelGroupId": null,
"assignType": "CHANNEL",
"accountId": "AC01ABC",
"securityFlag": false,
"categoryCode": "003001",
"isHidden": false,
"isDeleted": false,
"content": "#{이름}님의 주문이 완료되었습니다.",
"buttons": [
{
"buttonType": "WL",
"buttonName": "주문 확인",
"linkMo": "https://example.com/orders",
"linkPc": "https://example.com/orders",
"linkAnd": null,
"linkIos": null,
"chatExtra": null,
"targetOut": false
}
],
"quickReplies": [],
"highlight": {
"title": null,
"description": null,
"imageId": null
},
"item": {
"list": null,
"summary": null
},
"comments": [],
"code": "template_001",
"commentable": true,
"status": "APPROVED",
"messageType": "BA",
"emphasizeType": "NONE",
"extra": null,
"ad": null,
"emphasizeTitle": null,
"emphasizeSubtitle": null,
"imageId": null,
"header": null,
"dateCreated": "2024-01-01T00:00:00.000Z",
"dateUpdated": "2024-01-01T00:00:00.000Z",
"variables": [
{
"name": "이름"
}
]
}
],
"limit": 20,
"startKey": null,
"nextKey": "TP02DEF"
}