본문으로 건너뛰기

시작하기

2008년을 시작으로 14년간의 서비스 개발 및 운영 경험을 담은 메시지 연동 방법에 대한 가이드 문서입니다.

개발 환경에 맞는 SDK 또는 샘플 프로젝트 선택​

개발 연동 시 자주묻는 질문​

메시지 그룹과 메시지(메시지 ID)는 무엇인가요?​

COOLSMS에서의 메시지 그룹은 발송이 시도될 때에 대한 묶음 단위입니다.
한 개 이상의 발송 요청이 접수될 경우 그룹이 먼저 생성되며, 생성된 그룹 내에 한 개 이상의 메시지(여기서 메시지는 SMS, LMS, 알림톡 등 모든 발송 요청 건을 포함합니다)가 생성 됩니다.
아래 이미지를 통해서도 관련한 예시를 확인해보실 수 있습니다!

그룹/메시지 생성 예시​

그룹 생성 순서도

pfId와 templateId(알림톡)은 무엇인가요?​

pfId와 templateId는 각각 COOLSMS 내부에서 식별을 위한 카카오 비즈니스 채널 고유 ID와 카카오 알림톡 템플릿 고유 ID입니다.
pfId, templateId는 알림톡 및 친구톡(친구톡은 pfId만 사용) 발송을 위해 사용됩니다.

COOLSMS에서는 예약 발송을 개발 연동상에서 지원하고 있나요?​

COOLSMS에서는 API 상에서 예약발송을 지원하고 있으며, SDK 및 샘플 프로젝트등을 통해서 예약발송 예제를 확인해보실 수 있습니다.

알림톡 개발 연동 시 알림톡 변수값에 탭, 줄내림을 입력해도 될까요?​

알림톡 발송 시 변수에 탭, 개행문자를 넣을 경우 수신받는 쪽에서도 잘 표현되는 것으로 확인되고 있습니다.
또한 친구톡의 경우에도 탭, 개행문자 적용이 정상적으로 되는 것으로 확인됩니다. (탭은 스페이스와 유사하게 표현됨)
대부분의 개발 언어에서는 탭, 줄내림을 아래와 같이 입력하시면 됩니다!

코드로 보는 줄내림 예시​

Node.js
const { CoolsmsMessageService } = require('coolsms-node-sdk');
const messageService = new CoolsmsMessageService("API 키 입력", "API 시크릿 키 입력");

messageService.send({
  "to": "수신번호",
  "from": "계정에서 등록한 발신번호 입력",
  "kakaoOptions": {
    "pfId": "연동한 비즈니스 채널의 pfId",
    "templateId": "등록한 알림톡 템플릿의 ID",
    "variables": {
      // 여기서의 변수명1은 실제 개발연동하실 때 작성하신 템플릿 내의 치환문구랑 동일하게 넣어주셔야 합니다.
      // 탭은 \t, 줄바꿈(개행)은 \n을 입력해주시면 됩니다!
      "#{변수명1}": "줄바꿈 테스트\n줄바꿈 완료",
      "#{변수명2}": "탭 테스트\t탭 완료",
    }
  }
});