# 전송결과

## 1. GetMessages - 카카오톡 전송내역 확인

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

```csharp
KakaoSentResult GetMessages(String corpNum, String receiptNum, String userID)
```

### 요청

**Parameters**

- corpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- receiptNum `type: String` `length: 18` `required: Y` `description: 팝빌에서 할당한 접수번호`
- userID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**KakaoSentResult**

- contentType `type: int?` `length: -` `description: 카카오톡 유형`
  - `1`: 알림톡
  - `4`: 알림톡 이미지
  - `5`: 알림톡 강조표기
  - `6`: 브랜드 메시지 텍스트
  - `7`: 브랜드 메시지 이미지
  - `8`: 브랜드 메시지 와이드
  - `9`: 브랜드 메시지 리스트
  - `10`: 브랜드 메시지 캐러셀
  - `12`: 브랜드 메시지 커머스
  - `13`: 브랜드 메시지 캐러셀 커머스
- templateCode `type: string` `length: 12` `description: 알림톡 템플릿 코드`
  - 알림톡 전송 시 사용한 코드값
- bmsTemplateCode `type: string` `length: 12` `description: 브랜드 메시지 템플릿 코드`
  - 브랜드 메시지 전송 시 사용한 코드값
- plusFriendID `type: string` `length: 30` `description: 검색용 아이디`
- targeting `type: string` `length: 1` `description: 전송대상`
  - `I`: 채널친구
  - `M`: 전체
  - `N`: 비채널 친구
  - 브랜드 메시지 전송 시 반환
- unsubscribeNo `type: string` `length: 20` `description: 080 무료수신거부 전화번호`
  - 브랜드 메시지 전송 시 반환
- sendNum `type: string` `length: 20` `description: 발신번호`
- altUnsubscribeNo `type: string` `length: 20` `description: 대체문자 080 무료수신거부 전화번호`
  - 브랜드 메시지 전송 시 반환
- altSubject `type: string` `length: 64` `description: 대체문자 제목`
  - 단위 : byte
- altContent `type: string` `length: 2,000` `description: 대체문자 내용`
  - 단위 : byte
- altSendType `type: string` `length: 1` `description: 대체문자 유형`
  - `null`: 미전송
  - `C`: 카카오톡과 동일 내용 전송
  - `A`: 대체문자 내용 전송
- reserveDT `type: string` `length: 14` `description: 예약일시`
  - 형식 : yyyyMMddHHmmss
- adsYN `type: string` `length: -` `description: 광고메시지 전송 여부`
  - `true`: 광고
  - `false`: 일반
- sendCnt `type: string` `length: -` `description: 전송건수`
- successCnt `type: string` `length: -` `description: 성공건수`
- failCnt `type: string` `length: -` `description: 실패건수`
- altCnt `type: string` `length: -` `description: 대체문자 건수`
- cancelCnt `type: string` `length: -` `description: 취소건수`
- btns `type: List<KakaoButton>` `length: 5` `description: 버튼 목록`
  - 최대 : 5개
  - n `type: string` `length: 14` `description: 버튼명`
  - t `type: string` `length: 2` `description: 버튼유형`
    - `WL`: 웹링크
    - `AL`: 앱링크
    - `TN`: 전화걸기
    - `DS`: 배송조회
    - `MD`: 메시지전달
    - `BK`: 봇키워드
    - `AC`: 채널추가
  - u1 `type: string` `length: 1,000` `description: 버튼링크`
    - {t} = "AL" 경우 iOS 앱링크 적용
    - {t} = "WL" 경우 Mobile 웹링크 적용
  - u2 `type: string` `length: 1,000` `description: 버튼링크`
    - {t} = "AL" 경우 Android 앱링크 적용
    - {t} = "WL" 경우 PC 웹링크 적용
  - tg `type: string` `length: 3` `description: 아웃 링크`
    - `out`: 디바이스 기본 브라우저
    - 기본값 : 카카오톡 인앱 브라우저 사용
  - telNum `type: string` `length: 14` `description: 전화걸기 번호`
