전송결과

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/KakaoTalk/{receiptNum} Copied

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

Request

요청 헤더

순번	변수명	필수	설명
1	Authorization	Y	인증 토큰 → [참고] 인증 및 헤더 설정
2	Accept-Language	N	응답 언어 설정 ko-KR 기본값 en-US
3	Accept-Encoding	N	응답 압축 방식 gzip
4	X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
1	receiptNum	string	18	Y	팝빌에서 할당한 접수번호

요청 예시

curl --request GET \
  --url 'https://{domain}/KakaoTalk/{receiptNum}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	contentType	string	-	카카오톡 유형 1 알림톡 4 알림톡 이미지 5 알림톡 강조표기 6 브랜드 메시지 텍스트 7 브랜드 메시지 이미지 8 브랜드 메시지 와이드 9 브랜드 메시지 리스트 10 브랜드 메시지 캐러셀 12 브랜드 메시지 커머스 13 브랜드 메시지 캐러셀 커머스
2	templateCode	string	12	알림톡 템플릿 코드 → 알림톡 전송 시 사용한 코드값
3	bmsTemplateCode	string	12	브랜드 메시지 템플릿 코드 → 브랜드 메시지 전송 시 사용한 코드값
4	plusFriendID	string	30	검색용 아이디
5	targeting	string	1	전송대상 I 채널친구 M 전체 N 비채널 친구 → 브랜드 메시지 전송 시 반환
6	unsubscribeNo	string	20	080 수신거부 전화번호 → 브랜드 메시지 전송 시 반환
7	sendNum	string	20	발신번호
8	altUnsubscribeNo	string	20	대체문자 080 수신거부 전화번호 → 브랜드 메시지 전송 시 반환
9	altSubject	string	64	대체문자 제목 → 단위 : byte
10	altContent	string	2,000	대체문자 내용 → 단위 : byte
11	altSendType	string	1	대체문자 유형 null 미전송 C 카카오톡과 동일 내용 전송 A 대체문자 내용 전송
12	reserveDT	string	14	예약일시 → 형식 : yyyyMMddHHmmss
13	adsYN	boolean	-	광고메시지 전송 여부 true 광고 false 일반
14	sendCnt	string	-	전송건수
15	successCnt	string	-	성공건수
16	failCnt	string	-	실패건수
17	altCnt	string	-	대체문자 건수
18	cancelCnt	string	-	취소건수
19	btns	array	5	버튼 목록
btns 순번 변수명 타입 길이 설명 1 n string 14 버튼명 2 t string 2 버튼유형 WL 웹링크 AL 앱링크 TN 전화걸기 DS 배송조회 MD 메시지전달 BK 봇키워드 AC 채널추가 3 u1 string 1,000 버튼링크 → {t} = "AL" 경우 iOS 앱링크 적용 {t} = "WL" 경우 Mobile 웹링크 적용 4 u2 string 1,000 버튼링크 → {t} = "AL" 경우 Android 앱링크 적용 {t} = "WL" 경우 PC 웹링크 적용 5 tg string 3 아웃 링크 out 디바이스 기본 브라우저 ※ 기본값 : 카카오톡 인앱 브라우저 사용 6 telNum string 14 전화걸기 번호
20	msgs	array	1,000	전송결과 정보
msgs 순번 변수명 타입 길이 설명 1 state number 1 상태코드 → [참고] 팝빌 상태코드 2 sendDT string 14 전송일시 → 형식 : yyyyMMddHHmmss 3 result number 3 카카오 결과코드 → [참고] 카카오 결과코드(카카오톡) ✓ {state} = 3 경우 카카오톡 전송결과 확인 가능 4 resultDT string 14 전송결과 수신일시 → 형식 : yyyyMMddHHmmss 5 reserveDT string 14 예약일시 → 형식 : yyyyMMddHHmmss 6 contentType string - 카카오톡 유형 1 알림톡 4 알림톡 이미지 5 알림톡 강조표기 6 브랜드 메시지 텍스트 7 브랜드 메시지 이미지 8 브랜드 메시지 와이드 9 브랜드 메시지 리스트 10 브랜드 메시지 캐러셀 12 브랜드 메시지 커머스 13 브랜드 메시지 캐러셀 커머스 7 receiveNum string 20 수신번호 8 receiveName string 70 수신자명 9 emphasizeTitle string 50 강조표기 타이틀 → 알림톡 강조표기형 전송 시 반환 10 adultYN boolean - 성인용 메시지 여부 → 브랜드 메시지 전송 시 반환 11 header string 20 제목 → 브랜드 메시지 전송 시 반환 12 content string 1,300 카카오톡 내용 13 addContent string 34 부가메시지 → 브랜드 메시지 전송 시 반환 14 imageUrl string 500 이미지 URL → 브랜드 메시지 전송 시 반환 15 imageLink string 500 이미지 링크 URL → 브랜드 메시지 전송 시 반환 16 altSubject string 64 대체문자 제목 → 단위 : byte 17 altContent string 2,000 대체문자 내용 → 단위 : byte 18 altContentType number - 대체문자 전송타입 4 단문 6 장문 19 altSendDT string 14 대체문자 전송일시 → 형식 : yyyyMMddHHmmss 20 altResult string 3 대체문자 통신사 결과코드 → [참고] 통신사 결과코드(대체문자) 21 altResultDT string 14 대체문자 전송결과 수신일시 → 형식 : yyyyMMddHHmmss 22 receiptNum string 18 접수번호 23 requestNum string 36 요청번호 24 interOPRefKey string 20 파트너 지정키 → 카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값 25 item array 4 아이템 목록 → 브랜드 메시지 전송 시 반환 item 순번 변수명 타입 길이 설명 1 title string 30 타이틀 2 imageUrl string 500 이미지 URL → 메인 아이템인 경우 [UploadWideListMainImage - 리스트 메인 이미지 업로드] API로 응답받은 URL 서브 아이템인 경우 [UploadWideListImage - 리스트 서브 이미지 업로드] API로 응답받은 URL 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 26 commerce object - 커머스 정보 → 브랜드 메시지 전송 시 반환 commerce 순번 변수명 타입 길이 설명 1 title string 30 상품명 2 regularPrice number - 정상가격 → 0 ~ 99,999,999 3 discountType string 1 할인유형 R 할인율 F 할인금액 4 discount number - 할인율/할인금액 → {discountType}="R" 경우 1 ~ 100 {discountType}="F" 경우 0 ~ 999,999 5 discountPrice number - 할인가격 → 0 ~ 99,999,999 할인 적용 후 최종 가격 → {discountType} 입력 시 필수 27 head object - 캐러셀 인트로 → 브랜드 메시지 전송 시 반환 head 순번 변수명 타입 길이 설명 1 header string 20 제목 2 content string 50 내용 3 imageUrl string 500 이미지 URL → [UploadCarouselCommerceImage - 캐러셀 커머스 이미지 업로드] API로 응답받은 URL 4 linkMobile string 1,000 Mobile 웹링크 5 linkPc string 1,000 PC 웹링크 6 linkAndroid string 1,000 Android 앱링크 7 linkIos string 1,000 iOS 앱링크 28 carousel array 6 캐러셀 목록 → 브랜드 메시지 전송 시 반환 carousel 순번 변수명 타입 길이 설명 1 header string 20 제목 2 content string 180 내용 3 imageUrl string 500 이미지 URL 4 imageLink string 500 이미지 링크 URL 5 addContent string 34 부가메시지 6 commerce object - 커머스 정보 commerce 순번 변수명 타입 길이 설명 1 title string 30 상품명 2 regularPrice number - 정상가격 → 0 ~ 99,999,999 3 discountType string 1 할인유형 R 할인율 F 할인금액 4 discount number - 할인율/할인금액 → {discountType}="R" 경우 1 ~ 100 {discountType}="F" 경우 0 ~ 999,999 5 discountPrice number - 할인가격 → 0 ~ 99,999,999 할인 적용 후 최종 가격 → {discountType} 입력 시 필수 7 btns array 2 버튼 목록 btns 순번 변수명 타입 길이 설명 1 n string 8 버튼명 2 t string 2 버튼유형 WL 웹링크 AL 앱링크 MD 메시지전달 BK 봇키워드 AC 채널추가 3 u1 string 1,000 버튼링크 → {t} = "AL" 경우 iOS 앱링크 적용 {t} = "WL" 경우 Mobile 웹링크 적용 4 u2 string 1,000 버튼링크 → {t} = "AL" 경우 Android 앱링크 적용 {t} = "WL" 경우 PC 웹링크 적용 8 coupon object - 쿠폰 coupon 순번 변수명 타입 길이 설명 1 title string 15 쿠폰 제목 #{숫자}원 할인 쿠폰 (숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰 (숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰 2 description string 12 쿠폰 설명 → 줄바꿈 사용 불가 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 29 tail object - 캐러셀 더보기 → 브랜드 메시지 전송 시 반환 tail 순번 변수명 타입 길이 설명 1 linkMobile string 1,000 Mobile 웹링크 2 linkPc string 1,000 PC 웹링크 3 linkAndroid string 1,000 Android 앱링크 4 linkIos string 1,000 iOS 앱링크 30 btns array 5 버튼 목록 btns 순번 변수명 타입 길이 설명 1 n string 14 버튼명 2 t string 2 버튼유형 WL 웹링크 AL 앱링크 TN 전화걸기 DS 배송조회 MD 메시지전달 BK 봇키워드 AC 채널추가 3 u1 string 1,000 버튼링크 → {t} = "AL" 경우 iOS 앱링크 적용 {t} = "WL" 경우 Mobile 웹링크 적용 4 u2 string 1,000 버튼링크 → {t} = "AL" 경우 Android 앱링크 적용 {t} = "WL" 경우 PC 웹링크 적용 5 tg string 3 아웃 링크 out 디바이스 기본 브라우저 ※ 기본값 : 카카오톡 인앱 브라우저 사용 6 telNum string 14 전화걸기 번호 31 coupon object - 쿠폰 → 브랜드 메시지 전송 시 반환 coupon 순번 변수명 타입 길이 설명 1 title string 15 쿠폰 제목 #{숫자}원 할인 쿠폰 (숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰 (숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰 2 description string 12 쿠폰 설명 → 줄바꿈 사용 불가 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 32 contentVariable object - 브랜드 메시지 내용 변수 → 브랜드 메시지 전송 시 반환 33 buttonVariable object - 브랜드 메시지 버튼 변수 → 브랜드 메시지 전송 시 반환 34 couponVariable object - 브랜드 메시지 쿠폰 변수 → 브랜드 메시지 전송 시 반환 35 commerceVariable object - 브랜드 메시지 커머스 변수 → 브랜드 메시지 전송 시 반환 36 carouselVariable object - 브랜드 메시지 캐러셀 변수 → 브랜드 메시지 전송 시 반환 carouselVariable 순번 변수명 타입 길이 설명 1 contentVariable object - 브랜드 메시지 캐러셀 내용 변수 → 캐러셀 제목, 캐러셀 내용, 캐러셀 이미지 링크, 캐러셀 부가메시지에 변수 사용한 경우 필수 2 buttonVariable object - 브랜드 메시지 캐러셀 버튼 변수 → 버튼 링크에 변수 사용한 경우 필수 3 couponVariable object - 브랜드 메시지 캐러셀 쿠폰 변수 → 쿠폰 설명, 링크에 변수 사용한 경우 필수 4 commerceVariable object - 브랜드 메시지 캐러셀 커머스 변수 → 상품명, 정상가격, 할인가격, 할인율, 할인금액에 변수 사용한 경우 필수

