정보확인
1. GetMessages - 카카오톡 전송내역 확인
- 팝빌에서 반환받은 접수번호를 통해 알림톡 전송상태 및 결과를 확인합니다.
KakaoSentResult GetMessages(string CorpNum, string receiptNum, string UserID = null)요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| receiptNum | string | 18 | Y | 팝빌에서 할당한 접수번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
2. GetMessagesRN - 카카오톡 전송내역 확인 (요청번호 할당)
- 파트너가 할당한 요청번호를 통해 알림톡 전송상태 및 결과를 확인합니다.
KakaoSentResult GetMessagesRN(string CorpNum, string requestNum, string UserID = null)요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| requestNum | string | 36 | Y | 파트너가 할당한 요청번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
3. Search - 전송내역 목록 조회
검색조건에 해당하는 카카오톡 전송내역을 조회합니다. (조회기간 단위 : 최대 2개월)
- 카카오톡 접수일시로부터 6개월 이내 접수건만 조회할 수 있습니다.
KakaoSearchResult Search(string CorpNum, string SDate, string EDate, string[ ] State = null, string[ ] Item = null, string ReserveYN = null, bool? SenderYN = false, int? Page = null, int? PerPage = null, string Order = null, string Qstring = null, string PlusFriendID = null, string UserID = null)- 매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| SDate | string | 8 | Y |
검색 시작일자
형식 : yyyyMMdd
|
|
| EDate | string | 8 | Y |
검색 종료일자
형식 : yyyyMMdd
|
|
| State | string[ ] | Y |
전송상태 (다중 선택 가능)
|
||
| Item | string[ ] | N |
검색대상
ATS알림톡
미입력 : 전체조회
|
||
| ReserveYN | string | 1 | N |
전송유형별 조회 (택 1)
0즉시전송건
1예약전송건
미입력 : 전체조회
|
|
| SenderYN | bool? | - | N |
사용자권한별 조회
true해당 담당자 계정으로 접수한 카카오톡만 조회 (개인권한)
false접수한 카카오톡 전체 조회 (관리자권한) : 기본값
|
|
| Page | int? | - | N |
목록 페이지번호
기본값 : 1
|
|
| PerPage | int? | - | N |
페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
|
|
| Order | string | 1 | N |
카카오톡 접수일시를 기준으로 하는 목록 정렬 방향
D내림차순 : 기본값
A오름차순
|
|
| QString | string | 70 | N |
조회 검색어(수신자명, 수신번호)
미입력 : 전체조회
|
|
| PlusFriendID | string | 30 | N | 검색용 아이디 | |
| UserID | string | 50 | N | 팝빌회원 아이디 | |
응답
예외
4. GetSentListURL - 카카오톡 전송내역 팝업 URL
- 카카오톡 전송내역 팝업 URL을 반환합니다.
- 권장 사이즈 : width = 1,350px (최소 1,000px) / height = 800px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
string GetSentListURL(string CorpNum, string UserID)요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 요청에 대한 응답 URL