5. 정보확인
5.1. GetMessages - 알림톡/친구톡 전송내역 확인
- 팝빌에서 반환받은 접수번호를 통해 알림톡/친구톡 전송상태 및 결과를 확인합니다.
KakaoSentInfo getMessages(String CorpNum, String receiptNum, String UserID) throws PopbillException
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리) | |
receiptNum | String | 18 | O | 카카오톡 전송 접수시 팝빌로부터 반환받은 접수번호 | |
UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
5.2. GetMessagesRN - 알림톡/친구톡 전송내역 확인 (요청번호 할당)
- 파트너가 할당한 전송 요청번호를 통해 알림톡/친구톡 전송상태 및 결과를 확인합니다.
KakaoSentInfo getMessagesRN(String CorpNum, String requestNum, String UserID) throws PopbillException
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리) | |
requestNum | String | 36 | O | 카카오톡 전송 접수시 파트너가 할당한 전송 요청번호 | |
UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
5.3. Search - 전송내역 목록 조회
-
검색조건에 해당하는 카카오톡 전송내역을 조회합니다. (조회기간 단위 : 최대 2개월)
※ 카카오톡 접수일시로부터 6개월 이내 접수건만 조회할 수 있습니다.
KakaoSearchResult search(String CorpNum, String SDate, String EDate, String[] State, String[] Item, String ReserveYN, Boolean SenderYN, int Page, int PerPage, String Order, String UserID, String QString) throws PopbillException
- 페이지 관련 항목(Page, PerPage, Order)을 활용하여 카카오톡 전송내역 목록을 구현할 수 있습니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리) | |
SDate | String | 8 | O | 조회 기간의 시작일자 (형식 : yyyyMMdd) | |
EDate | String | 8 | O | 조회 기간의 종료일자 (형식 : yyyyMMdd) | |
State | String[ ] | - |
전송상태 : "0" / "1" / "2" / "3" / "4" / "5" 중 선택 (다중 선택 가능)
└ 0 = 전송대기, 1 = 전송중, 2 = 전송성공, 3 = 대체문자 전송, 4 = 전송실패, 5 = 전송취소 ※ 미입력시 전체조회 |
||
Item | String[ ] | - |
검색대상 : "ATS" / "FTS" / "FMS" 중 선택 (다중 선택 가능)
└ ATS = 알림톡, FTS = 친구톡(텍스트), FMS = 친구톡(이미지) ※ 미입력시 전체조회 |
||
ReserveYN | String | 1 | - |
전송유형별 조회 : null / "0" / "1" 중 택 1
└ null = 전체, 0 = 즉시전송건, 1 = 예약전송건 ※ 미입력시 전체조회 |
|
SenderYN | Boolean | - | - |
사용자권한별 조회 : true / false 중 택 1
└ true = 해당 담당자 계정으로 접수한 카카오톡만 조회 (개인권한), false = 접수한 카카오톡 전체 조회 (관리자권한) ※ 미입력시 기본값 false 처리 |
|
Page | int | - | O | 목록 페이지번호 | |
PerPage | int | - | O | 페이지당 표시할 목록 개수 (최대 1,000) | |
Order | String | 1 | - |
알림톡/친구톡 접수일시를 기준으로 하는 목록 정렬 방향 : "D" / "A" 중 택 1
└ "D" : 내림차순 └ "A" : 오름차순 ※ 미입력시 기본값 "D" 처리 |
|
UserID | String | 50 | - | 팝빌회원 아이디 | |
QString | String | 70 | - |
조회하고자 하는 수신자명
※ 미입력시 전체조회 |
Return
Throws
5.4. GetSentListURL - 카카오톡 전송내역 팝업 URL
- 카카오톡 전송내역을 확인하는 페이지의 팝업 URL을 반환합니다.
- 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
String getSentListURL(String CorpNum, String UserID) throws PopbillException
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리) | |
UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL