POPBill Developers
가이드

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

API Reference

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

SDK

다수 개발자에게 검증받은
SDK Example을 제공합니다.

추가 개발언어는 신청주시면
검토 후 지원합니다.
Webhook(웹훅)

팝빌에서 발생한 이벤트 정보를
고객사 서버로 즉시 전송합니다.

가이드
카카오톡
ASP
가이드 카카오톡 ASP 튜토리얼

튜토리얼

ASP 개발환경에서 팝빌 SDK를 추가하여 카카오톡 알림톡 전송 (SendATS) 함수를 구현하는 예시입니다.

1. POPBiLL SDK 추가 및 설정

① 팝빌 연동자료실에서 ASP SDK 예제코드 다운로드 후 압축을 해제합니다.

② 압축해제한 SDK 예제코드에 포함된 Popbill/ 폴더를 웹사이트 Root Directory 경로에 복사합니다.

③ 카카오톡 서비스 연동환경 설정을 위해 프로젝트 Root Directory에 common.asp 파일을 생성하고 아래의 코드를 참고하여 API Key 를 설정합니다.

<!--#include virtual="/Popbill/Popbill.asp"-->
<!--#include virtual="/Popbill/KakaoService.asp"-->

<%
  ' 링크아이디
  LinkID = "LINKID"

  ' 비밀키
  SecretKey = "SwWxqU+0TExEXy/9TVjKPExI2VTUMMSLZtJf3Ed8q3I="

  ' 카카오톡 서비스 객체 선언
  set m_KakaoService = new KakaoService

  ' 카카오톡 서비스 객체 초기화
  m_KakaoService.Initialize LinkID, SecretKey

  ' 연동환경 설정, True-테스트, False-운영(Production), (기본값:False)
  m_KakaoService.IsTest = True

  ' 인증토큰 IP 검증 설정, True-사용, False-미사용, (기본값:True)
  m_KakaoService.IPRestrictOnOff = True

  ' 통신 IP 고정, True-사용, False-미사용, (기본값:False)
  m_KakaoService.UseStaticIP = False

  ' 로컬시스템 시간 사용여부, True-사용, False-미사용, (기본값:True)
  m_KakaoService.UseLocalTimeYN = True
%>

2. SendATS 기능 구현

프로젝트에 함수 호출을 처리하는 파일을 생성하고, 아래의 코드를 참조하여 코드를 추가합니다.

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=euc-kr" />
    <title>Popbill Kakaotalk Test.</title>
  </head>
<!--#include file="common.asp"-->
<%

  '팝빌 회원 사업자번호, "-" 제외
  testCorpNum = "1234567890"

  '팝빌 회원 아이디
  testUserID = "testkorea"

  '알림톡 템플릿 코드 - 템플릿 목록 조회 (ListATSTemplate API)의 반환항목 확인
  templateCode = "019020000163"

  '팝빌에 사전 등록된 발신번호
  senderNum = "	07043042992"

  '알림톡 내용, 최대 1000자
  content = "[ 팝빌 ]" & vbCrLf
  content = content + "신청하신 #{템플릿코드}에 대한 심사가 완료되어 승인 처리되었습니다." & vbCrLf
  content = content + "해당 템플릿으로 전송 가능합니다." & vbCrLf & vbCrLf
  content = content + "문의사항 있으시면 파트너센터로 편하게 연락주시기 바랍니다. " & vbCrLf & vbCrLf
  content = content + "팝빌 파트너센터 : 1600-8536" & vbCrLf
  content = content + "support@linkhubcorp.com"

  '대체문자 내용
  altContent = "대체문자 메시지 내용"

  '대체문자 전송유형 공백-미전송, A-대체문자내용 전송, C-알림톡내용 전송
  altSendType = "C"

  '예약전송시간 yyyyMMddHHmmss, reserveDT값이 없는 경우 즉시전송
  reserveDT = ""

  Set receiverList = CreateObject("Scripting.Dictionary")

  '메시지 전송정보
  Set rcvInfo = New KakaoReceiver

  '수신자번호
  rcvInfo.rcv = "01011222"

  '수신자명
  rcvInfo.rcvnm = " 수신자이름"

  receiverList.Add 0, rcvInfo

  '요청번호 (팝빌 회원별 비중복 번호 할당)
  '영문,숫자,'-','_' 조합, 최대 36자
  requestNum = ""

  ' 알림톡 버튼정보를 템플릿 신청시 기재한 버튼정보와 동일하게 전송하는 경우 btnList를 선언만 하고 함수호출.
  Set btnList = CreateObject("Scripting.Dictionary")

  '알림톡 버튼 URL에 #{템플릿변수}를 기재한경우 템플릿변수 영역을 변경하여 버튼정보 구성
  'Set btnInfo = New KakaoButton
  'btnInfo.n = "템플릿 안내"
  'btnInfo.t = "WL"
  'btnInfo.u1 = "https://www.popbil.com"
  'btnInfo.u2 = "http://www.llinkhubcorp.com"
  'btnList.Add 0, btnInfo

  '대체 문자 발송 시 전송될 제목
  '장문(LMS)일 때만 전송
  altSubject = "대체문자 제목"

  On Error Resume Next

  receiptNum = m_KakaoService.SendATS(testCorpNum, templateCode, senderNum,  _
  content, altContent, altSendType, reserveDT, receiverList, requestNum, testUserID, btnList, altSubject)

  If Err.Number <> 0 then
    code = Err.Number
    message =  Err.Description
    Err.Clears
  End If

  On Error GoTo 0
%>
  <body>
    <div id="content">
    <p class="heading1">Response</p>
    <br/>
    <fieldset class="fieldset1">
    <legend>알림톡 1건 전송</legend>
    <% If code = 0 Then %>
      <ul>
        <li>ReceiptNum(접수번호) : <%=receiptNum%> </li>
      </ul>
    <%	Else  %>
      <ul>
        <li>Response.code: <%=code%> </li>
        <li>Response.message: <%=message%> </li>
      </ul>
    <%	End If	%>
    </fieldset>
    </div>
  </body>
</html>

3. 결과 확인

함수 호출 반환 결과는 아래와 같습니다.
- 성공 : Response code 로 숫자 1 반환
- 실패 : PopbillException 으로 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]