응답 예시

{
    "contentType": "1",
    "templateCode": "025050001056",
    "plusFriendID": "@팝빌",
    "sendNum": "1599-7709",
    "sendCnt": "1",
    "successCnt": "1",
    "failCnt": "0",
    "altCnt": "0",
    "cancelCnt": "0",
    "reserveDT": "20251021191706",
    "adsYN": false,
    "btns": [
        {
            "t": "WL",
            "n": "팝빌 바로가기",
            "u1": "https://www.popbill.com/",
            "u2": "https://www.popbill.com/"
        }
    ],
    "msgs": [
        {
            "state": 3,
            "receiveNum": "01012345678",
            "receiveName": "수신자명",
            "content": "[팝빌] 담당자 변경완료 안내\n\n#{담당자}님, 안녕하세요.",
            "sendDT": "20251021191722",
            "result": 100,
            "resultDT": "20251021191722",
            "reserveDT": "20251021191706",
            "adsYN": false,
            "altContent": "",
            "altSubject": "",
            "contentType": "6",
            "regDT": "20251021191207",
            "receiptNum": "025102119120600001",
            "btns": [
                {
                    "t": "WL",
                    "n": "버튼 제목",
                    "u1": "https://www.popbill.com",
                    "u2": "https://www.popbill.com"
                }
            ],
            "coupon": {
                "title": "1000원 할인 쿠폰",
                "description": "쿠폰 설명",
                "linkMobile": "https://www.popbill.com"
            }
        }
    ]
}

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/KakaoTalk/Get/{requestNum} Copied

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

