자체 알림톡 템플릿을 삭제합니다. 승인(APR)된 템플릿은 지울 수 없고, 그 밖의 상태는 삭제됩니다. 승인된 것을 지우려 하면 -48 이 돌아오고 템플릿은 그대로 남습니다. 승인 전 템플릿은 같은 채널을 쓰는 프로젝트라면 어디서나 지울 수 있습니다 — 같은 채널을 함께 쓸 때
상태별 삭제 조건
| 상태 | 동작 |
|---|---|
| 아직 올리기 전 | 부트페이에만 있으므로 그대로 삭제됩니다 |
| 올라간 것 (대기·정상·중단) | 카카오에서 지워져야 삭제됩니다. 거부되면 아무것도 지우지 않고 오류를 돌려줍니다 |
부트페이에서만 지우면 그 템플릿 코드가 카카오 쪽에 남아 다시 쓸 수 없게 되므로, 한쪽만 지우지 않습니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
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 | 메시지 | 대처 방법 |
|---|---|---|---|
-48 |
INVALID_PARAMETER |
승인된 템플릿은 삭제할 수 없음 | 삭제 대신 사용하지 않는 것으로 정리합니다 |
3013 |
KAKAO_TEMPLATE_REQUEST_FAILED |
카카오가 삭제를 거부 | 템플릿은 그대로 남아 있습니다. 잠시 뒤 다시 시도하고, 계속되면 부트페이에 문의합니다 |
3015 |
TEMPLATE_NOT_FOUND |
템플릿 없음 | id 또는 코드를 확인합니다 |
3018 |
SENDER_NOT_VERIFIED |
발신 채널 확인 불가 | 채널을 다시 연동한 뒤 시도합니다 |
3024 |
SENDER_NOT_LINKED |
발신프로필 미연결 | 이 프로젝트의 채널인지 확인합니다 |
승인된 문구를 바꾸려면
승인된 템플릿은 수정도 삭제도 할 수 없습니다. 새 이름·새 코드로 템플릿을 만들어 검수를 다시 받고, 발송 코드를 새 템플릿으로 옮깁니다.



