승인(APR)된 템플릿은 지울 수 없고, 그 밖의 상태는 지워져요. 승인된 것을 지우려 하면 3013 이 돌아오고 템플릿은 그대로 남아요.
상태에 따라 조건이 달라요
| 상태 | 동작 |
|---|---|
| 아직 올리기 전 | 부트페이에만 있으니 그대로 지워져요 |
| 올라간 것 (대기·정상·중단) | 카카오에서 지워져야 삭제돼요. 거부되면 아무것도 지우지 않고 오류를 돌려줘요 |
카카오에서 지워지지 않았는데 부트페이에서만 지우면 그 템플릿 코드가 카카오 쪽에 남아 다시 쓸 수 없게 돼요. 그래서 한쪽만 지우지 않아요.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
id |
String | 필수 | 템플릿 문서 id (경로 파라미터) |
코드 예제
curl -X DELETE "https://message.bootapi.com/alimtalk/templates/68b0f2a1c3d4e5f6a7b8c9d0" \
-H "Authorization: Basic {base64(client_key:secret_key)}"bashrequire 'bootpay'
commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.alimtalk_template_delete(template_id: '68b0f2a1c3d4e5f6a7b8c9d0')
puts response.success?ruby응답
성공하면 본문이 null 이에요. storage 에 올려 둔 이미지 원본도 함께 정리돼요.
nulljson에러 코드
| 코드 | error_code | 메시지 | 대처 방법 |
|---|---|---|---|
3013 |
KAKAO_TEMPLATE_REQUEST_FAILED |
카카오가 삭제를 거부 | 승인된 템플릿이에요. 삭제 대신 쓰지 않는 쪽으로 정리해요 |
3015 |
TEMPLATE_NOT_FOUND |
템플릿 없음 | id 또는 코드를 확인해요 |
3018 |
SENDER_NOT_VERIFIED |
발신 채널 확인 불가 | 채널을 다시 연동한 뒤 시도해요 |
3024 |
SENDER_NOT_LINKED |
발신프로필 미연결 | 이 프로젝트의 채널인지 확인해요 |
승인된 문구를 바꾸고 싶다면
승인된 템플릿은 수정도 삭제도 안 돼요. 새 이름·새 코드로 템플릿을 만들어 검수를 다시 받고, 발송 코드를 새 템플릿으로 옮기는 방법을 써요.