POPBill Developers
연동신청
  • 가이드 0
  • 레퍼런스 0
  • 오류코드 0
카카오톡
  • 전자세금계산서
  • 현금영수증
  • 전자명세서
  • 홈택스수집(세금)
  • 홈택스수집(현금)
  • 사업자등록상태조회
  • 기업정보조회
  • 계좌조회
  • 예금주조회
  • 카카오톡
  • 문자
  • 팩스
API 레퍼런스

브랜드 메시지 템플릿

1. GetBMSTemplateMgtURL - 브랜드 메시지 템플릿 등록 팝업 URL

GET https://popbill-test.linkhub.co.kr/KakaoTalk
GET https://popbill.linkhub.co.kr/KakaoTalk
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : BMS_TEMPLATE
요청 예시
curl --request GET \
  --url 'https://{domain}/KakaoTalk?TG=BMS_TEMPLATE' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 브랜드 메시지 템플릿 등록 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=IRXSGITDREOTPOIRLPUHCB4BSBC4...NX7BMAR3="
}

2. GetBMSTemplate - 브랜드 메시지 템플릿 정보 확인

GET https://popbill-test.linkhub.co.kr/KakaoTalk/BMSTemplate/{templateCode}
GET https://popbill.linkhub.co.kr/KakaoTalk/BMSTemplate/{templateCode}
  • 브랜드 메시지 템플릿 정보를 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
templateCode string 12 Y 브랜드 메시지 템플릿 코드
요청 예시
curl --request GET \
  --url 'https://{domain}/KakaoTalk/BMSTemplate/{templateCode}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
templateCode string 12 템플릿 코드
templateType string 4 템플릿 유형
BMST브랜드 메시지 텍스트
BMSI브랜드 메시지 이미지
BMSW브랜드 메시지 와이드
BMSL브랜드 메시지 리스트
BMSC브랜드 메시지 캐러셀
BMSP브랜드 메시지 동영상
BMSM브랜드 메시지 커머스
BMSA브랜드 메시지 캐러셀 커머스
templateName string 200 템플릿 제목
content string 1,300 템플릿 내용
plusFriendID string 30 검색용 아이디
adultYN boolean - 성인용 메시지 여부
header string 20 헤더
addContent string 34 부가정보
imageUrl string 500 이미지 URL
videoUrl string 500 카카오 TV 동영상 URL
thumbnailUrl string 500 동영상 썸네일 URL
state number - 템플릿 상태
  • 1사용
  • 2삭제
  • 3차단
stateDT string 14 템플릿 상태 일시
형식 : yyyyMMddHHmmss
item array - 아이템 리스트 목록
순번 변수명 타입 길이 설명
title string 30 제목
imageUrl string 500 이미지 URL
linkMobile string 1,000 Mobile 웹링크
linkPc string 1,000 PC 웹링크
linkAndroid string 1,000 Android 앱링크
linkIos string 1,000 iOS 앱링크
commerce object - 커머스 정보
순번 변수명 타입 길이 설명
title string 30 상품명
regularPrice number - 정상가격
0 ~ 99,999,999
discountPrice number - 할인가격
0 ~ 99,999,999
discountRate number - 할인율
0 ~ 100
discountFixed number - 할인금액
0 ~ 999,999
head object - 캐러셀 인트로
순번 변수명 타입 길이 설명
header string 20 제목
content string 50 내용
imageUrl string 500 이미지 URL
linkMobile string 1,000 Mobile 웹링크
linkPc string 1,000 PC 웹링크
linkAndroid string 1,000 Android 앱링크
linkIos string 1,000 iOS 앱링크
순번 변수명 타입 길이 설명
순번 변수명 타입 길이 설명
순번 변수명 타입 길이 설명
순번 변수명 타입 길이 설명
tail object - 캐러셀 더보기
순번 변수명 타입 길이 설명
linkMobile string 1,000 Mobile 웹링크
linkPc string 1,000 PC 웹링크
linkAndroid string 1,000 Android 앱링크
linkIos string 1,000 iOS 앱링크
btns array - 버튼 목록
순번 변수명 타입 길이 설명
n string 14 버튼명
t string 2 버튼유형
  • WL웹링크
  • AL앱링크
  • MD메시지전달
  • BK봇키워드
  • AC채널추가
u1 string 1,000 버튼링크
- {t} = "AL" 경우 iOS 앱링크 적용
- {t} = "WL" 경우 Mobile 웹링크 적용
u2 string 1,000 버튼링크
- {t} = "AL" 경우 Android 앱링크 적용
- {t} = "WL" 경우 PC 웹링크 적용
coupon object - 쿠폰 강조
순번 변수명 타입 길이 설명
title string 15 쿠폰 제목
#{숫자}원 할인 쿠폰(숫자 : 1~99,999,999)
#{숫자}% 할인 쿠폰(숫자 : 1~100)
배송비 할인 쿠폰
#{7자 이내} 무료 쿠폰
#{7자 이내} UP 쿠폰
description string 12 쿠폰 설명
linkMobile string 1,000 Mobile 웹링크
linkPc string 1,000 PC 웹링크
linkAndroid string 1,000 Android 앱링크
linkIos string 1,000 iOS 앱링크
응답 예시
{
    "templateCode": "025100000033",
    "templateName": "템플릿 테스트_1014",
    "emphasizeTitle": "",
    "emphasizeSubtitle": ""
    "template": "테스트 메일을 작성합니다. #{변수}}",
    "plusFriendID": "@팝빌",
    "secureYN": false,
    "state": "2",
    "stateDT": "20251014115508",
    "btns": [],
}