Request

요청 헤더

순번	변수명	필수	설명
1	Authorization	Y	인증 토큰 → [참고] 인증 및 헤더 설정
2	Accept-Language	N	응답 언어 설정 ko-KR 기본값 en-US
3	Accept-Encoding	N	응답 압축 방식 gzip
4	X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
1	requestNum	string	36	Y	파트너가 할당한 요청번호

요청 예시

curl --request GET \
  --url 'https://{domain}/KakaoTalk/Get/{requestNum}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	contentType	string	-	카카오톡 유형 1 알림톡 4 알림톡 이미지 5 알림톡 강조표기 6 브랜드 메시지 텍스트 7 브랜드 메시지 이미지 8 브랜드 메시지 와이드 9 브랜드 메시지 리스트 10 브랜드 메시지 캐러셀 12 브랜드 메시지 커머스 13 브랜드 메시지 캐러셀 커머스
2	templateCode	string	12	알림톡 템플릿 코드 → 알림톡 전송시 사용한 코드값
3	bmsTemplateCode	string	12	브랜드 메시지 템플릿 코드 → 브랜드 메시지 전송 시 사용한 코드값
4	plusFriendID	string	30	검색용 아이디
5	targeting	string	1	전송대상 I 채널친구 M 전체 N 비채널 친구 → 브랜드 메시지 전송 시 반환
6	unsubscribeNo	string	20	080 수신거부 전화번호 → 브랜드 메시지 전송 시 반환
7	sendNum	string	20	발신번호
8	altUnsubscribeNo	string	20	대체문자 080 수신거부 전화번호 → 브랜드 메시지 전송 시 반환
9	altSubject	string	64	대체문자 제목 → 단위 : byte
10	altContent	string	2,000	대체문자 내용 → 단위 : byte
11	altSendType	string	1	대체문자 유형 null 미전송 C 카카오톡과 동일 내용 전송 A 대체문자 내용 전송
12	reserveDT	string	14	예약일시 → 형식 : yyyyMMddHHmmss
13	adsYN	boolean	-	광고메시지 전송 여부 true 광고 false 일반
14	sendCnt	string	-	전송건수
15	successCnt	string	-	성공건수
16	failCnt	string	-	실패건수
17	altCnt	string	-	대체문자 건수
18	cancelCnt	string	-	취소건수
19	btns	array	5	버튼 목록
btns 순번 변수명 타입 길이 설명 1 n string 14 버튼명 2 t string 2 버튼유형 WL 웹링크 AL 앱링크 TN 전화걸기 DS 배송조회 MD 메시지전달 BK 봇키워드 AC 채널추가 3 u1 string 1,000 버튼링크 → {t} = "AL" 경우 iOS 앱링크 적용 {t} = "WL" 경우 Mobile 웹링크 적용 4 u2 string 1,000 버튼링크 → {t} = "AL" 경우 Android 앱링크 적용 {t} = "WL" 경우 PC 웹링크 적용 5 tg string 3 아웃 링크 out 디바이스 기본 브라우저 ※ 기본값 : 카카오톡 인앱 브라우저 사용 6 telNum string 14 전화걸기 번호
20	msgs	array	-	전송결과 정보 → 최대 : 1,000건
msgs 순번 변수명 타입 길이 설명 1 state number 1 상태코드 → [참고] 팝빌 상태코드 2 sendDT string 14 전송일시 → 형식 : yyyyMMddHHmmss 3 result number 3 카카오 결과코드 → [참고] 카카오 결과코드(카카오톡) ✓ {state} = 3 경우 카카오톡 전송결과 확인 가능 4 resultDT string 14 전송결과 수신일시 → 형식 : yyyyMMddHHmmss 5 reserveDT string 14 예약일시 → 형식 : yyyyMMddHHmmss 6 contentType string - 카카오톡 유형 1 알림톡 4 알림톡 이미지 5 알림톡 강조표기 6 브랜드 메시지 텍스트 7 브랜드 메시지 이미지 8 브랜드 메시지 와이드 9 브랜드 메시지 리스트 10 브랜드 메시지 캐러셀 12 브랜드 메시지 커머스 13 브랜드 메시지 캐러셀 커머스 7 receiveNum string 20 수신번호 8 receiveName string 70 수신자명 9 emphasizeTitle string 50 강조표기 타이틀 → 알림톡 강조표기형 전송 시 반환 10 adultYN boolean - 성인용 메시지 여부 → 브랜드 메시지 전송 시 반환 11 header string 20 제목 → 브랜드 메시지 전송 시 반환 12 content string 1,300 카카오톡 내용 13 addContent string 34 부가메시지 → 브랜드 메시지 전송 시 반환 14 imageUrl string 500 이미지 URL → 브랜드 메시지 전송 시 반환 15 imageLink string 500 이미지 링크 URL → 브랜드 메시지 전송 시 반환 16 altSubject string 64 대체문자 제목 → 단위 : byte 17 altContent string 2,000 대체문자 내용 → 단위 : byte 18 altContentType number - 대체문자 전송타입 4 단문 6 장문 19 altSendDT string 14 대체문자 전송일시 → 형식 : yyyyMMddHHmmss 20 altResult string 3 대체문자 통신사 결과코드 → [참고] 통신사 결과코드(대체문자) 21 altResultDT string 14 대체문자 전송결과 수신일시 → 형식 : yyyyMMddHHmmss 22 receiptNum string 18 접수번호 23 requestNum string 36 요청번호 24 interOPRefKey string 20 파트너 지정키 → 카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값 25 item array 4 아이템 목록 → 브랜드 메시지 전송 시 반환 item 순번 변수명 타입 길이 설명 1 title string 30 타이틀 2 imageUrl string 500 이미지 URL → 메인 아이템인 경우 [UploadWideListMainImage - 리스트 메인 이미지 업로드] API로 응답받은 URL 서브 아이템인 경우 [UploadWideListImage - 리스트 서브 이미지 업로드] API로 응답받은 URL 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 26 commerce object - 커머스 정보 → 브랜드 메시지 전송 시 반환 commerce 순번 변수명 타입 길이 설명 1 title string 30 상품명 2 regularPrice number - 정상가격 → 0 ~ 99,999,999 3 discountType string 1 할인유형 R 할인율 F 할인금액 4 discount number - 할인율/할인금액 → {discountType}="R" 경우 1 ~ 100 {discountType}="F" 경우 0 ~ 999,999 5 discountPrice number - 할인가격 → 0 ~ 99,999,999 할인 적용 후 최종 가격 → {discountType} 입력 시 필수 27 head object - 캐러셀 인트로 → 브랜드 메시지 전송 시 반환 head 순번 변수명 타입 길이 설명 1 header string 20 제목 2 content string 50 내용 3 imageUrl string 500 이미지 URL → [UploadCarouselCommerceImage - 캐러셀 커머스 이미지 업로드] API로 응답받은 URL 4 linkMobile string 1,000 Mobile 웹링크 5 linkPc string 1,000 PC 웹링크 6 linkAndroid string 1,000 Android 앱링크 7 linkIos string 1,000 iOS 앱링크 28 carousel array 6 캐러셀 목록 → 브랜드 메시지 전송 시 반환 carousel 순번 변수명 타입 길이 설명 1 header string 20 제목 2 content string 180 내용 3 imageUrl string 500 이미지 URL 4 imageLink string 500 이미지 링크 URL 5 addContent string 34 부가메시지 6 commerce object - 커머스 정보 commerce 순번 변수명 타입 길이 설명 1 title string 30 상품명 2 regularPrice number - 정상가격 → 0 ~ 99,999,999 3 discountType string 1 할인유형 R 할인율 F 할인금액 4 discount number - 할인율/할인금액 → {discountType}="R" 경우 1 ~ 100 {discountType}="F" 경우 0 ~ 999,999 5 discountPrice number - 할인가격 → 0 ~ 99,999,999 할인 적용 후 최종 가격 → {discountType} 입력 시 필수 7 btns array 2 버튼 목록 btns 순번 변수명 타입 길이 설명 1 n string 8 버튼명 2 t string 2 버튼유형 WL 웹링크 AL 앱링크 MD 메시지전달 BK 봇키워드 AC 채널추가 3 u1 string 1,000 버튼링크 → {t} = "AL" 경우 iOS 앱링크 적용 {t} = "WL" 경우 Mobile 웹링크 적용 4 u2 string 1,000 버튼링크 → {t} = "AL" 경우 Android 앱링크 적용 {t} = "WL" 경우 PC 웹링크 적용 8 coupon object - 쿠폰 coupon 순번 변수명 타입 길이 설명 1 title string 15 쿠폰 제목 #{숫자}원 할인 쿠폰 (숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰 (숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰 2 description string 12 쿠폰 설명 → 줄바꿈 사용 불가 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 29 tail object - 캐러셀 더보기 tail 순번 변수명 타입 길이 설명 1 linkMobile string 1,000 Mobile 웹링크 2 linkPc string 1,000 PC 웹링크 3 linkAndroid string 1,000 Android 앱링크 4 linkIos string 1,000 iOS 앱링크 30 btns array 5 버튼 목록 btns 순번 변수명 타입 길이 설명 1 n string 14 버튼명 2 t string 2 버튼유형 WL 웹링크 AL 앱링크 TN 전화걸기 DS 배송조회 MD 메시지전달 BK 봇키워드 AC 채널추가 3 u1 string 1,000 버튼링크 → {t} = "AL" 경우 iOS 앱링크 적용 {t} = "WL" 경우 Mobile 웹링크 적용 4 u2 string 1,000 버튼링크 → {t} = "AL" 경우 Android 앱링크 적용 {t} = "WL" 경우 PC 웹링크 적용 5 tg string 3 아웃 링크 out 디바이스 기본 브라우저 ※ 기본값 : 카카오톡 인앱 브라우저 사용 6 telNum string 14 전화걸기 번호 31 coupon object - 쿠폰 → 브랜드 메시지 전송 시 반환 coupon 순번 변수명 타입 길이 설명 1 title string 15 쿠폰 제목 #{숫자}원 할인 쿠폰 (숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰 (숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰 2 description string 12 쿠폰 설명 → 줄바꿈 사용 불가 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 32 contentVariable object - 브랜드 메시지 내용 변수 → 브랜드 메시지 전송 시 반환 33 buttonVariable object - 브랜드 메시지 버튼 변수 → 브랜드 메시지 전송 시 반환 34 couponVariable object - 브랜드 메시지 쿠폰 변수 → 브랜드 메시지 전송 시 반환 35 commerceVariable object - 브랜드 메시지 커머스 변수 → 브랜드 메시지 전송 시 반환 36 carouselVariable object - 브랜드 메시지 캐러셀 변수 → 브랜드 메시지 전송 시 반환 carouselVariable 순번 변수명 타입 길이 설명 1 contentVariable object - 브랜드 메시지 캐러셀 내용 변수 → 캐러셀 제목, 캐러셀 내용, 캐러셀 이미지 링크, 캐러셀 부가메시지에 변수 사용한 경우 필수 2 buttonVariable object - 브랜드 메시지 캐러셀 버튼 변수 → 버튼 링크에 변수 사용한 경우 필수 3 couponVariable object - 브랜드 메시지 캐러셀 쿠폰 변수 → 쿠폰 설명, 링크에 변수 사용한 경우 필수 4 commerceVariable object - 브랜드 메시지 캐러셀 커머스 변수 → 상품명, 정상가격, 할인가격, 할인율, 할인금액에 변수 사용한 경우 필수

