전송결과

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

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

def getMessages(corpNum, receiptNum, userID=None):

요청

Parameters

변수명	타입	길이	필수	설명
corpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
receiptNum	str	18	Y	팝빌에서 할당한 접수번호
userID	str	50	N	팝빌회원 아이디

응답

KakaoSentInfo

순번

변수명

타입

길이

설명

contentType

int

카카오톡 유형

1알림톡

4알림톡 이미지

5알림톡 강조표기

6브랜드 메시지 텍스트

7브랜드 메시지 이미지

8브랜드 메시지 와이드

9브랜드 메시지 리스트

10브랜드 메시지 캐러셀

12브랜드 메시지 커머스

13브랜드 메시지 캐러셀 커머스

templateCode

str

알림톡 템플릿 코드

알림톡 전송 시 사용한 코드값

bmsTemplateCode

str

브랜드 메시지 템플릿 코드

브랜드 메시지 전송 시 사용한 코드값

plusFriendID

str

검색용 아이디

targeting

str

전송대상

I채널친구

M전체

N비채널 친구

브랜드 메시지 전송 시 반환

unsubscribeNo

str

080 무료수신거부 전화번호

브랜드 메시지 전송 시 반환

sendNum

str

발신번호

altUnsubscribeNo

str

대체문자 080 무료수신거부 전화번호

브랜드 메시지 전송 시 반환

altSubject

str

대체문자 제목

단위 : byte

altContent

str

2,000

대체문자 내용

단위 : byte

altSendType

str

대체문자 유형

null미전송

C카카오톡과 동일 내용 전송

A대체문자 내용 전송

reserveDT

str

예약일시

형식 : yyyyMMddHHmmss

adsYN

bool

광고메시지 전송 여부

true광고

false일반

sendCnt

str

전송건수

successCnt

str

성공건수

failCnt

str

실패건수

altCnt

str

대체문자 건수

cancelCnt

str

취소건수

btns

KakaoButton[ ]

버튼 목록

최대 : 5개

변수명	타입	길이	설명
n	str	14	버튼명
t	str	2	버튼유형 WL웹링크 AL앱링크 TN전화걸기 - 알림톡 전용 DS배송조회 - 알림톡 전용 MD메시지전달 BK봇키워드 AC채널추가
u1	str	1,000	버튼링크 - {t} = "AL" 경우 iOS 앱링크 적용 - {t} = "WL" 경우 Mobile 웹링크 적용
u2	str	1,000	버튼링크 - {t} = "AL" 경우 Android 앱링크 적용 - {t} = "WL" 경우 PC 웹링크 적용
tg	str	3	아웃 링크 out디바이스 기본 브라우저 공백(기본값) : 카카오톡 인앱 브라우저 사용
telNum	str	14	전화번호 {t} = "TN" 경우 반환

msgs

KakaoSentDetail[ ]

1,000

전송결과 정보

순번

변수명

타입

길이

설명

state

int

상태코드

[참고] 팝빌 상태코드

sendDT

str

전송일시

형식 : yyyyMMddHHmmss

result

int

카카오 결과코드

{state} = 3 경우 카카오톡 전송결과 확인 가능

[참고] 카카오 결과코드(카카오톡)

resultDT

str

전송결과 수신일시

형식 : yyyyMMddHHmmss

contentType

int

카카오톡 유형

1알림톡

4알림톡 이미지

5알림톡 강조표기

6브랜드 메시지 텍스트

7브랜드 메시지 이미지

8브랜드 메시지 와이드

9브랜드 메시지 리스트

10브랜드 메시지 캐러셀

12브랜드 메시지 커머스

13브랜드 메시지 캐러셀 커머스

receiveNum

str

수신번호

receiveName

str

수신자명

emphasizeTitle

str

강조표기 타이틀

알림톡 강조표기형 전송 시 반환

adultYN

bool

성인용 메시지 여부

