알림톡 템플릿 상세

GET

https://api.claw-ops.com/v1/accounts/:accountId/kakao/templates/:templateId

GET

/v1/accounts/:accountId/kakao/templates/:templateId

curl https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/kakao/templates/clx9tpl0001 \
     -H "Authorization: Bearer <token>"

{
  "id": "clx9tpl0001",
  "channelId": "clx9kak0001",
  "name": "주문 접수 안내",
  "content": "#{고객명}님, 주문이 접수되었습니다.",
  "status": "APPROVED",
  "dormant": false,
  "sendable": true,
  "assignType": "CHANNEL",
  "messageType": "BA",
  "emphasizeType": "NONE",
  "variables": [
    "#{고객명}"
  ],
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T09:30:00Z",
  "categoryCode": "002001",
  "useExtra": true,
  "useChannelAdd": true,
  "buttons": [
    {
      "buttonType": "WL",
      "buttonName": "주문 확인",
      "linkMo": "https://example.com/orders",
      "linkPc": "string",
      "linkAnd": "string",
      "linkIos": "string",
      "chatExtra": "string",
      "targetOut": true
    }
  ],
  "quickReplies": [
    {
      "buttonType": "WL",
      "buttonName": "주문 확인",
      "linkMo": "https://example.com/orders",
      "linkPc": "string",
      "linkAnd": "string",
      "linkIos": "string",
      "chatExtra": "string",
      "targetOut": true
    }
  ],
  "hasImage": true,
  "securityFlag": true,
  "inspectionComments": [
    {
      "content": "string",
      "createdAt": "2026-11-03T01:20:00.000Z",
      "fromReviewer": true
    }
  ],
  "extra": "string",
  "ad": "string",
  "emphasizeTitle": "string",
  "emphasizeSubtitle": "string",
  "header": "string",
  "highlight": {
    "title": "string",
    "description": "string"
  },
  "item": {}
}

버튼·강조 내용과 검수 의견을 포함해 돌려줍니다. 반려 사유는 inspectionComments 에 있습니다. 조회할 때 검수 상태를 최신으로 맞춥니다(채널당 최대 1분에 한 번). 공급자 응답이 없으면 저장된 값을 돌려줍니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

templateIdstringRequired

템플릿 리소스 ID

Response

템플릿

idstring

한국AI통신 템플릿 리소스 ID. 발송 요청의 Kakao.TemplateId에 이 값을 사용합니다.

channelIdstring

한국AI통신 채널 리소스 ID. 발송 요청의 Kakao.ChannelId와 같은 값입니다.

namestring

contentstring

템플릿 본문.

statusstring

카카오 검수 상태. PENDING·INSPECTING·APPROVED·REJECTED 입니다. 발송에는 APPROVED 템플릿만 사용할 수 있습니다.

dormantboolean

휴면 템플릿 여부. true면 승인 상태여도 발송할 수 없습니다.

sendableboolean

현재 발송에 사용할 수 있으면 true.

assignTypestring

CHANNEL(채널 소유) 또는 GROUP(기본 제공).

messageTypestring

emphasizeTypestring

variableslist of strings

발송 요청의 Kakao.Variables에 모두 채워야 하는 변수 이름.

createdAtdatetime

updatedAtdatetime

categoryCodestring or null

useExtraboolean

부가정보 사용 여부

useChannelAddboolean

채널 추가 안내 사용 여부

buttonslist of objects

quickReplieslist of objects

hasImageboolean

이미지가 있으면 true. 이미지가 있는 템플릿의 내용은 콘솔에서 수정합니다.

securityFlagboolean

inspectionCommentslist of objects

검수 의견. 반려 사유가 여기에 있습니다.

extrastring or nullOptional

adstring or nullOptional

emphasizeTitlestring or nullOptional

emphasizeSubtitlestring or nullOptional

headerstring or nullOptional

highlightobject or nullOptional

itemobject or nullOptional

아이템 목록(list)과 요약(summary)

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error