현재 제공되는 Sandbox 테스트 환경에서 문자나 알림톡을 실제로 발송해 볼 수 있는 방법이 있는지 궁금합니다. API 키는 Sandbox와 호환되지만, senderKey가 호환되지 않아 알림톡 기능 등을 테스트하는 데 어려움이 있습니다. 현재로서는 실버전 환경을 이용하는 방법뿐인지 확인 부탁드립니다.
2. 공용 템플릿 상세 조회 기능 관련
공용 템플릿 조회 API를 확인하였으나, 템플릿 본문을 상세하게 조회할 수 있는 기능이 보이지 않아 발송 폼 구축에 어려움을 겪고 있습니다. 혹시 공용 API를 통해서는 본문 확인 및 발송이 불가능한 것인지 문의드립니다.
3. 반려(REJ) 템플릿 재검수 플로우
반려된 템플릿을 수정(PUT)하면 검수상태가 REG로 리셋되어 재검수 요청이 가능한가요? 그리고 휴면 템플릿의 경우 다시 활성화 할 수 있는 방법이 있는지 문의드립니다.
4. 반려 사유 수신 경로
알림톡 템플릿 조회 API의 응답값에 반려 사유(comments)가 없는데, 실제 호출을 해보면 comments가 함께 전송되는 것을 확인했습니다. 혹시 정확한 타입을 알 수 있을까요?
말씀해주신대로 Sandbox는 실제 발송 없이 요청 전문(JSON) 규격과 API 응답 흐름을 사전에 검증하기 위한 환경입니다.
단말 수신 여부까지 확인하시려면 실운영망에서 테스트하셔야 합니다.
실운영망 테스트가 필요하신 경우, 담당 영업 담당자분께 문의하시어 테스트 발송 건수를 별도로 요청하시면 가능하십니다.
2. 공용 템플릿 상세(본문) 조회
공용 템플릿 목록 조회 API를 통해 반환된 templateCode를 활용하시면, 아래 템플릿 조회 API 를 통해 본문을 포함한 상세 정보를 조회하실 수 있습니다.
이때 senderKey는 현재 사용 중이신 발신프로필 키 중 아무 키나 입력하셔도 무방합니다.
3. 반려(REJ) 템플릿 재검수 / 휴면 템플릿 재활성화
재검수의 경우, 검수 상태가 REG(등록) 또는 REJ(반려)이고 템플릿 상태가 대기(R)인 경우에만 수정이 가능합니다. 반려된 템플릿을 수정(PUT)하시면 검수 상태가 REG(검수요청) 단계로 초기화되어 재검수 요청이 가능합니다.
다만, 이미 승인(APR) 상태인 템플릿은 한 번도 발송된 적이 없는 경우에 한해 승인 취소 후 수정이 가능한 점 참고 부탁드립니다.
휴면 템플릿의 경우, 재활성화(휴면 해제)가 가능합니다. 단, 카카오 정책에 따라 휴면 해제 후 30일 이내에 발송 이력이 없으면 다시 휴면 처리되며, 휴면 상태로 1년이 경과하면 템플릿이 영구 삭제되어 복구가 불가합니다. 이 점 꼭 유의하시어 관리 부탁드립니다.
4. 반려 사유(comments) 타입
말씀하신 대로 현재 템플릿 조회 API의 응답 스펙 문서에 comments 항목이 누락되어 있습니다.
불편을 드려 죄송합니다.
해당 필드는 반려 사유 문자열을 담는 String 타입으로, 반려(REJ) 상태가 아닌 경우에는 빈 값이거나 응답에 포함되지 않을 수 있습니다.
관련 문서는 조속히 업데이트할 예정이오니 양해 부탁드립니다.
휴면 템플릿의 재활성화는 휴면템플릿에 put 메소드를 사용하면 바로 해제가 되는것인지 아니면 별도 휴면해제 처리가 되는 것인지 궁금합니다.
추가로 알림톡 템플릿 삭제 API(DELETE /v1/center/alimtalk/template/senderKey/{key}/templateCode/{code})에서 코드에 공백이 포함된 경우(test templete, URL 인코딩 %20 적용) 게이트웨이가 common.authCode=A404 Not Found로 응답하며 템플릿 서비스에 도달하지 못합니다. 동일 코드가 등록(POST)·조회(GET 쿼리)·심사요청에서는 정상 동작하므로, 등록 시 코드 형식 검증이 없는 것과 삭제 라우팅이 비대칭이라는 ai 답변을 받았는데, 확인 부탁드립니다.
재현 trId: M-260605152631888PRD00137 (인코딩 적용 DELETE, 2026-06-05 15:26)
휴면 상태의 템플릿은 PUT /v1/center/alimtalk/template/senderKey/{key}/templateCode/{code} 호출 시 별도의 휴면 해제 절차 없이 바로 재활성화 처리됩니다. 요청이 정상 처리되면 템플릿 상태가 즉시 활성 상태로 전환됩니다.
2. 알림톡 템플릿 삭제 API 공백 코드 이슈
말씀하신 문제를 확인한 결과, DELETE 엔드포인트의 경로 파라미터 처리 시 URL 인코딩된 공백(%20)을 올바르게 라우팅하지 못하는 버그로 확인되었습니다. POST(등록), GET(조회), 심사요청 등 다른 메소드에서는 정상 동작하지만 DELETE 라우팅만 비대칭적으로 처리되던 문제였으며, 금일 패치가 완료되었습니다.
재현 trId(M-260605152631888PRD00137) 기준으로 확인하였으며, 패치 이후 동일 조건으로 테스트 시 정상 동작함을 확인하였습니다.
문의 접수 후 답변이 늦어진 점 진심으로 사과드립니다. 추가로 궁금하신 사항이 있으시면 언제든지 문의해 주세요.