브랜드 메시지 전송 시 반환

header

str

제목

브랜드 메시지 전송 시 반환

content

str

1,300

카카오톡 내용

addContent

str

부가메시지

브랜드 메시지 전송 시 반환

imageUrl

str

500

이미지 URL

브랜드 메시지 전송 시 반환

imageLink

str

500

이미지 링크 URL

브랜드 메시지 전송 시 반환

altSubject

str

대체문자 제목

단위 : byte

altContent

str

2,000

대체문자 내용

단위 : byte

altContentType

int

대체문자 전송타입

4단문

6장문

altSendDT

str

대체문자 전송일시

형식 : yyyyMMddHHmmss

altResult

int

대체문자 통신사 결과코드

[참고] 통신사 결과코드(대체문자)

altResultDT

str

대체문자 전송결과 수신일시

형식 : yyyyMMddHHmmss

reserveDT

str

예약일시

형식 : yyyyMMddHHmmss

receiptNum

str

접수번호

requestNum

str

요청번호

interOPRefKey

str

파트너 지정키

카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값

item

KakaoItem[ ]

아이템 목록

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	30	타이틀
imageUrl	str	500	이미지 URL
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

commerce

KakaoCommerce

커머스 정보

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	30	상품명
regularPrice	int	-	정상가격 0 ~ 99,999,999
discountType	str	-	할인유형 R할인율 F할인금액
discountPrice	int	-	할인가격 0 ~ 99,999,999
discount	int	-	할인율/할인금액 {discountType}="R" 경우 0 ~ 100 {discountType}="F" 경우 0 ~ 999,999

head

KakaoCarouselHead

캐러셀 인트로

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
header	str	20	제목
content	str	50	내용
imageUrl	str	500	이미지 URL
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

carousel

KakaoCarousel[ ]

캐러셀 목록

브랜드 메시지 전송 시 반환

순번

변수명

타입

길이

설명

header

str

제목

content

str

180

내용

imageUrl

str

500

이미지 URL

imageLink

str

500

이미지 링크 URL

이미지를 클릭하면 연결되는 URL

addContent

str

부가메시지

commerce

KakaoCommerce

커머스 정보

변수명	타입	길이	설명
title	str	30	상품명
regularPrice	int	-	정상가격 0 ~ 99,999,999
discountType	str	-	할인유형 R할인율 F할인금액
discountPrice	int	-	할인가격 0 ~ 99,999,999
discount	int	-	할인율/할인금액 {discountType}="R" 경우 0 ~ 100 {discountType}="F" 경우 0 ~ 999,999

btns

KakaoButton[ ]

버튼 목록

변수명	타입	길이	설명
n	str	8	버튼명
t	str	2	버튼유형 WL웹링크 AL앱링크 MD메시지전달 BK봇키워드 AC채널추가
u1	str	1,000	버튼링크 - {t} = "AL" 경우 iOS 앱링크 적용 - {t} = "WL" 경우 Mobile 웹링크 적용
u2	str	1,000	버튼링크 - {t} = "AL" 경우 Android 앱링크 적용 - {t} = "WL" 경우 PC 웹링크 적용

coupon

KakaoCoupon

쿠폰

변수명	타입	길이	설명
title	str	15	쿠폰 제목 #{숫자}원 할인 쿠폰(숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰(숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰
description	str	12	쿠폰 설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

tail

KakaoCarouselTail

캐러셀 더보기

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

btns

KakaoButton[ ]

버튼 목록

변수명	타입	길이	설명
n	str	14	버튼명
t	str	2	버튼유형 WL웹링크 AL앱링크 TN전화걸기 - 알림톡 전용 DS배송조회 - 알림톡 전용 MD메시지전달 BK봇키워드 AC채널추가
u1	str	1,000	버튼링크 - {t} = "AL" 경우 iOS 앱링크 적용 - {t} = "WL" 경우 Mobile 웹링크 적용
u2	str	1,000	버튼링크 - {t} = "AL" 경우 Android 앱링크 적용 - {t} = "WL" 경우 PC 웹링크 적용
tg	str	3	아웃 링크 out디바이스 기본 브라우저 공백(기본값) : 카카오톡 인앱 브라우저 사용
telNum	str	14	전화번호 {t} = "TN" 경우 반환