응답 예시

{
    "contentType": "6",
    "requestNum": "25251026131000",
    "templateCode": "025050001052",
    "plusFriendID": "@팝빌",
    "sendNum": "1599-7709",
    "altContent": "대체문자 내용",
    "sendCnt": "2",
    "successCnt": "0",
    "failCnt": "2",
    "altCnt": "0",
    "cancelCnt": "0",
    "adsYN": false,
    "btns": [
        {
            "t": "WL",
            "n": "팝빌 바로가기",
            "u1": "https://www.popbill.com/",
            "u2": "https://www.popbill.com/"
        }
    ],
    "msgs": [
        {
            "state": 3,
            "receiveNum": "01022223333",
            "receiveName": "수신자명",
            "content": "[테스트] 테스트 템플릿입니다",
            "sendDT": "20251026131238",
            "result": 680,
            "resultDT": "20251026131238",
            "adsYN": false,
            "contentType": "1",
            "regDT": "20251026131236",
            "receiptNum": "025102613123600001",
            "requestNum": "25251026131000",
            "btns": [
                {
                    "t": "WL",
                    "n": "버튼 제목",
                    "u1": "https://www.popbill.com",
                    "u2": "https://www.popbill.com"
                }
            ],
            "coupon": {
                "title": "1000원 할인 쿠폰",
                "description": "쿠폰 설명",
                "linkMobile": "https://www.popbill.com"
            }
        }
    ]
}

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/KakaoTalk/Search Copied

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

