튜토리얼

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

1. POPBiLL SDK 추가

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

② 압축해제한 SDK 예제코드에서 linkhub.pbl, popbill.pbl 파일을 기존 프로젝트 폴더로 복사하고 Library List에 추가합니다.

2. POPBiLL SDK 설정

Window 폼의 Declare Instance Variables 탭에 인증정보와 클래스를 선언하고 open() 함수에 클래스 초기화 코드를 추가합니다.

Declare Instance Variables 탭

// 링크아이디, 연동신청시 발급받은 값으로 변경
string in_linkid = "TESTER"

// 비밀키, 연동신청시 발급받은 값으로 변경
string in_secretkey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

kakaoservice in_kakaoservice

Window Form Open() 함수

in_kakaoservice = create kakaoservice

// 링크아이디
in_kakaoservice.linkid = in_linkid

// 비밀키
in_kakaoservice.secretkey = in_secretkey

// 연동환경 설정값, true-개발용, false-상업용
in_kakaoservice.setIstest(true)

// 인증토큰 IP제한기능 사용여부, true-사용, false-미사용, 기본값(true)
in_kakaoservice.setIPRestrictOnOff(true)

// 로컬시스템 시간 사용여부 true-사용, false-미사용, 기본값(false)
in_kakaoservice.setUseLocalTimeYN(false)

3. SendATS 기능 구현

Form에 버튼을 생성하고 버튼의 Click Event 코드에 카카오톡 알림톡 전송 (SendATS) 기능을 추가합니다.

string l_receiptNum, templatecode, sender, content, altcontent, altsendtype,  receiver, receivername, requestnum, corpnum, userid, reservedt

// 팝빌회원 사업자번호
corpnum = "1234567890"

// 팝빌회원 아이디
userid = "testkorea"

//알림톡 템플릿 코드
//승인된 알림톡 템플릿 코드는 ListATStemplate API, GetATSTemplateMgtURL API, 혹은 팝빌사이트에서 확인이 가능합니다.
templatecode = "019020000163"

// 발신번호 (팝빌에 등록된 발신번호만 이용가능)
sender = "07043042992"

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

//대체문자 내용 (최대 2000byte)
altContent = "알림톡 대체 문자"

//대체문자 유형 [공백-미전송, C-알림톡 내용, A-대체문자 내용]
altsendtype = "A"

//수신번호
receiver = "010111222"

//수신자 이름
receivername = "partner"

// 전송요청번호, 파트너가 전송요청에 대한 관리번호를 직접 할당하여 관리하는 경우 기재
// 최대 36자리, 영문, 숫자, 언더바('_'), 하이픈('-')을 조합하여 사업자별로 중복되지 않도록 구성
requestnum = "";

// 알림톡 버튼정보를 템플릿 신청시 기재한 버튼정보와 동일하게 전송하는 경우
// l_kakaobutton 배열을 선언만 하고 함수호출.
kakaobutton l_kakaobutton[]

/*
// 알림톡 버튼 URL에 #{템플릿변수}를 기재한경우 템플릿변수 영역을 변경하여 버튼정보 구성
kakaobutton l_kakaobutton[]

// 버튼명
l_kakaobutton[1].n = "템플릿 안내"

// 버튼유형 DS-배송조회, WL-웹링크, AL-앱링크, MD-메시지전달, BK-봇키워드
l_kakaobutton[1].t = "WL"

// 앱링크-Android, 웹링크-Mobile
l_kakaobutton[1].u1 = "https://www.linkhubcorp.com"

// 앱링크-IOS, 웹링크-PC URL
l_kakaobutton[1].u2 = "http://www.popbill.co.kr"
*/

// 예약전송일시
reservedt = ""

try
  l_receiptNum = in_kakaoservice.sendats(corpnum, templatecode, sender, content, altcontent, &
  altsendtype, reservedt, receiver, receivername, requestnum, l_kakaobutton, userid)

  messagebox("알림톡 단건 전송","접수번호 : " + l_receiptNum)

  sle_receiptnum.text = l_receiptNum

catch(popbillexception pe)

  messagebox("알림톡 단건 전송", "응답코드 : " + String(pe.getcode()) +  "~n응답메시지 :" + pe.getmessage())

end try

4. 결과 확인

함수 호출이 정상적으로 처리된 경우 Response가 "성공"으로 반환되며, 실패일 경우 PopbillException으로 오류코드("-"로 시작하는 8자리 숫자값)와 오류메시지가 반환됩니다. [오류코드] 바로가기