coupon

KakaoCoupon

쿠폰

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	15	쿠폰 제목 #{숫자}원 할인 쿠폰(숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰(숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰
description	str	12	쿠폰 설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

contentVariable

dict

브랜드 메시지 내용 변수

브랜드 메시지 전송 시 반환

buttonVariable

dict

브랜드 메시지 버튼 변수

브랜드 메시지 전송 시 반환

couponVariable

dict

브랜드 메시지 쿠폰 변수

브랜드 메시지 전송 시 반환

commerceVariable

dict

브랜드 메시지 커머스 변수

브랜드 메시지 전송 시 반환

carouselVariable

KakaoCarouselVariable[ ]

브랜드 메시지 캐러셀 변수

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
contentVariable	dict	-	브랜드 메시지 캐러셀 내용 변수
buttonVariable	dict	-	브랜드 메시지 캐러셀 버튼 변수
couponVariable	dict	-	브랜드 메시지 캐러셀 쿠폰 변수
commerceVariable	dict	-	브랜드 메시지 캐러셀 커머스 변수

예외

PopbillException

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

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

def getMessagesRN(corpNum, requestNum, userID=None):

요청

Parameters

변수명	타입	길이	필수	설명
corpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
requestNum	str	36	Y	파트너가 할당한 요청번호
userID	str	50	N	팝빌회원 아이디

응답

KakaoSentInfo

순번

변수명

타입

길이

설명

contentType

int

카카오톡 유형

1알림톡

4알림톡 이미지

5알림톡 강조표기

6브랜드 메시지 텍스트

7브랜드 메시지 이미지

8브랜드 메시지 와이드

9브랜드 메시지 리스트

10브랜드 메시지 캐러셀

12브랜드 메시지 커머스

13브랜드 메시지 캐러셀 커머스

templateCode

str

알림톡 템플릿 코드

알림톡 전송 시 사용한 코드값

bmsTemplateCode

str

브랜드 메시지 템플릿 코드

브랜드 메시지 전송 시 사용한 코드값

plusFriendID

str

검색용 아이디

targeting

str

전송대상

I채널친구

M전체

N비채널 친구

브랜드 메시지 전송 시 반환

unsubscribeNo

str

080 무료수신거부 전화번호

브랜드 메시지 전송 시 반환

sendNum

str

발신번호

altUnsubscribeNo

str

대체문자 080 무료수신거부 전화번호

브랜드 메시지 전송 시 반환

altSubject

str

대체문자 제목

단위 : byte

altContent

str

2,000

대체문자 내용

단위 : byte

altSendType

str

대체문자 유형

null미전송

C카카오톡과 동일 내용 전송

A대체문자 내용 전송

reserveDT

str

예약일시

형식 : yyyyMMddHHmmss

adsYN

bool

광고메시지 전송 여부

true광고

false일반

sendCnt

str

전송건수

successCnt

str

성공건수

failCnt

str

실패건수

altCnt

str

대체문자 건수

cancelCnt

str

취소건수

btns

KakaoButton[ ]

버튼 목록

최대 : 5개

변수명	타입	길이	설명
n	str	14	버튼명
t	str	2	버튼유형 WL웹링크 AL앱링크 TN전화걸기 - 알림톡 전용 DS배송조회 - 알림톡 전용 MD메시지전달 BK봇키워드 AC채널추가
u1	str	1,000	버튼링크 - {t} = "AL" 경우 iOS 앱링크 적용 - {t} = "WL" 경우 Mobile 웹링크 적용
u2	str	1,000	버튼링크 - {t} = "AL" 경우 Android 앱링크 적용 - {t} = "WL" 경우 PC 웹링크 적용
tg	str	3	아웃 링크 out디바이스 기본 브라우저 공백(기본값) : 카카오톡 인앱 브라우저 사용
telNum	str	14	전화번호 {t} = "TN" 경우 반환