3. ListBMSTemplate - 브랜드 메시지 템플릿 목록 확인

GET https://popbill-test.linkhub.co.kr/KakaoTalk/BMSTemplates
GET https://popbill.linkhub.co.kr/KakaoTalk/BMSTemplates
  • 승인된 브랜드 메시지 템플릿 목록을 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 예시
curl --request GET \
  --url 'https://{domain}/KakaoTalk/BMSTemplates' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
templateCode string 12 템플릿 코드
templateType string 4 템플릿 유형
BMST브랜드 메시지 텍스트
BMSI브랜드 메시지 이미지
BMSW브랜드 메시지 와이드
BMSL브랜드 메시지 리스트
BMSC브랜드 메시지 캐러셀
BMSP브랜드 메시지 동영상
BMSM브랜드 메시지 커머스
BMSA브랜드 메시지 캐러셀 커머스
templateName string 200 템플릿 제목
content string 1,300 템플릿 내용
plusFriendID string 30 검색용 아이디
adultYN boolean - 성인용 메시지 여부
header string 20 헤더
addContent string 34 부가정보
imageUrl string 500 이미지 URL
videoUrl string 500 카카오 TV 동영상 URL
thumbnailUrl string 500 동영상 썸네일 URL
state number - 템플릿 상태
  • 1사용
  • 2삭제
  • 3차단
stateDT string 14 템플릿 상태 일시
형식 : yyyyMMddHHmmss
item array - 아이템 리스트 목록
순번 변수명 타입 길이 설명
title string 30 제목
imageUrl string 500 이미지 URL
linkMobile string 1,000 Mobile 웹링크
linkPc string 1,000 PC 웹링크
linkAndroid string 1,000 Android 앱링크
linkIos string 1,000 iOS 앱링크
commerce object - 커머스 정보
순번 변수명 타입 길이 설명
title string 30 상품명
regularPrice number - 정상가격
0 ~ 99,999,999
discountPrice number - 할인가격
0 ~ 99,999,999
discountRate number - 할인율
0 ~ 100
discountFixed number - 할인금액
0 ~ 999,999
head object - 캐러셀 인트로
순번 변수명 타입 길이 설명
header string 20 제목
content string 50 내용
imageUrl string 500 이미지 URL
linkMobile string 1,000 Mobile 웹링크
linkPc string 1,000 PC 웹링크
linkAndroid string 1,000 Android 앱링크
linkIos string 1,000 iOS 앱링크
순번 변수명 타입 길이 설명
순번 변수명 타입 길이 설명
순번 변수명 타입 길이 설명
순번 변수명 타입 길이 설명
tail object - 캐러셀 더보기
순번 변수명 타입 길이 설명
linkMobile string 1,000 Mobile 웹링크
linkPc string 1,000 PC 웹링크
linkAndroid string 1,000 Android 앱링크
linkIos string 1,000 iOS 앱링크
btns array - 버튼 목록
순번 변수명 타입 길이 설명
n string 14 버튼명
t string 2 버튼유형
  • WL웹링크
  • AL앱링크
  • MD메시지전달
  • BK봇키워드
  • AC채널추가
u1 string 1,000 버튼링크
- {t} = "AL" 경우 iOS 앱링크 적용
- {t} = "WL" 경우 Mobile 웹링크 적용
u2 string 1,000 버튼링크
- {t} = "AL" 경우 Android 앱링크 적용
- {t} = "WL" 경우 PC 웹링크 적용
coupon object - 쿠폰 강조
순번 변수명 타입 길이 설명
title string 15 쿠폰 제목
#{숫자}원 할인 쿠폰(숫자 : 1~99,999,999)
#{숫자}% 할인 쿠폰(숫자 : 1~100)
배송비 할인 쿠폰
#{7자 이내} 무료 쿠폰
#{7자 이내} UP 쿠폰
description string 12 쿠폰 설명
linkMobile string 1,000 Mobile 웹링크
linkPc string 1,000 PC 웹링크
linkAndroid string 1,000 Android 앱링크
linkIos string 1,000 iOS 앱링크
응답 예시
[
    {
        "templateCode": "025100000634",
        "templateName": "10월 배포테스트 템플릿 신청",
        "template": "테스트",
        "plusFriendID": "@팝빌",
        "btns": [],
        "secureYN": true,
        "state": "3",
        "stateDT": "20251022123400",
        "emphasizeTitle": "테스트",
        "emphasizeSubtitle": "테스트"
    }
]