그룹메시지 발송기능(알림톡) 관련 문의드립니다.

[J-Yong99]

사용 중인 프로그래밍 언어 및 버전

java 17

SDK 버전

1.0

운영 환경

AWS/클라우드/호스팅 서버 등 상용 웹 서버

질문/문제 설명

그룹메시지 관련 api 문서를 읽어봤는데, 알림톡 템플릿에 들어가는 variables param관련해서 질문이 있습니다.
object로만 표기되어 있어서 정확히 이해가 안가는 부분이 있어서 질문 남깁니다.

만약 100건의 요청을 보내게 된다면, 100개의 variables를 보내서 각 메시지 별 템플릿 변수를 받는건지,
아니면 동일한 템플릿 변수 하나로 동일한 메세지를 100명에게 보내는건지 궁금합니다.

즉, 100명에게 각각 다른 100개의 템플릿 변수를 적용시켜서 전송하는것이 가능한지 궁금합니다.

코드 예시

No response

시도한 해결 방법

No response

기대하는 결과

기존 api로 가능한지 여부가 궁금합니다.

확인사항

• 관련 문서를 확인했습니다
• 이전 토론/이슈에서 유사한 질문이 없는지 확인했습니다
• 문의 전 읽어야 하는 사항(문의 전 꼭 읽어봐주세요! #7)을 확인했습니다

[Palbahngmiyine]

안녕하세요 회원님, 솔라피 기술지원팀입니다.
말씀하신 variables는 각 메시지 객체마다 다르게 설정하여 보낼 수 있습니다.
아래 예제 링크를 확인 부탁드리며, 해당 링크를 통해 확인해보시면 바로 아래에 여러 알림톡을 보내는 예제에 대해서도 확인하실 수 있사오니 업무에 참고 해 주시기 바라겠습니다.

https://github.com/solapi/solapi-java-examples/blob/d2ebf857743ed3338f7ccfd4d640adcd66db9383/maven-spring-demo/src/main/java/com/solapi/mavenspringdemo/KakaoExampleController.java#L61-L66

감사합니다.

[J-Yong99]

친절한 답변감사합니다!

멘션해주신 L61-L66 부분 확인해보았는데, 단일 발송으로는 가능함을 인지했습니다.

제가 궁금한 부분은 5000건 정도의 대량 발송 API(@PostMapping("/send-many-ata"))에서도 메세지 별 variables 설정이 가능한건지,
아니면 이 경우에 "@PostMapping("/send-one-ata")"를 여러 번 발송하는것이 맞을지 여쭙고 싶습니다.

[Palbahngmiyine]

네 맞습니다 회원님, 예시로는 단일건만 되는 것 처럼 보이지만, 실제로는 각기 다른 메시지 객체(동일하게 넣으셔도 무방합니다)를 ArrayList로 담고 send 메소드에 추가하신 메시지 객체를 넣기만 하면 되는거여서 예제는 말 그대로 참고용으로만 확인해주시면 될 것 같습니다.

[J-Yong99]

제가 제대로 이해했는지 확인부탁드립니다.
this.messageService.send(messageList); 처럼 메세지에 여러 객체들을 묶어서 한번에 발송하면 된다는 뜻인가요??

마지막으로 하나 더 여쭤보고싶은 부분이 있는데,
저희가 solapi로 버전업이 안되는 상황이어서 "https://api.coolsms.co.kr" 해당 url로 요청을 보내고 있습니다.
제가 찾아보려했지만 api.coolsms.co.kr로 되어있는 문서를 찾지 못했는데,
("/send-many-ata")로 요청을 보내려면 solapi api url을 사용해야 할까요??
또한 있다면 해당 api로 여러 variables를 담아 요청하는 예제를 확인해 볼 방법이 있을까요??

기존에는 다음과 같이 단일건을 발송했습니다.
`public ResultModel sendAlimTalkStandard(AlimTalkParamforStandard requestParam) {

EbmpLang ebmpLang = requestParam.getEbmpLang();
String solCd = requestParam.getSolCd();
String toNumber = requestParam.getToNumber();
String tmpltSn = requestParam.getTmpltSn();
String fromNumber = requestParam.getFromNumber();
HashMap<String, String> variables = requestParam.getVariables();
KakaoOption kakaoOption = new KakaoOption();

EpcSolMst solutionMaster = solutionMasterRepository.findTop1BySolCdAndUseYnAndAlimTalkApiKeyNotNull(
  solCd, "Y");
EpcTalkTmplt epcTalkTmplt = epcTalkTmpltRepository.findBySolCdAndTmpltSnAndUseYn(solCd, tmpltSn,
  "Y");
String tmpltId = epcTalkTmplt.getTmpltId();
String pfId = epcTalkTmplt.getPfId();

if (StringUtil.isEmpty(fromNumber)) {
  fromNumber = solutionMaster.getAlimTalkDefaultFromNumber();
}

if (epcTalkTmplt == null) {
  return ResultStatusManager.failResultModel(ebmpLang,
    4431); //카카오 알림톡 템플릿이 등록되어 있지 않습니다. 관리자에게 문의해주시기 바랍니다.
}
if (StringUtil.isNotEmpty(tmpltId)) {
  kakaoOption.setTemplateId(tmpltId);
}
if (StringUtil.isNotEmpty(pfId)) {
  kakaoOption.setPfId(pfId);
}
String tmpltDesc = epcTalkTmplt.getTmpltDesc();

String messageText = EtnersAlimTalkUtil.messageAssemble(tmpltDesc, "");

DefaultMessageService coolSms = EtnersAlimTalkInitializer.getCoolSmsMessageModule(
  solutionMaster);

Message message = new Message();

message.setTo(StringUtil.extractOnlyNumberToString(toNumber));
message.setFrom(StringUtil.extractOnlyNumberToString(fromNumber));
message.setType(MessageType.ATA);
message.setText(messageText);

List<EpcTalkTmpltButton> epcTalkTmpltButtonList = epcTalkTmpltButtonRepository.findBySolCdAndTmpltSnAndUseYn(
  solCd, tmpltSn, "Y");

if (nonNull(epcTalkTmpltButtonList)) {
  ArrayList<KakaoButton> kakaoButtons = new ArrayList<>();
  for (EpcTalkTmpltButton epcTalkTmpltButton : epcTalkTmpltButtonList) {

    String buttonName = epcTalkTmpltButton.getButtonNm();
    KakaoButtonType kakaoButtonType = epcTalkTmpltButton.getKakaoButtonType();
    String linkMo = epcTalkTmpltButton.getButtonLinkm();
    String linkPc = epcTalkTmpltButton.getButtonLinkw();
    String linkAnd = epcTalkTmpltButton.getButtonLinkaos();
    String linkIos = epcTalkTmpltButton.getButtonLinkios();

    KakaoButton kakaoLinkButton = new KakaoButton(buttonName, kakaoButtonType, linkMo,
      linkPc, linkAnd, linkIos);
    kakaoButtons.add(kakaoLinkButton);
  }
  kakaoOption.setButtons(kakaoButtons);
}
kakaoOption.setVariables(variables);

message.setKakaoOptions(kakaoOption);
Object response = coolSms.sendOne(new SingleMessageSendingRequest(message));

ResultModel<Object> resultModel = ResultStatusManager.successResultModel(ebmpLang);
resultModel.setResultData(response);

return resultModel;

}`

[J-Yong99]

package net.nurigo.sdk.message.service SDK입니다

[Palbahngmiyine]

답변이 늦어져 송구합니다, 회원님께서 말씀하신 사항을 순차적으로 정리하여 답변드리겠습니다.

1. this.messageService.send(messageList); 처럼 메세지에 여러 객체들을 묶어서 한번에 발송하면 된다는 뜻인가요??
   : 네 맞습니다 회원님, 메시지 객체에 카카오 옵션을 새로 할당하여 각기 다른 메시지 객체들을 통해 ArrayList로 묶어서 발송하시면 여러건을 발송하실 수 있습니다.

2. 저희가 solapi로 버전업이 안되는 상황이어서 "https://api.coolsms.co.kr/" 해당 url로 요청을 보내고 있습니다.
   제가 찾아보려했지만 api.coolsms.co.kr로 되어있는 문서를 찾지 못했는데,
   ("/send-many-ata")로 요청을 보내려면 solapi api url을 사용해야 할까요??
   또한 있다면 해당 api로 여러 variables를 담아 요청하는 예제를 확인해 볼 방법이 있을까요??

: 문의하신 사항은 coolsms, solapi API URL 상관없이 동일하게 이용하실 수 있습니다.
Java SDK 4.X 버전의 경우 기존처럼 coolsms API 도메인을 등록하시면 되시며,

예시는 앞서 말씀드린것과 동일하여 안내드린 방안대로 진행 해 주시면 될 것 같습니다.

참고 부탁드립니다.