API

발송 가능 템플릿 목록 조회

작성일 2026.03.08 | 수정일 2026.03.08

GET/kakao/v2/templates/sendable

Query

channelId— 카카오톡 채널 ID

templateId— 템플릿 ID

senderKey— 발신 프로필 키

templateCode— 템플릿 코드

현재 실제로 알림톡 발송에 사용할 수 있는 템플릿만 필터링하여 조회합니다.
계정에 연결된 카카오톡 채널 및 채널 그룹의 템플릿을 모두 조회하므로, 알림톡 발송 전에 사용 가능한 템플릿을 확인하거나 발송 UI에서 템플릿 선택 목록을 구성할 때 유용합니다.

승인(APPROVED)되고 휴면(dormant)이 아닌 템플릿만 반환됩니다.
숨김 처리(isHidden: true)되거나 삭제된 템플릿은 조회되지 않습니다.

chat

페이지네이션 없이 조건에 맞는 전체 템플릿을 배열로 반환합니다. 각 항목은 공통 응답 스키마를 참고하세요.

Structure

Response

[
  {
    "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": "이름"
      }
    ]
  }
]