5. 정보확인

5.1. GetMessages - 알림톡/친구톡 전송내역 확인

팝빌에서 반환받은 접수번호를 통해 알림톡/친구톡 전송상태 및 결과를 확인합니다.

KakaoSentInfo getMessages(String CorpNum, String ReceiptNum, String UserID) throws PopbillException

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
ReceiptNum	String	18	Y	카카오톡 전송 접수시 팝빌로부터 반환받은 접수번호
UserID	String	50	N	팝빌회원 아이디

Return

KakaoSentInfo

Throws

PopbillException

5.2. GetMessagesRN - 알림톡/친구톡 전송내역 확인 (요청번호 할당)

파트너가 할당한 요청번호를 통해 알림톡/친구톡 전송상태 및 결과를 확인합니다.

KakaoSentInfo getMessagesRN(String CorpNum, String RequestNum, String UserID) throws PopbillException

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
RequestNum	String	36	Y	카카오톡 전송 접수시 파트너가 할당한 요청번호
UserID	String	50	N	팝빌회원 아이디

Return

KakaoSentInfo

Throws

PopbillException

5.3. Search - 전송내역 목록 조회

검색조건에 해당하는 카카오톡 전송내역을 조회합니다. (조회기간 단위 : 최대 2개월)
※ 카카오톡 접수일시로부터 6개월 이내 접수건만 조회할 수 있습니다.

KakaoSearchResult search(String CorpNum, String SDate, String EDate, String[] State, String[] Item, String ReserveYN, Boolean SenderYN, Integer Page, Integer PerPage, String Order, String UserID, String QString) throws PopbillException

페이지 관련 항목(Page, PerPage, Order)을 활용하여 카카오톡 전송내역 목록을 구현할 수 있습니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
SDate	String	8	Y	조회 기간의 시작일자 형식 : yyyyMMdd
EDate	String	8	Y	조회 기간의 종료일자 형식 : yyyyMMdd
State	String[ ]		N	전송상태 (다중 선택 가능) 0전송대기 1전송중 2전송성공 3대체문자 전송 4전송실패 5전송취소 기본값 : 전체조회
Item	String[ ]		N	검색대상 (다중 선택 가능) ATS알림톡 FTS친구톡(텍스트) FMS친구톡(이미지) 기본값 : 전체조회
ReserveYN	String	1	N	전송유형별 조회 (택 1) 0즉시전송건 1예약전송건 기본값 : 전체조회
SenderYN	Boolean	-	N	사용자권한별 조회 true해당 담당자 계정으로 접수한 카카오톡만 조회 (개인권한) false접수한 카카오톡 전체 조회 (관리자권한) : 기본값
Page	Integer	-	N	목록 페이지번호 기본값 : 1
PerPage	Integer	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
Order	String	1	N	알림톡/친구톡 접수일시를 기준으로 하는 목록 정렬 방향 D내림차순 : 기본값 A오름차순
UserID	String	50	N	팝빌회원 아이디
QString	String	70	N	조회 검색어(수신자명) 기본값 : 전체조회

Return

KakaoSearchResult

Throws

PopbillException

5.4. GetSentListURL - 카카오톡 전송내역 팝업 URL

카카오톡 전송내역을 확인하는 페이지의 팝업 URL을 반환합니다.
반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

String getSentListURL(String CorpNum, String UserID) throws PopbillException

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
	UserID	String	50	N	팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException