API

템플릿 정보 조회

작성일 2026.03.08 | 수정일 2026.03.08

GET/kakao/v2/templates/:templateId

Parameters

templateId— 템플릿 고유 ID

특정 템플릿의 상세 정보를 조회합니다. 템플릿 ID를 알고 있을 때 해당 템플릿의 현재 상태, 내용, 검수 의견 등 전체 정보를 확인할 수 있습니다.

chat

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

조회 시 카카오 중개사(biz, kakaoenterprise)를 통해 휴면(dormant) 상태를 실시간으로 확인하고 업데이트하므로 항상 최신 상태를 반환합니다.
중개사 조회 중 오류가 발생해도 기존 템플릿 정보는 정상 반환됩니다.

응답 예시

{
  "templateId": "TP01ABC",
  "name": "주문 알림",
  "channelId": "CH01ABC",
  "channelGroupId": null,
  "assignType": "CHANNEL",
  "accountId": "AC01ABC",
  "securityFlag": false,
  "categoryCode": "003001",
  "isHidden": false,
  "isDeleted": false,
  "content": "#{이름}님의 주문이 완료되었습니다.\n주문번호: #{주문번호}",
  "buttons": [
    {
      "buttonType": "WL",
      "buttonName": "주문 확인",
      "linkMo": "https://example.com/orders",
      "linkPc": "https://example.com/orders",
      "linkAnd": "exampleapp://orders",
      "linkIos": "exampleapp://orders",
      "chatExtra": null,
      "targetOut": false
    }
  ],
  "quickReplies": [],
  "highlight": {
    "title": "주문 완료",
    "description": "결제가 완료되었습니다.",
    "imageId": "IMG01ABC"
  },
  "item": {
    "list": [
      {
        "title": "상품명",
        "description": "예시 상품 A"
      }
    ],
    "summary": {
      "title": "총 결제금액",
      "description": "10,000원"
    }
  },
  "comments": [
    {
      "content": "검수 부탁드립니다.",
      "dateCreated": "2024-01-02T00:00:00.000Z"
    }
  ],
  "code": "template_001",
  "commentable": true,
  "status": "APPROVED",
  "messageType": "MI",
  "emphasizeType": "ITEM_LIST",
  "extra": "본 메시지는 정보통신망법에 의거하여 발송되었습니다.",
  "ad": "채널 추가하고 소식을 받아보세요.",
  "emphasizeTitle": "주문 완료",
  "emphasizeSubtitle": "결제가 정상 처리되었습니다.",
  "imageId": "IMG02ABC",
  "header": "주문 내역",
  "dateCreated": "2024-01-01T00:00:00.000Z",
  "dateUpdated": "2024-01-05T00:00:00.000Z",
  "variables": [
    {
      "name": "이름"
    },
    {
      "name": "주문번호"
    }
  ]
}