msgs

KakaoSentDetail[ ]

1,000

전송결과 정보

순번

변수명

타입

길이

설명

state

int

상태코드

[참고] 팝빌 상태코드

sendDT

str

전송일시

형식 : yyyyMMddHHmmss

result

int

카카오 결과코드

{state} = 3 경우 카카오톡 전송결과 확인 가능

[참고] 카카오 결과코드(카카오톡)

resultDT

str

전송결과 수신일시

형식 : yyyyMMddHHmmss

contentType

int

카카오톡 유형

1알림톡

4알림톡 이미지

5알림톡 강조표기

6브랜드 메시지 텍스트

7브랜드 메시지 이미지

8브랜드 메시지 와이드

9브랜드 메시지 리스트

10브랜드 메시지 캐러셀

12브랜드 메시지 커머스

13브랜드 메시지 캐러셀 커머스

receiveNum

str

수신번호

receiveName

str

수신자명

emphasizeTitle

str

강조표기 타이틀

알림톡 강조표기형 전송 시 반환

adultYN

bool

성인용 메시지 여부

브랜드 메시지 전송 시 반환

header

str

제목

브랜드 메시지 전송 시 반환

content

str

1,300

카카오톡 내용

addContent

str

부가메시지

브랜드 메시지 전송 시 반환

imageUrl

str

500

이미지 URL

브랜드 메시지 전송 시 반환

imageLink

str

500

이미지 링크 URL

브랜드 메시지 전송 시 반환

altSubject

str

대체문자 제목

단위 : byte

altContent

str

2,000

대체문자 내용

단위 : byte

altContentType

int

대체문자 전송타입

4단문

6장문

altSendDT

str

대체문자 전송일시

형식 : yyyyMMddHHmmss

altResult

int

대체문자 통신사 결과코드

[참고] 통신사 결과코드(대체문자)

altResultDT

str

대체문자 전송결과 수신일시

형식 : yyyyMMddHHmmss

reserveDT

str

예약일시

형식 : yyyyMMddHHmmss

receiptNum

str

접수번호

requestNum

str

요청번호

interOPRefKey

str

파트너 지정키

카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값

item

KakaoItem[ ]

아이템 목록

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	30	타이틀
imageUrl	str	500	이미지 URL
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

commerce

KakaoCommerce

커머스 정보

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	30	상품명
regularPrice	int	-	정상가격 0 ~ 99,999,999
discountType	str	-	할인유형 R할인율 F할인금액
discountPrice	int	-	할인가격 0 ~ 99,999,999
discount	int	-	할인율/할인금액 {discountType}="R" 경우 0 ~ 100 {discountType}="F" 경우 0 ~ 999,999

head

KakaoCarouselHead

캐러셀 인트로

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
header	str	20	제목
content	str	50	내용
imageUrl	str	500	이미지 URL
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

carousel

KakaoCarousel[ ]

캐러셀 목록

브랜드 메시지 전송 시 반환

순번

변수명

타입

길이

설명

header

str

제목

content

str

180

내용

imageUrl

str

500

이미지 URL

imageLink

str

500

이미지 링크 URL

이미지를 클릭하면 연결되는 URL

addContent

str

부가메시지

commerce

KakaoCommerce

커머스 정보

변수명	타입	길이	설명
title	str	30	상품명
regularPrice	int	-	정상가격 0 ~ 99,999,999
discountType	str	-	할인유형 R할인율 F할인금액
discountPrice	int	-	할인가격 0 ~ 99,999,999
discount	int	-	할인율/할인금액 {discountType}="R" 경우 0 ~ 100 {discountType}="F" 경우 0 ~ 999,999