매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.

Request

요청 헤더

순번	변수명	필수	설명
1	Authorization	Y	인증 토큰 → [참고] 인증 및 헤더 설정
2	Accept-Language	N	응답 언어 설정 ko-KR 기본값 en-US
3	Accept-Encoding	N	응답 압축 방식 gzip
4	X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	SDate	string	8	Y	검색 시작일자 → 형식 : yyyyMMdd
2	EDate	string	8	Y	검색 종료일자 → 형식 : yyyyMMdd
3	State	string	-	N	전송상태 (다중 선택 가능) 0 전송대기 1 전송중 2 전송성공 3 대체문자 전송성공 4 전송실패 5 예약취소 → 다중 선택시 콤마(',')로 구분. 예) 0,1
4	Item	string	-	N	검색대상(다중 선택 가능) ATS 알림톡 BMS 브랜드 메시지 → 다중 선택 시 콤마(',')로 구분. 예) ATS,BMS ※ 기본값 : 전체조회
5	ReserveYN	string	1	N	전송유형별 조회 (택 1) 0 즉시전송건 1 예약전송건 ※ 기본값 : 전체조회
6	SenderOnly	boolean	-	N	사용자권한별 조회 true 팝빌회원 아이디(UserID)로 전송한 카카오톡만 조회 false 전송한 카카오톡 전체 조회 : 기본값
7	Order	string	1	N	카카오톡 접수일시를 기준으로 하는 목록 정렬 방향 D 내림차순 : 기본값 A 오름차순
8	Page	number	-	N	목록 페이지번호 ※ 기본값 : 1
9	PerPage	number	-	N	페이지당 표시할 목록 건수 → 최대 : 1,000건 ※ 기본값 : 500건
10	QString	string	70	N	조회 검색어(수신자명, 수신번호) ※ 기본값 : 전체조회
11	PlusFriendID	string	30	N	검색용 아이디
12	ContentType	string	-	N	카카오톡 유형 (다중 선택 가능) 1 알림톡 4 알림톡 이미지 5 알림톡 강조표기 6 브랜드 메시지 텍스트 7 브랜드 메시지 이미지 8 브랜드 메시지 와이드 9 브랜드 메시지 리스트 10 브랜드 메시지 캐러셀 12 브랜드 메시지 커머스 13 브랜드 메시지 캐러셀 커머스 → 다중 선택 시 콤마(',')로 구분. 예) 1,4

