SDK

알림톡 템플릿 관리

작성일 2026.02.23 | 수정일 2026.02.23

해당 페이지에서 작성된 모든 코드는 Java로 작성되었습니다.
각 예시에 대한 결과 값 표시 기능은 현재 준비중에 있습니다.
해당 예제는 SDK 1.0.3 버전을 기준으로 작성되었습니다.

lightbulb

템플릿을 생성/수정하려면 카테고리 코드를 미리 조회하셔야 합니다.

문서가 작성된 순서로 코드를 작성하여 템플릿을 생성/수정해보세요!

알림톡 템플릿 관련 파라미터 항목들은 Request 객체 설명 문서를 참고 해주세요!

템플릿 카테고리 조회

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

for (KakaoAlimtalkTemplateCategory category : messageService.getKakaoAlimtalkTemplateCategories()) {
  // 알림톡 템플릿 카테고리 코드
  System.out.println(category.getCode());
  // 알림톡 템플릿 카테고리 이름
  System.out.println(category.getName());
}

템플릿 생성

템플릿 생성에 관련된 세부 파라미터는 알림톡 템플릿 생성/수정 Request 객체 설명 문서를 참고 해주세요!

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

KakaoAlimtalkTemplateMutationRequest request = new KakaoAlimtalkTemplateMutationRequest();
request.setName("등록할 템플릿 제목(등록된 템플릿과 중복불가)");
request.setContent("등록할 템플릿 내용");
request.setChannelId("등록할 템플릿의 채널 ID(pfId)");
request.setCategoryCode("조회한 템플릿 카테고리 코드");

KakaoAlimtalkTemplateResponse created = messageService.createKakaoAlimtalkTemplate(request);
System.out.println(created);

템플릿 검수

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

// 템플릿 검수 요청, 반드시 대기 상태의 템플릿만 검수 요청할 수 있습니다.
messageService.requestKakaoAlimtalkTemplateInspection("검수할 알림톡 템플릿 ID");

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

// 템플릿 검수 취소, 반드시 검수중 상태의 템플릿만 취소할 수 있습니다.
messageService.cancelKakaoAlimtalkTemplateInspection("검수취소할 알림톡 템플릿 ID");

템플릿 조회(목록, 단일 건 포함)

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

KakaoAlimtalkTemplateResponse single = messageService.getKakaoAlimtalkTemplate("조회할 알림톡 template ID");
System.out.println(single);

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

KakaoAlimtalkTemplateListResponse list = messageService.getKakaoAlimtalkTemplates();
System.out.println(list);

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

KakaoAlimtalkTemplateListResponse list = messageService.getKakaoAlimtalkTemplates();
System.out.println(list);

템플릿 수정

템플릿 수정에 관련된 세부 파라미터는 알림톡 템플릿 생성/수정 Request 객체 설명 문서를 참고 해주세요!

warning

템플릿 수정 시 channelId(혹은 channelGroupId)는 수정할 수 없습니다.

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

KakaoAlimtalkTemplateMutationRequest request = new KakaoAlimtalkTemplateMutationRequest();
// request.setName("수정할 템플릿 제목(등록된 템플릿과 중복불가)");
// request.setContent("수정할 템플릿 내용");
// request.setCategoryCode("999999");

KakaoAlimtalkTemplateResponse updated = messageService.updateKakaoAlimtalkTemplate("수정할 알림톡 템플릿 ID", request);
System.out.println(updated);

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");
messageService.updateKakaoAlimtalkTemplateName("수정할 알림톡 템플릿 ID", "새 템플릿 이름");

템플릿 삭제

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");
messageService.removeKakaoAlimtalkTemplate("삭제할 알림톡 템플릿 ID");

발송 가능한 템플릿 목록 조회

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

// 발송 가능한 템플릿 목록 조회
List<KakaoAlimtalkTemplateResponse> sendables = messageService.getSendableKakaoAlimtalkTemplates();
System.out.println(sendables);

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

KakaoAlimtalkSendableTemplateListRequest request = new KakaoAlimtalkSendableTemplateListRequest();
request.setChannelId("카카오 채널 ID 입력(구 pfId)");

List<KakaoAlimtalkTemplateResponse> sendables = messageService.getSendableKakaoAlimtalkTemplates(request);
System.out.println(sendables);

브랜드 메시지 템플릿 조회

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

KakaoBrandMessageTemplateListResponse brandList = messageService.getKakaoBrandMessageTemplates();
System.out.println(brandList);

DefaultMessageService messageService = SolapiClient.INSTANCE.createInstance("API 키 입력", "API 시크릿 키 입력");

KakaoBrandMessageTemplateListRequest request = new KakaoBrandMessageTemplateListRequest();
request.setPfId("연동한 비즈니스 채널의 pfId");
request.setLimit(10);

KakaoBrandMessageTemplateListResponse brandList = messageService.getKakaoBrandMessageTemplates(request);
System.out.println(brandList);