btns

KakaoButton[ ]

버튼 목록

변수명	타입	길이	설명
n	str	8	버튼명
t	str	2	버튼유형 WL웹링크 AL앱링크 MD메시지전달 BK봇키워드 AC채널추가
u1	str	1,000	버튼링크 - {t} = "AL" 경우 iOS 앱링크 적용 - {t} = "WL" 경우 Mobile 웹링크 적용
u2	str	1,000	버튼링크 - {t} = "AL" 경우 Android 앱링크 적용 - {t} = "WL" 경우 PC 웹링크 적용

coupon

KakaoCoupon

쿠폰

변수명	타입	길이	설명
title	str	15	쿠폰 제목 #{숫자}원 할인 쿠폰(숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰(숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰
description	str	12	쿠폰 설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

tail

KakaoCarouselTail

캐러셀 더보기

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

btns

KakaoButton[ ]

버튼 목록

변수명	타입	길이	설명
n	str	14	버튼명
t	str	2	버튼유형 WL웹링크 AL앱링크 TN전화걸기 - 알림톡 전용 DS배송조회 - 알림톡 전용 MD메시지전달 BK봇키워드 AC채널추가
u1	str	1,000	버튼링크 - {t} = "AL" 경우 iOS 앱링크 적용 - {t} = "WL" 경우 Mobile 웹링크 적용
u2	str	1,000	버튼링크 - {t} = "AL" 경우 Android 앱링크 적용 - {t} = "WL" 경우 PC 웹링크 적용
tg	str	3	아웃 링크 out디바이스 기본 브라우저 공백(기본값) : 카카오톡 인앱 브라우저 사용
telNum	str	14	전화번호 {t} = "TN" 경우 반환

coupon

KakaoCoupon

쿠폰

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	15	쿠폰 제목 #{숫자}원 할인 쿠폰(숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰(숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰
description	str	12	쿠폰 설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

contentVariable

dict

브랜드 메시지 내용 변수

브랜드 메시지 전송 시 반환

buttonVariable

dict

브랜드 메시지 버튼 변수

브랜드 메시지 전송 시 반환

couponVariable

dict

브랜드 메시지 쿠폰 변수

브랜드 메시지 전송 시 반환

commerceVariable

dict

브랜드 메시지 커머스 변수

브랜드 메시지 전송 시 반환

carouselVariable

KakaoCarouselVariable[ ]

브랜드 메시지 캐러셀 변수

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
contentVariable	dict	-	브랜드 메시지 캐러셀 내용 변수
buttonVariable	dict	-	브랜드 메시지 캐러셀 버튼 변수
couponVariable	dict	-	브랜드 메시지 캐러셀 쿠폰 변수
commerceVariable	dict	-	브랜드 메시지 캐러셀 커머스 변수

예외

PopbillException

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

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

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

def search(corpNum, sDate, eDate, state, item, reserveYN, SenderYN, page, perpage, order, userID, Qstring, plusFriendID):

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

요청

Parameters

변수명	타입	길이	필수	설명
corpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
sDate	str	8	Y	검색 시작일자 형식 : yyyyMMdd
eDate	str	8	Y	검색 종료일자 형식 : yyyyMMdd
state	list		Y	전송상태 (다중 선택 가능) 0전송대기 1전송중 2전송성공 3대체문자 전송성공 4전송실패 5예약취소
item	list		N	검색대상 ATS알림톡 기본값 : 전체조회
reserveYN	str	1	N	전송유형별 조회 (택 1) 0즉시전송건 1예약전송건 기본값 : 전체조회
SenderYN	bool	-	N	사용자권한별 조회 True팝빌회원 아이디(userID)로 전송한 카카오톡만 조회 False전송한 카카오톡 전체 조회 : 기본값
page	int	-	N	목록 페이지번호 기본값 : 1
perpage	int	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
order	str	1	N	카카오톡 접수일시를 기준으로 하는 목록 정렬 방향 D내림차순 : 기본값 A오름차순
userID	str	50	N	팝빌회원 아이디
Qstring	str	70	N	조회 검색어(수신자명, 수신번호) 기본값 : 전체조회
plusFriendID	str	30	N	검색용 아이디