요청 예시

curl --request GET \
  --url 'https://{domain}/KakaoTalk/Search?SDate={Sdate}&EDate={EDate}&State={State}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	code	number	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지
3	total	number	-	총 검색결과 건수
4	perPage	number	-	페이지 당 목록 건수
5	pageNum	number	-	페이지 번호
6	pageCount	number	-	페이지 개수
7	list	array	1,000	전송결과 정보
list 순번 변수명 타입 길이 설명 1 state number 1 상태코드 → [참고] 팝빌 상태코드 2 sendDT string 14 전송일시 → 형식 : yyyyMMddHHmmss 3 result number 3 카카오 결과코드 → [참고] 카카오 결과코드(카카오톡) ✓ {state} = 3 경우 카카오톡 전송결과 확인 가능 4 resultDT string 14 전송결과 수신일시 → 형식 : yyyyMMddHHmmss 5 contentType string - 카카오톡 유형 1 알림톡 4 알림톡 이미지 5 알림톡 강조표기 6 브랜드 메시지 텍스트 7 브랜드 메시지 이미지 8 브랜드 메시지 와이드 9 브랜드 메시지 리스트 10 브랜드 메시지 캐러셀 12 브랜드 메시지 커머스 13 브랜드 메시지 캐러셀 커머스 6 receiveNum string 20 수신번호 7 receiveName string 70 수신자명 8 emphasizeTitle string 50 강조표기 타이틀 → 알림톡 강조표기형 전송 시 반환 9 adultYN boolean - 성인용 메시지 여부 → 브랜드 메시지 전송 시 반환 10 header string 20 제목 → 브랜드 메시지 전송 시 반환 11 content string 1,300 카카오톡 내용 12 addContent string 34 부가메시지 → 브랜드 메시지 전송 시 반환 13 imageUrl string 500 이미지 URL 14 imageLink string 500 이미지 링크 URL 15 altSubject string 64 대체문자 제목 → 단위 : byte 16 altContent string 2,000 대체문자 내용 → 단위 : byte 17 altContentType number - 대체문자 전송타입 4 단문 6 장문 18 altSendDT string 14 대체문자 전송일시 → 형식 : yyyyMMddHHmmss 19 altResult string 3 대체문자 통신사 결과코드 → [참고] 통신사 결과코드(대체문자) 20 altResultDT string 14 대체문자 전송결과 수신일시 → 형식 : yyyyMMddHHmmss 21 receiptNum string 18 접수번호 22 requestNum string 36 요청번호 23 interOPRefKey string 20 파트너 지정키 → 카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값 24 item array 4 아이템 목록 → 브랜드 메시지 전송 시 반환 item 순번 변수명 타입 길이 설명 1 title string 30 타이틀 2 imageUrl string 500 이미지 URL → 메인 아이템인 경우 [UploadWideListMainImage - 리스트 메인 이미지 업로드] API로 응답받은 URL 서브 아이템인 경우 [UploadWideListImage - 리스트 서브 이미지 업로드] API로 응답받은 URL 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 25 commerce object - 커머스 정보 → 브랜드 메시지 전송 시 반환 commerce 순번 변수명 타입 길이 설명 1 title string 30 상품명 2 regularPrice number - 정상가격 → 0 ~ 99,999,999 3 discountType string 1 할인유형 R 할인율 F 할인금액 4 discount number - 할인율/할인금액 → {discountType}="R" 경우 1 ~ 100 {discountType}="F" 경우 0 ~ 999,999 5 discountPrice number - 할인가격 → 0 ~ 99,999,999 할인 적용 후 최종 가격 → {discountType} 입력 시 필수 26 head object - 캐러셀 인트로 → 브랜드 메시지 전송 시 반환 head 순번 변수명 타입 길이 설명 1 header string 20 제목 2 content string 50 내용 3 imageUrl string 500 이미지 URL → [UploadCarouselCommerceImage - 캐러셀 커머스 이미지 업로드] API로 응답받은 URL 4 linkMobile string 1,000 Mobile 웹링크 5 linkPc string 1,000 PC 웹링크 6 linkAndroid string 1,000 Android 앱링크 7 linkIos string 1,000 iOS 앱링크 27 carousel array 6 캐러셀 목록 → 브랜드 메시지 전송 시 반환 carousel 순번 변수명 타입 길이 설명 1 header string 20 제목 2 content string 180 내용 3 imageUrl string 500 이미지 URL 4 imageLink string 500 이미지 링크 URL 5 addContent string 34 부가메시지 6 commerce object - 커머스 정보 commerce 순번 변수명 타입 길이 설명 1 title string 30 상품명 2 regularPrice number - 정상가격 → 0 ~ 99,999,999 3 discountType string 1 할인유형 R 할인율 F 할인금액 4 discount number - 할인율/할인금액 → {discountType}="R" 경우 1 ~ 100 {discountType}="F" 경우 0 ~ 999,999 5 discountPrice number - 할인가격 → 0 ~ 99,999,999 할인 적용 후 최종 가격 → {discountType} 입력 시 필수 7 btns array 2 버튼 목록 btns 순번 변수명 타입 길이 설명 1 n string 8 버튼명 2 t string 2 버튼유형 WL 웹링크 AL 앱링크 MD 메시지전달 BK 봇키워드 AC 채널추가 3 u1 string 1,000 버튼링크 → {t} = "AL" 경우 iOS 앱링크 적용 {t} = "WL" 경우 Mobile 웹링크 적용 4 u2 string 1,000 버튼링크 → {t} = "AL" 경우 Android 앱링크 적용 {t} = "WL" 경우 PC 웹링크 적용 8 coupon object - 쿠폰 coupon 순번 변수명 타입 길이 설명 1 title string 15 쿠폰 제목 #{숫자}원 할인 쿠폰 (숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰 (숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰 2 description string 12 쿠폰 설명 → 줄바꿈 사용 불가 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 28 tail object - 캐러셀 더보기 → 브랜드 메시지 전송 시 반환 tail 순번 변수명 타입 길이 설명 1 linkMobile string 1,000 Mobile 웹링크 2 linkPc string 1,000 PC 웹링크 3 linkAndroid string 1,000 Android 앱링크 4 linkIos string 1,000 iOS 앱링크 29 btns array 5 버튼 목록 btns 순번 변수명 타입 길이 설명 1 n string 14 버튼명 2 t string 2 버튼유형 WL 웹링크 AL 앱링크 TN 전화걸기 DS 배송조회 MD 메시지전달 BK 봇키워드 AC 채널추가 3 u1 string 1,000 버튼링크 → {t} = "AL" 경우 iOS 앱링크 적용 {t} = "WL" 경우 Mobile 웹링크 적용 4 u2 string 1,000 버튼링크 → {t} = "AL" 경우 Android 앱링크 적용 {t} = "WL" 경우 PC 웹링크 적용 5 tg string 3 아웃 링크 out 디바이스 기본 브라우저 ※ 기본값 : 카카오톡 인앱 브라우저 사용 6 telNum string 14 전화걸기 번호 30 coupon object - 쿠폰 → 브랜드 메시지 전송 시 반환 coupon 순번 변수명 타입 길이 설명 1 title string 15 쿠폰 제목 #{숫자}원 할인 쿠폰 (숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰 (숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰 2 description string 12 쿠폰 설명 → 줄바꿈 사용 불가 3 linkMobile string 1,000 Mobile 웹링크 4 linkPc string 1,000 PC 웹링크 5 linkAndroid string 1,000 Android 앱링크 6 linkIos string 1,000 iOS 앱링크 31 contentVariable object - 브랜드 메시지 내용 변수 → 브랜드 메시지 전송 시 반환 32 buttonVariable object - 브랜드 메시지 버튼 변수 → 브랜드 메시지 전송 시 반환 33 couponVariable object - 브랜드 메시지 쿠폰 변수 → 브랜드 메시지 전송 시 반환 34 commerceVariable object - 브랜드 메시지 커머스 변수 → 브랜드 메시지 전송 시 반환 35 carouselVariable object - 브랜드 메시지 캐러셀 변수 → 브랜드 메시지 전송 시 반환 carouselVariable 순번 변수명 타입 길이 설명 1 contentVariable object - 브랜드 메시지 캐러셀 내용 변수 → 캐러셀 제목, 캐러셀 내용, 캐러셀 이미지 링크, 캐러셀 부가메시지에 변수 사용한 경우 필수 2 buttonVariable object - 브랜드 메시지 캐러셀 버튼 변수 → 버튼 링크에 변수 사용한 경우 필수 3 couponVariable object - 브랜드 메시지 캐러셀 쿠폰 변수 → 쿠폰 설명, 링크에 변수 사용한 경우 필수 4 commerceVariable object - 브랜드 메시지 캐러셀 커머스 변수 → 상품명, 정상가격, 할인가격, 할인율, 할인금액에 변수 사용한 경우 필수

