알리고 카카오 알림톡 API 연동하기 (with Node js)

👨🏼‍💻 알리고 카카오 알림톡 API 연동하기 (with Node js)

⌛ Problem

특정 이벤트가 일어났을 때 특정 유저에게 카카오 알림톡을 어떻게 보낼 수 있을 까요? 😕
알리고 서비스를 활용해서 Node js로 이를 구현해 보겠습니다.

📜 Solution

알리고

카카오 알림톡을 보내기 위해서는 위와 같은 사이트에 가입을 해야 합니다.

알림톡을 보내는 기능은 건당 6원 정도가 발생하는 유료 서비스입니다.

 

 

 

알림톡을 보내기 위해서는 카카오 채널이 등록되어 있어야 합니다.

 

 

 

또한 알림톡을 보내기 위해서는 템플릿을 미리 생성하여야 합니다.

템플릿은 모두 카카오에서 검수하여 승인 여부를 판별하게 됩니다.

 

 

 

위 사진과 같이 검수를 통해 템플릿이 승인 완료가 된다면,

이제 카카오 알림톡 서비스를 이용할 수 있습니다.

 

 

 

사이트에서 API Key와 발송할 서버의 IP를 등록 해 줍시다.

 

 

 

이제 API 호출을 위한 API 토큰을 발급받을 수 있습니다.

body값으로 apikey와 사용자 아이디를 입력하면 API 토큰을 발급받을 수 있습니다.
(참고로 저는 테스트를 하기 위해 제 PC에서 토큰을 발급받았지만 실제 서비스에서 

활용하기 위해서는 서버 PC에서 토큰을 발급받아야 합니다.)

 

 

 

Postman을 활용하여 토큰을 발급받았습니다.

 

 

 

aligoapi

위 모듈을 활용하여 좀 더 쉽게 알림 톡 기능을 활용할 수 있습니다.

해당 모듈을 활용하여 알림톡 기능을 구현해보겠습니다.

 

npm i aligoapi

위 명령으로 모듈을 설치해 줍시다.

 

 

let AuthData = {
  apikey: '<apikey>',
  // 이곳에 발급받으신 api key를 입력하세요
  userid: '<userid>',
  // 이곳에 userid를 입력하세요
  // token: ''
  // 이곳에 token api로 발급받은 토큰을 입력하세요
}
// token을 제외한 인증용 데이터는 모든 API 호출시 필수값입니다.
// token은 토큰생성을 제외한 모든 API 호출시 필수값입니다.

const alimtalkSend = (req, res) => {
 req.body = {
  senderkey: 발신프로필 키
  tpl_code: 템플릿 코드
  sender: 발신자 연락처
  receiver_1: 수신자 연락처
  subject_1: 알림톡 제목
  message_1: 알림톡 내용
}
  
  // senddate: 예약일 // YYYYMMDDHHMMSS
  // recvname: 수신자 이름
  // button: 버튼 정보 // JSON string
  // failover: 실패시 대체문자 전송기능 // Y or N
  // fsubject: 실패시 대체문자 제목
  // fmessage: 실패시 대체문자 내용
  // }
  // req.body 요청값 예시입니다.
  // _로 넘버링된 최대 500개의 receiver, subject, message, button, fsubject, fmessage 값을 보내실 수 있습니다
  // failover값이 Y일때 fsubject와 fmessage값은 필수입니다.

  aligoapi.alimtalkSend(req, AuthData)
    .then((r) => {
      res.send(r)
    })
    .catch((e) => {
      res.send(e)
    })
}

위와 같이 코드를 작성해 줍니다.

이때 알림톡 내용은 템플릿의 내용과 일치해야 합니다.

 

 

템플릿의 변수 부분들을 ex : #{월일}, #{결제금액}....

원하는 값으로 바꾸어 줍시다.

 

 

특정 API 실행 시 위 코드가 실행되도록 한다면

receiver에 등록된 번호로 알림 톡이 자동 발송됩니다.

 

예약 완료 시 예약 알림 톡을 보내거나

 

배송 준비 완료 시 출발 알림 톡을 보내는 등 

API를 설계할 때 활용할 수 있겠네요