응답

KakaoSearchResult

순번

변수명

타입

길이

설명

code

int

API 처리에 대한 응답코드

1성공

message

str

API 처리에 대한 응답메시지

total

str

총 검색결과 건수

perPage

str

페이지 당 목록 건수

pageNum

str

페이지 번호

pageCount

str

페이지 개수

list

KakaoSentDetail[ ]

1,000

전송결과 정보

순번

변수명

타입

길이

설명

state

int

상태코드

[참고] 팝빌 상태코드

sendDT

str

전송일시

형식 : yyyyMMddHHmmss

result

int

카카오 결과코드

{state} = 3 경우 카카오톡 전송결과 확인 가능

[참고] 카카오 결과코드(카카오톡)

resultDT

str

전송결과 수신일시

형식 : yyyyMMddHHmmss

contentType

int

카카오톡 유형

1알림톡

4알림톡 이미지

5알림톡 강조표기

6브랜드 메시지 텍스트

7브랜드 메시지 이미지

8브랜드 메시지 와이드

9브랜드 메시지 리스트

10브랜드 메시지 캐러셀

12브랜드 메시지 커머스

13브랜드 메시지 캐러셀 커머스

receiveNum

str

수신번호

receiveName

str

수신자명

emphasizeTitle

str

강조표기 타이틀

알림톡 강조표기형 전송 시 반환

adultYN

bool

성인용 메시지 여부

브랜드 메시지 전송 시 반환

header

str

제목

브랜드 메시지 전송 시 반환

content

str

1,300

카카오톡 내용

addContent

str

부가메시지

브랜드 메시지 전송 시 반환

imageUrl

str

500

이미지 URL

브랜드 메시지 전송 시 반환

imageLink

str

500

이미지 링크 URL

브랜드 메시지 전송 시 반환

altSubject

str

대체문자 제목

단위 : byte

altContent

str

2,000

대체문자 내용

단위 : byte

altContentType

int

대체문자 전송타입

4단문

6장문

altSendDT

str

대체문자 전송일시

형식 : yyyyMMddHHmmss

altResult

int

대체문자 통신사 결과코드

[참고] 통신사 결과코드(대체문자)

altResultDT

str

대체문자 전송결과 수신일시

형식 : yyyyMMddHHmmss

reserveDT

str

예약일시

형식 : yyyyMMddHHmmss

receiptNum

str

접수번호

requestNum

str

요청번호

interOPRefKey

str

파트너 지정키

카카오톡 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값

item

KakaoItem[ ]

아이템 목록

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	30	타이틀
imageUrl	str	500	이미지 URL
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

commerce

KakaoCommerce

커머스 정보

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	30	상품명
regularPrice	int	-	정상가격 0 ~ 99,999,999
discountType	str	-	할인유형 R할인율 F할인금액
discountPrice	int	-	할인가격 0 ~ 99,999,999
discount	int	-	할인율/할인금액 {discountType}="R" 경우 0 ~ 100 {discountType}="F" 경우 0 ~ 999,999

head

KakaoCarouselHead

캐러셀 인트로

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
header	str	20	제목
content	str	50	내용
imageUrl	str	500	이미지 URL
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

carousel

KakaoCarousel[ ]

캐러셀 목록

브랜드 메시지 전송 시 반환

순번

변수명

타입

길이

설명

header

str

제목

content

str

180

내용

imageUrl

str

500

이미지 URL

imageLink

str

500

이미지 링크 URL

이미지를 클릭하면 연결되는 URL

addContent

str

