템플릿 수정

검수에서 반려됐거나, 등록만 해 두고 아직 검수를 요청하지 않은 자체 템플릿을 수정합니다.

덮어쓰기이므로 요청에 없는 필드는 지워집니다. 바꿀 값만 보내는 부분 수정은 지원하지 않습니다. 템플릿 상세로 현재 값을 읽어 고칠 곳만 바꾼 뒤, 전체를 그대로 다시 보냅니다.

이름만 바꾸려고 name 만 보내면 본문과 메시지 유형이 비어 3017 로 거부됩니다. content 와 msg_type 까지 보내도 빠진 버튼·이미지·강조 설정·태그는 지워집니다.

이미지를 빼면 카카오에서도 삭제됩니다

이미 올라간 템플릿을 고치면 카카오에 그대로 수정 요청이 나갑니다. 이미지 필드를 빠뜨리면 부트페이 쪽뿐 아니라 카카오에 올려 둔 이미지까지 삭제로 반영됩니다.

PUThttps://message.bootapi.com/alimtalk/templates/{id}Basic Auth

수정할 수 있는 상태

상태 수정 가능
아직 올리기 전 가능
REG (등록) 가능
REJ (승인 반려) 가능. 고친 뒤 다시 검수를 요청합니다
KRR (등록 거절) 가능
REQ (검수 중) 거부 — 결과를 기다립니다
APR (승인) 거부 — 승인된 문구는 바꿀 수 없습니다

승인된 템플릿의 문구를 바꿔야 한다면 새 템플릿을 만들어 검수를 다시 받습니다.

요청 파라미터

파라미터는 템플릿 생성과 같습니다. ksp_id와 register만 받지 않습니다.

필수 는 요청이 거부되는지의 기준입니다. 전체를 덮어쓰므로 N 인 필드도 빼면 그 값이 지워집니다. 유지하려면 현재 값을 그대로 실어 보냅니다.

파라미터 타입 필수 설명
id String 필수 템플릿 문서 id (경로 파라미터)
name String 선택 템플릿 이름. 빼면 비워집니다
content String 필수 본문 (최대 1000자). 빼면 3017
msg_type String 필수 BA·EX·AD·MI. 생성과 달리 기본값이 없어서 빼면 3017
emphasize_type String 선택 NONE·TEXT·IMAGE·ITEM_LIST
emphasize_title String 선택 강조 타이틀 (최대 50자)
emphasize_subtitle String 선택 강조 보조문구 (최대 40자). 변수를 쓸 수 없습니다 (3017)
template_extra String 선택 부가정보 문구
template_header String 선택 아이템리스트형 헤더 (최대 16자)
item_highlight Object 선택 아이템 하이라이트
template_item Object 선택 아이템 리스트
buttons Array 선택 버튼 (최대 5개). 웹링크(WL)의 linkMo·linkPc는 https://#{변수명} 형식만 받습니다 — 자세한 규칙은 템플릿 생성의 버튼 항목을 참고합니다
image_url String 선택 카카오 사본 이미지 URL
storage_image_url String 선택 원본 이미지 URL. 빈 값으로 보내면 이미지 삭제​​로 처리됩니다
security_flag Boolean 선택 보안 템플릿 여부
category String 선택 분류
tags Array 선택 태그
examples Object 선택 변수 예문(표시용)
template_code String 선택 템플릿 코드 변경. 아직 올리기 전일 때만 반영​​되고, 이미 올라간 템플릿에서는 무시됩니다. 중복이면 3019 로 거절됩니다

코드 예제

curl -X PUT "https://message.bootapi.com/alimtalk/templates/68b0f2a1c3d4e5f6a7b8c9d0" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "예약 확정 안내",
    "content": "#{company_name}\n#{user_name}님, #{booking_date} 예약이 확정되었어요. 방문 10분 전까지 와 주세요.",
    "msg_type": "BA",
    "emphasize_type": "NONE",
    "buttons": [
      {
        "name": "예약 확인하기",
        "linkType": "WL",
        "linkMo": "https://#{mobile_link}"
      }
    ]
  }'bash

응답

수정된 템플릿 전체를 돌려줍니다. 구조는 템플릿 상세와 같습니다.

에러 코드

코드 error_code 메시지 대처 방법
-48 INVALID_PARAMETER 수정 불가 상태 검수 중(REQ)이거나 승인(APR)된 템플릿입니다
3015 TEMPLATE_NOT_FOUND 템플릿 없음 id 또는 코드를 확인합니다
3017 TEMPLATE_VARIABLE_MISSING 규격 위반 글자 수·강조표기 조건·버튼 규격(웹링크는 https://#{변수명} 형식)을 확인합니다. content·msg_type을 빼도 이 코드가 옵니다
3018 SENDER_NOT_VERIFIED 발신 채널 확인 불가 등록된 템플릿을 고칠 때 채널 키를 찾지 못했습니다. 채널을 다시 연동합니다
3019 TEMPLATE_CODE_DUPLICATED 템플릿 코드 중복 template_code를 다른 값으로 바꿉니다
3024 SENDER_NOT_LINKED 발신프로필 미연결 이 프로젝트의 채널인지 확인합니다
3027 TEMPLATE_NAME_DUPLICATED 템플릿 이름 중복 같은 채널 안에서 이름이 겹칩니다
3013 KAKAO_TEMPLATE_REQUEST_FAILED 수정 거부 (HTTP 500) 이미 올라간 템플릿일 때만 발생합니다. message의 사유를 확인합니다

함께 보기