응답 예시

{
    "code": 1,
    "message": "검색 완료",
    "total": 10,
    "perPage": 500,
    "pageNum": 1,
    "pageCount": 1,
    "list": [
        {
            "state": 3,
            "receiveNum": "01012345678",
            "receiveName": "수신자명",
            "content": "[팝빌] 국세청 전송실패 안내",
            "sendDT": "20251025091511",
            "result": 100,
            "resultDT": "20251025091511",
            "adsYN": false,
            "altContent": "[팝빌] 현금영수증 국세청 전송실패 안내",
            "contentType": "6",
            "regDT": "20251025091509",
            "receiptNum": "025102509150800001",
            "btns": [
                {
                    "t": "WL",
                    "n": "버튼 제목",
                    "u1": "https://www.popbill.com",
                    "u2": "https://www.popbill.com"
                }
            ],
            "coupon": {
                "title": "1000원 할인 쿠폰",
                "description": "쿠폰 설명",
                "linkMobile": "https://www.popbill.com"
            }
        }
    ]
}

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/KakaoTalk Copied

미리보기

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

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

Request

요청 헤더

순번	변수명	필수	설명
1	Authorization	Y	인증 토큰 → [참고] 인증 및 헤더 설정
2	Accept-Language	N	응답 언어 설정 ko-KR 기본값 en-US
3	Accept-Encoding	N	응답 압축 방식 gzip
4	X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	TG	string	-	Y	고정값 : BOX

요청 예시

curl --request GET \
  --url 'https://{domain}/KakaoTalk?TG=BOX' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	url	string	-	카카오톡 전송내역 팝업 URL

응답 예시

{
    "url": "https://test.popbill.com/App/API?T=IRXSGITDREOTPOIRLPUHCB4BSBC4...NX7BMAR3="
}