부가메시지

commerce

KakaoCommerce

커머스 정보

변수명	타입	길이	설명
title	str	30	상품명
regularPrice	int	-	정상가격 0 ~ 99,999,999
discountType	str	-	할인유형 R할인율 F할인금액
discountPrice	int	-	할인가격 0 ~ 99,999,999
discount	int	-	할인율/할인금액 {discountType}="R" 경우 0 ~ 100 {discountType}="F" 경우 0 ~ 999,999

btns

KakaoButton[ ]

버튼 목록

변수명	타입	길이	설명
n	str	8	버튼명
t	str	2	버튼유형 WL웹링크 AL앱링크 MD메시지전달 BK봇키워드 AC채널추가
u1	str	1,000	버튼링크 - {t} = "AL" 경우 iOS 앱링크 적용 - {t} = "WL" 경우 Mobile 웹링크 적용
u2	str	1,000	버튼링크 - {t} = "AL" 경우 Android 앱링크 적용 - {t} = "WL" 경우 PC 웹링크 적용

coupon

KakaoCoupon

쿠폰

변수명	타입	길이	설명
title	str	15	쿠폰 제목 #{숫자}원 할인 쿠폰(숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰(숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰
description	str	12	쿠폰 설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

tail

KakaoCarouselTail

캐러셀 더보기

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

btns

KakaoButton[ ]

버튼 목록

변수명	타입	길이	설명
n	str	14	버튼명
t	str	2	버튼유형 WL웹링크 AL앱링크 TN전화걸기 - 알림톡 전용 DS배송조회 - 알림톡 전용 MD메시지전달 BK봇키워드 AC채널추가
u1	str	1,000	버튼링크 - {t} = "AL" 경우 iOS 앱링크 적용 - {t} = "WL" 경우 Mobile 웹링크 적용
u2	str	1,000	버튼링크 - {t} = "AL" 경우 Android 앱링크 적용 - {t} = "WL" 경우 PC 웹링크 적용
tg	str	3	아웃 링크 out디바이스 기본 브라우저 공백(기본값) : 카카오톡 인앱 브라우저 사용
telNum	str	14	전화번호 {t} = "TN" 경우 반환

coupon

KakaoCoupon

쿠폰

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
title	str	15	쿠폰 제목 #{숫자}원 할인 쿠폰(숫자 : 1~99,999,999) #{숫자}% 할인 쿠폰(숫자 : 1~100) 배송비 할인 쿠폰 #{7자 이내} 무료 쿠폰 #{7자 이내} UP 쿠폰
description	str	12	쿠폰 설명
linkMobile	str	1,000	Mobile 웹링크
linkPc	str	1,000	PC 웹링크
linkAndroid	str	1,000	Android 앱링크
linkIos	str	1,000	iOS 앱링크

contentVariable

dict

브랜드 메시지 내용 변수

브랜드 메시지 전송 시 반환

buttonVariable

dict

브랜드 메시지 버튼 변수

브랜드 메시지 전송 시 반환

couponVariable

dict

브랜드 메시지 쿠폰 변수

브랜드 메시지 전송 시 반환

commerceVariable

dict

브랜드 메시지 커머스 변수

브랜드 메시지 전송 시 반환

carouselVariable

KakaoCarouselVariable[ ]

브랜드 메시지 캐러셀 변수

브랜드 메시지 전송 시 반환

변수명	타입	길이	설명
contentVariable	dict	-	브랜드 메시지 캐러셀 내용 변수
buttonVariable	dict	-	브랜드 메시지 캐러셀 버튼 변수
couponVariable	dict	-	브랜드 메시지 캐러셀 쿠폰 변수
commerceVariable	dict	-	브랜드 메시지 캐러셀 커머스 변수

예외

PopbillException

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

def getSentListURL(corpNum, userID):

요청

Parameters

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

응답

str - 요청에 대한 응답 URL

예외

PopbillException