- msgs `type: List<KakaoSentDetail>` `length: 1,000` `description: 전송결과 정보`
  - state `type: int?` `length: 1` `description: 상태코드`
    - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#state-code)
  - sendDT `type: string` `length: 14` `description: 전송일시`
    - 형식 : yyyyMMddHHmmss
  - result `type: int?` `length: 3` `description: 카카오 결과코드`
    - [\[참고\] 카카오 결과코드(카카오톡)](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#kakao-result-code)
    - {state} = 3 경우 카카오톡 전송결과 확인 가능
  - resultDT `type: string` `length: 14` `description: 전송결과 수신일시`
    - 형식 : yyyyMMddHHmmss
  - contentType `type: int?` `length: -` `description: 카카오톡 유형`
    - `1`: 알림톡
    - `4`: 알림톡 이미지
    - `5`: 알림톡 강조표기
    - `6`: 브랜드 메시지 텍스트
    - `7`: 브랜드 메시지 이미지
    - `8`: 브랜드 메시지 와이드
    - `9`: 브랜드 메시지 리스트
    - `10`: 브랜드 메시지 캐러셀
    - `12`: 브랜드 메시지 커머스
    - `13`: 브랜드 메시지 캐러셀 커머스
  - receiveNum `type: string` `length: 20` `description: 수신번호`
  - receiveName `type: string` `length: 70` `description: 수신자명`
  - emphasizeTitle `type: string` `length: 50` `description: 강조표기 타이틀`
    - 알림톡 강조표기형 전송 시 반환
  - adultYN `type: bool?` `length: -` `description: 성인용 메시지 여부`
    - 브랜드 메시지 전송 시 반환
  - header `type: string` `length: 20` `description: 제목`
    - 브랜드 메시지 전송 시 반환
  - content `type: string` `length: 1,300` `description: 카카오톡 내용`
  - addContent `type: string` `length: 34` `description: 부가메시지`
    - 브랜드 메시지 전송 시 반환
  - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - 브랜드 메시지 전송 시 반환
  - imageLink `type: string` `length: 500` `description: 이미지 링크 URL`
    - 브랜드 메시지 전송 시 반환
  - altSubject `type: string` `length: 64` `description: 대체문자 제목`
    - 단위 : byte
  - altContent `type: string` `length: 2,000` `description: 대체문자 내용`
    - 단위 : byte
  - altContentType `type: int?` `length: 1` `description: 대체문자 전송타입`
    - `4`: 단문
    - `6`: 장문
  - altSendDT `type: string` `length: 14` `description: 대체문자 전송일시`
    - 형식 : yyyyMMddHHmmss
  - altResult `type: int?` `length: 3` `description: 대체문자 통신사 결과코드`
    - [\[참고\] 통신사 결과코드(대체문자)](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#telecom-result-code)
  - altResultDT `type: string` `length: 14` `description: 대체문자 전송결과 수신일시`
    - 형식 : yyyyMMddHHmmss
  - reserveDT `type: string` `length: 14` `description: 예약일시`
    - 형식 : yyyyMMddHHmmss
  - receiptNum `type: string` `length: 18` `description: 접수번호`
  - requestNum `type: string` `length: 36` `description: 요청번호`
  - interOPRefKey `type: string` `length: 20` `description: 파트너 지정키`
    - 카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
  - item `type: List<KakaoItem>` `length: 4` `description: 아이템 목록`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 30` `description: 타이틀`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - commerce `type: KakaoCommerce` `length: -` `description: 커머스 정보`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 30` `description: 상품명`
    - regularPrice `type: int?` `length: -` `description: 정상가격`
      - 0 \~ 99,999,999
    - discountType `type: string` `length: 1` `description: 할인유형`
      - `R`: 할인율
      - `F`: 할인금액
    - discount `type: int?` `length: -` `description: 할인율/할인금액`
      - {discountType}="R" 경우 1 \~ 100\
        {discountType}="F" 경우 0 \~ 999,999
    - discountPrice `type: int?` `length: -` `description: 할인가격`
      - 0 \~ 99,999,999
      - 할인 적용 후 최종 가격
  - head `type: KakaoCarouselHead` `length: -` `description: 캐러셀 인트로`
    - 브랜드 메시지 전송 시 반환
    - header `type: string` `length: 20` `description: 제목`
    - content `type: string` `length: 50` `description: 내용`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - carousel `type: List<KakaoCarousel>` `length: 6` `description: 캐러셀 목록`
    - 브랜드 메시지 전송 시 반환
    - header `type: string` `length: 20` `description: 제목`
    - content `type: string` `length: 180` `description: 내용`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - imageLink `type: string` `length: 500` `description: 이미지 링크 URL`
      - 이미지를 클릭하면 연결되는 URL
    - addContent `type: string` `length: 34` `description: 부가메시지`
    - commerce `type: KakaoCommerce` `length: -` `description: 커머스 정보`
      - title `type: string` `length: 30` `description: 상품명`
      - regularPrice `type: int?` `length: -` `description: 정상가격`
        - 0 \~ 99,999,999
      - discountType `type: string` `length: 1` `description: 할인유형`
        - `R`: 할인율
        - `F`: 할인금액
      - discount `type: int?` `length: -` `description: 할인율/할인금액`
        - {discountType}="R" 경우 1 \~ 100\
          {discountType}="F" 경우 0 \~ 999,999
      - discountPrice `type: int?` `length: -` `description: 할인가격`
        - 0 \~ 99,999,999
        - 할인 적용 후 최종 가격
    - btns `type: List<KakaoButton>` `length: 2` `description: 버튼 목록`
      - n `type: string` `length: 8` `description: 버튼명`
      - t `type: string` `length: 2` `description: 버튼유형`
        - `WL`: 웹링크
        - `AL`: 앱링크
        - `MD`: 메시지전달
        - `BK`: 봇키워드
        - `AC`: 채널추가
      - u1 `type: string` `length: 1,000` `description: 버튼링크`
        - {t} = "AL" 경우 iOS 앱링크 적용
        - {t} = "WL" 경우 Mobile 웹링크 적용
      - u2 `type: string` `length: 1,000` `description: 버튼링크`
        - {t} = "AL" 경우 Android 앱링크 적용
        - {t} = "WL" 경우 PC 웹링크 적용
    - coupon `type: KakaoCoupon` `length: -` `description: 쿠폰`
      - title `type: string` `length: 15` `description: 쿠폰 제목`
        - `#{숫자}원 할인 쿠폰`: (숫자 : 1\~99,999,999)
        - `#{숫자}% 할인 쿠폰`: (숫자 : 1\~100)
        - `배송비 할인 쿠폰`
        - `#{7자 이내} 무료 쿠폰`
        - `#{7자 이내} UP 쿠폰`
      - description `type: string` `length: 12` `description: 쿠폰 설명`
        - 줄바꿈 사용 불가
      - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
      - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
      - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
      - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - tail `type: KakaoCarouselTail` `length: -` `description: 캐러셀 더보기`
    - 브랜드 메시지 전송 시 반환
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - btns `type: List<KakaoButton>` `length: 5` `description: 버튼 목록`
    - n `type: string` `length: 14` `description: 버튼명`
    - t `type: string` `length: 2` `description: 버튼유형`
      - `WL`: 웹링크
      - `AL`: 앱링크
      - `TN`: 전화걸기
      - `DS`: 배송조회
      - `MD`: 메시지전달
      - `BK`: 봇키워드
      - `AC`: 채널추가
    - u1 `type: string` `length: 1,000` `description: 버튼링크`
      - {t} = "AL" 경우 iOS 앱링크 적용
      - {t} = "WL" 경우 Mobile 웹링크 적용
    - u2 `type: string` `length: 1,000` `description: 버튼링크`
      - {t} = "AL" 경우 Android 앱링크 적용
      - {t} = "WL" 경우 PC 웹링크 적용
    - tg `type: string` `length: 3` `description: 아웃 링크`
      - `out`: 디바이스 기본 브라우저
      - 기본값 : 카카오톡 인앱 브라우저 사용
    - telNum `type: string` `length: 14` `description: 전화걸기 번호`
  - coupon `type: KakaoCoupon` `length: -` `description: 쿠폰`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 15` `description: 쿠폰 제목`
      - `#{숫자}원 할인 쿠폰`: (숫자 : 1\~99,999,999)
      - `#{숫자}% 할인 쿠폰`: (숫자 : 1\~100)
      - `배송비 할인 쿠폰`
      - `#{7자 이내} 무료 쿠폰`
      - `#{7자 이내} UP 쿠폰`
    - description `type: string` `length: 12` `description: 쿠폰 설명`
      - 줄바꿈 사용 불가
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - contentVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 내용 변수`
    - 브랜드 메시지 전송 시 반환
  - buttonVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 버튼 변수`
    - 브랜드 메시지 전송 시 반환
  - couponVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 쿠폰 변수`
    - 브랜드 메시지 전송 시 반환
  - commerceVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 커머스 변수`
    - 브랜드 메시지 전송 시 반환
  - carouselVariable `type: List<KakaoCarouselVariable>` `length: -` `description: 브랜드 메시지 캐러셀 변수`
    - 브랜드 메시지 전송 시 반환
    - contentVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 내용 변수`
    - buttonVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 버튼 변수`
    - couponVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 쿠폰 변수`
    - commerceVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 커머스 변수`

### 예외

**PopbillException**

- code `type: long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Message `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 2. GetMessagesRN - 카카오톡 전송내역 확인 (요청번호 할당)

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

```csharp
KakaoSentResult GetMessagesRN(String corpNum, String requestNum, String userID)
```

### 요청

**Parameters**

- corpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- requestNum `type: String` `length: 36` `required: Y` `description: 파트너가 할당한 요청번호`
- userID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**KakaoSentResult**

- contentType `type: int?` `length: -` `description: 카카오톡 유형`
  - `1`: 알림톡
  - `4`: 알림톡 이미지
  - `5`: 알림톡 강조표기
  - `6`: 브랜드 메시지 텍스트
  - `7`: 브랜드 메시지 이미지
  - `8`: 브랜드 메시지 와이드
  - `9`: 브랜드 메시지 리스트
  - `10`: 브랜드 메시지 캐러셀
  - `12`: 브랜드 메시지 커머스
  - `13`: 브랜드 메시지 캐러셀 커머스
- templateCode `type: string` `length: 12` `description: 알림톡 템플릿 코드`
  - 알림톡 전송 시 사용한 코드값
- bmsTemplateCode `type: string` `length: 12` `description: 브랜드 메시지 템플릿 코드`
  - 브랜드 메시지 전송 시 사용한 코드값
- plusFriendID `type: string` `length: 30` `description: 검색용 아이디`
- targeting `type: string` `length: 1` `description: 전송대상`
  - `I`: 채널친구
  - `M`: 전체
  - `N`: 비채널 친구
  - 브랜드 메시지 전송 시 반환
- unsubscribeNo `type: string` `length: 20` `description: 080 무료수신거부 전화번호`
  - 브랜드 메시지 전송 시 반환
- sendNum `type: string` `length: 20` `description: 발신번호`
- altUnsubscribeNo `type: string` `length: 20` `description: 대체문자 080 무료수신거부 전화번호`
  - 브랜드 메시지 전송 시 반환
- altSubject `type: string` `length: 64` `description: 대체문자 제목`
  - 단위 : byte
- altContent `type: string` `length: 2,000` `description: 대체문자 내용`
  - 단위 : byte
- altSendType `type: string` `length: 1` `description: 대체문자 유형`
  - `null`: 미전송
  - `C`: 카카오톡과 동일 내용 전송
  - `A`: 대체문자 내용 전송
- reserveDT `type: string` `length: 14` `description: 예약일시`
  - 형식 : yyyyMMddHHmmss
- adsYN `type: string` `length: -` `description: 광고메시지 전송 여부`
  - `true`: 광고
  - `false`: 일반
- sendCnt `type: string` `length: -` `description: 전송건수`
- successCnt `type: string` `length: -` `description: 성공건수`
- failCnt `type: string` `length: -` `description: 실패건수`
- altCnt `type: string` `length: -` `description: 대체문자 건수`
- cancelCnt `type: string` `length: -` `description: 취소건수`
- btns `type: List<KakaoButton>` `length: 5` `description: 버튼 목록`
  - 최대 : 5개
  - n `type: string` `length: 14` `description: 버튼명`
  - t `type: string` `length: 2` `description: 버튼유형`
    - `WL`: 웹링크
    - `AL`: 앱링크
    - `TN`: 전화걸기
    - `DS`: 배송조회
    - `MD`: 메시지전달
    - `BK`: 봇키워드
    - `AC`: 채널추가
  - u1 `type: string` `length: 1,000` `description: 버튼링크`
    - {t} = "AL" 경우 iOS 앱링크 적용
    - {t} = "WL" 경우 Mobile 웹링크 적용
  - u2 `type: string` `length: 1,000` `description: 버튼링크`
    - {t} = "AL" 경우 Android 앱링크 적용
    - {t} = "WL" 경우 PC 웹링크 적용
  - tg `type: string` `length: 3` `description: 아웃 링크`
    - `out`: 디바이스 기본 브라우저
    - 기본값 : 카카오톡 인앱 브라우저 사용
  - telNum `type: string` `length: 14` `description: 전화걸기 번호`
- msgs `type: List<KakaoSentDetail>` `length: 1,000` `description: 전송결과 정보`
  - state `type: int?` `length: 1` `description: 상태코드`
    - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#state-code)
  - sendDT `type: string` `length: 14` `description: 전송일시`
    - 형식 : yyyyMMddHHmmss
  - result `type: int?` `length: 3` `description: 카카오 결과코드`
    - [\[참고\] 카카오 결과코드(카카오톡)](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#kakao-result-code)
    - {state} = 3 경우 카카오톡 전송결과 확인 가능
  - resultDT `type: string` `length: 14` `description: 전송결과 수신일시`
    - 형식 : yyyyMMddHHmmss
  - contentType `type: int?` `length: -` `description: 카카오톡 유형`
    - `1`: 알림톡
    - `4`: 알림톡 이미지
    - `5`: 알림톡 강조표기
    - `6`: 브랜드 메시지 텍스트
    - `7`: 브랜드 메시지 이미지
    - `8`: 브랜드 메시지 와이드
    - `9`: 브랜드 메시지 리스트
    - `10`: 브랜드 메시지 캐러셀
    - `12`: 브랜드 메시지 커머스
    - `13`: 브랜드 메시지 캐러셀 커머스
  - receiveNum `type: string` `length: 20` `description: 수신번호`
  - receiveName `type: string` `length: 70` `description: 수신자명`
  - emphasizeTitle `type: string` `length: 50` `description: 강조표기 타이틀`
    - 알림톡 강조표기형 전송 시 반환
  - adultYN `type: bool?` `length: -` `description: 성인용 메시지 여부`
    - 브랜드 메시지 전송 시 반환
  - header `type: string` `length: 20` `description: 제목`
    - 브랜드 메시지 전송 시 반환
  - content `type: string` `length: 1,300` `description: 카카오톡 내용`
  - addContent `type: string` `length: 34` `description: 부가메시지`
    - 브랜드 메시지 전송 시 반환
  - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - 브랜드 메시지 전송 시 반환
  - imageLink `type: string` `length: 500` `description: 이미지 링크 URL`
    - 브랜드 메시지 전송 시 반환
  - altSubject `type: string` `length: 64` `description: 대체문자 제목`
    - 단위 : byte
  - altContent `type: string` `length: 2,000` `description: 대체문자 내용`
    - 단위 : byte
  - altContentType `type: int?` `length: 1` `description: 대체문자 전송타입`
    - `4`: 단문
    - `6`: 장문
  - altSendDT `type: string` `length: 14` `description: 대체문자 전송일시`
    - 형식 : yyyyMMddHHmmss
  - altResult `type: int?` `length: 3` `description: 대체문자 통신사 결과코드`
    - [\[참고\] 통신사 결과코드(대체문자)](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#telecom-result-code)
  - altResultDT `type: string` `length: 14` `description: 대체문자 전송결과 수신일시`
    - 형식 : yyyyMMddHHmmss
  - reserveDT `type: string` `length: 14` `description: 예약일시`
    - 형식 : yyyyMMddHHmmss
  - receiptNum `type: string` `length: 18` `description: 접수번호`
  - requestNum `type: string` `length: 36` `description: 요청번호`
  - interOPRefKey `type: string` `length: 20` `description: 파트너 지정키`
    - 카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
  - item `type: List<KakaoItem>` `length: 4` `description: 아이템 목록`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 30` `description: 타이틀`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - commerce `type: KakaoCommerce` `length: -` `description: 커머스 정보`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 30` `description: 상품명`
    - regularPrice `type: int?` `length: -` `description: 정상가격`
      - 0 \~ 99,999,999
    - discountType `type: string` `length: 1` `description: 할인유형`
      - `R`: 할인율
      - `F`: 할인금액
    - discount `type: int?` `length: -` `description: 할인율/할인금액`
      - {discountType}="R" 경우 1 \~ 100\
        {discountType}="F" 경우 0 \~ 999,999
    - discountPrice `type: int?` `length: -` `description: 할인가격`
      - 0 \~ 99,999,999
      - 할인 적용 후 최종 가격
  - head `type: KakaoCarouselHead` `length: -` `description: 캐러셀 인트로`
    - 브랜드 메시지 전송 시 반환
    - header `type: string` `length: 20` `description: 제목`
    - content `type: string` `length: 50` `description: 내용`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - carousel `type: List<KakaoCarousel>` `length: 6` `description: 캐러셀 목록`
    - 브랜드 메시지 전송 시 반환
    - header `type: string` `length: 20` `description: 제목`
    - content `type: string` `length: 180` `description: 내용`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - imageLink `type: string` `length: 500` `description: 이미지 링크 URL`
      - 이미지를 클릭하면 연결되는 URL
    - addContent `type: string` `length: 34` `description: 부가메시지`
    - commerce `type: KakaoCommerce` `length: -` `description: 커머스 정보`
      - title `type: string` `length: 30` `description: 상품명`
      - regularPrice `type: int?` `length: -` `description: 정상가격`
        - 0 \~ 99,999,999
      - discountType `type: string` `length: 1` `description: 할인유형`
        - `R`: 할인율
        - `F`: 할인금액
      - discount `type: int?` `length: -` `description: 할인율/할인금액`
        - {discountType}="R" 경우 1 \~ 100\
          {discountType}="F" 경우 0 \~ 999,999
      - discountPrice `type: int?` `length: -` `description: 할인가격`
        - 0 \~ 99,999,999
        - 할인 적용 후 최종 가격
    - btns `type: List<KakaoButton>` `length: 2` `description: 버튼 목록`
      - n `type: string` `length: 8` `description: 버튼명`
      - t `type: string` `length: 2` `description: 버튼유형`
        - `WL`: 웹링크
        - `AL`: 앱링크
        - `MD`: 메시지전달
        - `BK`: 봇키워드
        - `AC`: 채널추가
      - u1 `type: string` `length: 1,000` `description: 버튼링크`
        - {t} = "AL" 경우 iOS 앱링크 적용
        - {t} = "WL" 경우 Mobile 웹링크 적용
      - u2 `type: string` `length: 1,000` `description: 버튼링크`
        - {t} = "AL" 경우 Android 앱링크 적용
        - {t} = "WL" 경우 PC 웹링크 적용
    - coupon `type: KakaoCoupon` `length: -` `description: 쿠폰`
      - title `type: string` `length: 15` `description: 쿠폰 제목`
        - `#{숫자}원 할인 쿠폰`: (숫자 : 1\~99,999,999)
        - `#{숫자}% 할인 쿠폰`: (숫자 : 1\~100)
        - `배송비 할인 쿠폰`
        - `#{7자 이내} 무료 쿠폰`
        - `#{7자 이내} UP 쿠폰`
      - description `type: string` `length: 12` `description: 쿠폰 설명`
        - 줄바꿈 사용 불가
      - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
      - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
      - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
      - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - tail `type: KakaoCarouselTail` `length: -` `description: 캐러셀 더보기`
    - 브랜드 메시지 전송 시 반환
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - btns `type: List<KakaoButton>` `length: 5` `description: 버튼 목록`
    - n `type: string` `length: 14` `description: 버튼명`
    - t `type: string` `length: 2` `description: 버튼유형`
      - `WL`: 웹링크
      - `AL`: 앱링크
      - `TN`: 전화걸기
      - `DS`: 배송조회
      - `MD`: 메시지전달
      - `BK`: 봇키워드
      - `AC`: 채널추가
    - u1 `type: string` `length: 1,000` `description: 버튼링크`
      - {t} = "AL" 경우 iOS 앱링크 적용
      - {t} = "WL" 경우 Mobile 웹링크 적용
    - u2 `type: string` `length: 1,000` `description: 버튼링크`
      - {t} = "AL" 경우 Android 앱링크 적용
      - {t} = "WL" 경우 PC 웹링크 적용
    - tg `type: string` `length: 3` `description: 아웃 링크`
      - `out`: 디바이스 기본 브라우저
      - 기본값 : 카카오톡 인앱 브라우저 사용
    - telNum `type: string` `length: 14` `description: 전화걸기 번호`
  - coupon `type: KakaoCoupon` `length: -` `description: 쿠폰`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 15` `description: 쿠폰 제목`
      - `#{숫자}원 할인 쿠폰`: (숫자 : 1\~99,999,999)
      - `#{숫자}% 할인 쿠폰`: (숫자 : 1\~100)
      - `배송비 할인 쿠폰`
      - `#{7자 이내} 무료 쿠폰`
      - `#{7자 이내} UP 쿠폰`
    - description `type: string` `length: 12` `description: 쿠폰 설명`
      - 줄바꿈 사용 불가
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - contentVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 내용 변수`
    - 브랜드 메시지 전송 시 반환
  - buttonVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 버튼 변수`
    - 브랜드 메시지 전송 시 반환
  - couponVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 쿠폰 변수`
    - 브랜드 메시지 전송 시 반환
  - commerceVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 커머스 변수`
    - 브랜드 메시지 전송 시 반환
  - carouselVariable `type: List<KakaoCarouselVariable>` `length: -` `description: 브랜드 메시지 캐러셀 변수`
    - 브랜드 메시지 전송 시 반환
    - contentVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 내용 변수`
    - buttonVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 버튼 변수`
    - couponVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 쿠폰 변수`
    - commerceVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 커머스 변수`

### 예외

**PopbillException**

- code `type: long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Message `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 3. Search - 전송내역 목록 조회

검색조건에 해당하는 카카오톡 전송내역을 조회합니다. (조회기간 단위 : 최대 2개월)

- 카카오톡 접수일시로부터 12개월 이내 접수건만 조회할 수 있습니다.

```csharp
KakaoSearchResult Search(String corpNum, String sDate, String eDate, String[ ] state, String[ ] item, String reserveYN, Boolean? SenderYN, String order, int page, int perpage, String userID, String qString, String plusFriendID, string[] contentType)
```

> 매개변수 page, perpage, order를 이용하여 페이징 기능을 구현할 수 있습니다.

### 요청

**Parameters**

- corpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- sDate `type: String` `length: 8` `required: Y` `description: 검색 시작일자`
  - 형식 : yyyyMMdd
- eDate `type: String` `length: 8` `required: Y` `description: 검색 종료일자`
  - 형식 : yyyyMMdd
- state `type: String[ ]` `length: -` `required: N` `description: 전송상태 (다중 선택 가능)`
  - `0`: 전송대기
  - `1`: 전송중
  - `2`: 전송성공
  - `3`: 대체문자 전송성공
  - `4`: 전송실패
  - `5`: 예약취소
- item `type: String[ ]` `length: -` `required: N` `description: 검색대상 (다중 선택 가능)`
  - `ATS`: 알림톡
  - `BMS`: 브랜드 메시지
  - 기본값 : 전체조회
- reserveYN `type: String` `length: 1` `required: N` `description: 전송유형별 조회 (택 1)`
  - `0`: 즉시전송건
  - `1`: 예약전송건
  - 기본값 : 전체조회
- SenderYN `type: bool?` `length: -` `required: N` `description: 사용자권한별 조회`
  - `true`: 팝빌회원 아이디(userID)로 전송한 카카오톡만 조회
  - `false`: 전송한 카카오톡 전체 조회: 기본값
- order `type: String` `length: 1` `required: N` `description: 카카오톡 접수일시를 기준으로 하는 목록 정렬 방향`
  - `D`: 내림차순 : 기본값
  - `A`: 오름차순
- page `type: int` `length: -` `required: N` `description: 목록 페이지번호`
  - 기본값 : 1
- perpage `type: int` `length: -` `required: N` `description: 페이지당 표시할 목록 건수`
  - 최대 : 1,000건
  - 기본값 : 500건
- userID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`
- qString `type: String` `length: 70` `required: N` `description: 조회 검색어(수신자명, 수신번호)`
  - 기본값 : 전체조회
- plusFriendID `type: String` `length: 30` `required: N` `description: 검색용 아이디`
- contentType `type: String[ ]` `length: -` `required: N` `description: 카카오톡 유형 (다중 선택 가능)`
  - `1`: 알림톡
  - `4`: 알림톡 이미지
  - `5`: 알림톡 강조표기
  - `6`: 브랜드 메시지 텍스트
  - `7`: 브랜드 메시지 이미지
  - `8`: 브랜드 메시지 와이드
  - `9`: 브랜드 메시지 리스트
  - `10`: 브랜드 메시지 캐러셀
  - `12`: 브랜드 메시지 커머스
  - `13`: 브랜드 메시지 캐러셀 커머스
  - 기본값 : 전체조회

### 응답

**KakaoSearchResult**

- code `type: int` `length: -` `description: API 처리에 대한 응답코드`
  - `1`: 성공
- message `type: string` `length: -` `description: API 처리에 대한 응답메시지`
- total `type: int` `length: -` `description: 총 검색결과 건수`
- perPage `type: int` `length: -` `description: 페이지 당 목록 건수`
- pageNum `type: int` `length: -` `description: 페이지 번호`
- pageCount `type: int` `length: -` `description: 페이지 개수`
- list `type: List<KakaoSentDetail>` `length: 1,000` `description: 전송결과 정보`
  - state `type: int?` `length: 1` `description: 상태코드`
    - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#state-code)
  - sendDT `type: string` `length: 14` `description: 전송일시`
    - 형식 : yyyyMMddHHmmss
  - result `type: int?` `length: 3` `description: 카카오 결과코드`
    - [\[참고\] 카카오 결과코드(카카오톡)](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#kakao-result-code)
    - {state} = 3 경우 카카오톡 전송결과 확인 가능
  - resultDT `type: string` `length: 14` `description: 전송결과 수신일시`
    - 형식 : yyyyMMddHHmmss
  - contentType `type: int?` `length: -` `description: 카카오톡 유형`
    - `1`: 알림톡
    - `4`: 알림톡 이미지
    - `5`: 알림톡 강조표기
    - `6`: 브랜드 메시지 텍스트
    - `7`: 브랜드 메시지 이미지
    - `8`: 브랜드 메시지 와이드
    - `9`: 브랜드 메시지 리스트
    - `10`: 브랜드 메시지 캐러셀
    - `12`: 브랜드 메시지 커머스
    - `13`: 브랜드 메시지 캐러셀 커머스
  - receiveNum `type: string` `length: 20` `description: 수신번호`
  - receiveName `type: string` `length: 70` `description: 수신자명`
  - emphasizeTitle `type: string` `length: 50` `description: 강조표기 타이틀`
    - 알림톡 강조표기형 전송 시 반환
  - adultYN `type: bool?` `length: -` `description: 성인용 메시지 여부`
    - 브랜드 메시지 전송 시 반환
  - header `type: string` `length: 20` `description: 제목`
    - 브랜드 메시지 전송 시 반환
  - content `type: string` `length: 1,300` `description: 카카오톡 내용`
  - addContent `type: string` `length: 34` `description: 부가메시지`
    - 브랜드 메시지 전송 시 반환
  - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - 브랜드 메시지 전송 시 반환
  - imageLink `type: string` `length: 500` `description: 이미지 링크 URL`
    - 브랜드 메시지 전송 시 반환
  - altSubject `type: string` `length: 64` `description: 대체문자 제목`
    - 단위 : byte
  - altContent `type: string` `length: 2,000` `description: 대체문자 내용`
    - 단위 : byte
  - altContentType `type: int?` `length: 1` `description: 대체문자 전송타입`
    - `4`: 단문
    - `6`: 장문
  - altSendDT `type: string` `length: 14` `description: 대체문자 전송일시`
    - 형식 : yyyyMMddHHmmss
  - altResult `type: int?` `length: 3` `description: 대체문자 통신사 결과코드`
    - [\[참고\] 통신사 결과코드(대체문자)](https://developers.popbill.com/reference/kakaotalk/dotnet/response-code#telecom-result-code)
  - altResultDT `type: string` `length: 14` `description: 대체문자 전송결과 수신일시`
    - 형식 : yyyyMMddHHmmss
  - reserveDT `type: string` `length: 14` `description: 예약일시`
    - 형식 : yyyyMMddHHmmss
  - receiptNum `type: string` `length: 18` `description: 접수번호`
  - requestNum `type: string` `length: 36` `description: 요청번호`
  - interOPRefKey `type: string` `length: 20` `description: 파트너 지정키`
    - 카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
  - item `type: List<KakaoItem>` `length: 4` `description: 아이템 목록`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 30` `description: 타이틀`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - commerce `type: KakaoCommerce` `length: -` `description: 커머스 정보`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 30` `description: 상품명`
    - regularPrice `type: int?` `length: -` `description: 정상가격`
      - 0 \~ 99,999,999
    - discountType `type: string` `length: 1` `description: 할인유형`
      - `R`: 할인율
      - `F`: 할인금액
    - discount `type: int?` `length: -` `description: 할인율/할인금액`
      - {discountType}="R" 경우 1 \~ 100\
        {discountType}="F" 경우 0 \~ 999,999
    - discountPrice `type: int?` `length: -` `description: 할인가격`
      - 0 \~ 99,999,999
      - 할인 적용 후 최종 가격
  - head `type: KakaoCarouselHead` `length: -` `description: 캐러셀 인트로`
    - 브랜드 메시지 전송 시 반환
    - header `type: string` `length: 20` `description: 제목`
    - content `type: string` `length: 50` `description: 내용`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - carousel `type: List<KakaoCarousel>` `length: 6` `description: 캐러셀 목록`
    - 브랜드 메시지 전송 시 반환
    - header `type: string` `length: 20` `description: 제목`
    - content `type: string` `length: 180` `description: 내용`
    - imageUrl `type: string` `length: 500` `description: 이미지 URL`
    - imageLink `type: string` `length: 500` `description: 이미지 링크 URL`
      - 이미지를 클릭하면 연결되는 URL
    - addContent `type: string` `length: 34` `description: 부가메시지`
    - commerce `type: KakaoCommerce` `length: -` `description: 커머스 정보`
      - title `type: string` `length: 30` `description: 상품명`
      - regularPrice `type: int?` `length: -` `description: 정상가격`
        - 0 \~ 99,999,999
      - discountType `type: string` `length: 1` `description: 할인유형`
        - `R`: 할인율
        - `F`: 할인금액
      - discount `type: int?` `length: -` `description: 할인율/할인금액`
        - {discountType}="R" 경우 1 \~ 100\
          {discountType}="F" 경우 0 \~ 999,999
      - discountPrice `type: int?` `length: -` `description: 할인가격`
        - 0 \~ 99,999,999
        - 할인 적용 후 최종 가격
    - btns `type: List<KakaoButton>` `length: 2` `description: 버튼 목록`
      - n `type: string` `length: 8` `description: 버튼명`
      - t `type: string` `length: 2` `description: 버튼유형`
        - `WL`: 웹링크
        - `AL`: 앱링크
        - `MD`: 메시지전달
        - `BK`: 봇키워드
        - `AC`: 채널추가
      - u1 `type: string` `length: 1,000` `description: 버튼링크`
        - {t} = "AL" 경우 iOS 앱링크 적용
        - {t} = "WL" 경우 Mobile 웹링크 적용
      - u2 `type: string` `length: 1,000` `description: 버튼링크`
        - {t} = "AL" 경우 Android 앱링크 적용
        - {t} = "WL" 경우 PC 웹링크 적용
    - coupon `type: KakaoCoupon` `length: -` `description: 쿠폰`
      - title `type: string` `length: 15` `description: 쿠폰 제목`
        - `#{숫자}원 할인 쿠폰`: (숫자 : 1\~99,999,999)
        - `#{숫자}% 할인 쿠폰`: (숫자 : 1\~100)
        - `배송비 할인 쿠폰`
        - `#{7자 이내} 무료 쿠폰`
        - `#{7자 이내} UP 쿠폰`
      - description `type: string` `length: 12` `description: 쿠폰 설명`
        - 줄바꿈 사용 불가
      - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
      - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
      - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
      - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - tail `type: KakaoCarouselTail` `length: -` `description: 캐러셀 더보기`
    - 브랜드 메시지 전송 시 반환
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - btns `type: List<KakaoButton>` `length: 5` `description: 버튼 목록`
    - n `type: string` `length: 14` `description: 버튼명`
    - t `type: string` `length: 2` `description: 버튼유형`
      - `WL`: 웹링크
      - `AL`: 앱링크
      - `TN`: 전화걸기
      - `DS`: 배송조회
      - `MD`: 메시지전달
      - `BK`: 봇키워드
      - `AC`: 채널추가
    - u1 `type: string` `length: 1,000` `description: 버튼링크`
      - {t} = "AL" 경우 iOS 앱링크 적용
      - {t} = "WL" 경우 Mobile 웹링크 적용
    - u2 `type: string` `length: 1,000` `description: 버튼링크`
      - {t} = "AL" 경우 Android 앱링크 적용
      - {t} = "WL" 경우 PC 웹링크 적용
    - tg `type: string` `length: 3` `description: 아웃 링크`
      - `out`: 디바이스 기본 브라우저
      - 기본값 : 카카오톡 인앱 브라우저 사용
    - telNum `type: string` `length: 14` `description: 전화걸기 번호`
  - coupon `type: KakaoCoupon` `length: -` `description: 쿠폰`
    - 브랜드 메시지 전송 시 반환
    - title `type: string` `length: 15` `description: 쿠폰 제목`
      - `#{숫자}원 할인 쿠폰`: (숫자 : 1\~99,999,999)
      - `#{숫자}% 할인 쿠폰`: (숫자 : 1\~100)
      - `배송비 할인 쿠폰`
      - `#{7자 이내} 무료 쿠폰`
      - `#{7자 이내} UP 쿠폰`
    - description `type: string` `length: 12` `description: 쿠폰 설명`
      - 줄바꿈 사용 불가
    - linkMobile `type: string` `length: 1,000` `description: Mobile 웹링크`
    - linkPc `type: string` `length: 1,000` `description: PC 웹링크`
    - linkAndroid `type: string` `length: 1,000` `description: Android 앱링크`
    - linkIos `type: string` `length: 1,000` `description: iOS 앱링크`
  - contentVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 내용 변수`
    - 브랜드 메시지 전송 시 반환
  - buttonVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 버튼 변수`
    - 브랜드 메시지 전송 시 반환
  - couponVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 쿠폰 변수`
    - 브랜드 메시지 전송 시 반환
  - commerceVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 커머스 변수`
    - 브랜드 메시지 전송 시 반환
  - carouselVariable `type: List<KakaoCarouselVariable>` `length: -` `description: 브랜드 메시지 캐러셀 변수`
    - 브랜드 메시지 전송 시 반환
    - contentVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 내용 변수`
    - buttonVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 버튼 변수`
    - couponVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 쿠폰 변수`
    - commerceVariable `type: Dictionary<string, string>` `length: -` `description: 브랜드 메시지 캐러셀 커머스 변수`

### 예외

**PopbillException**

- code `type: long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Message `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

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

![카카오톡 전송내역 팝업 URL 미리보기](https://developers.popbill.com/images/reference/kakaotalk/getSentListURL.png)

**카카오톡 전송내역 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 1,455px (최소 1,000px) / height = 800px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

```csharp
String GetSentListURL(String corpNum, String userID)
```

### 요청

**Parameters**

- corpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- userID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

String - 요청에 대한 응답 URL

### 예외

**PopbillException**

- code `type: long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Message `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`