브랜드 메시지 템플릿

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

템플릿 코드

templateType

string

템플릿 유형

BMST브랜드 메시지 텍스트

BMSI브랜드 메시지 이미지

BMSW브랜드 메시지 와이드

BMSL브랜드 메시지 리스트

BMSC브랜드 메시지 캐러셀

BMSP브랜드 메시지 동영상

BMSM브랜드 메시지 커머스

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

templateName

string

200

템플릿 제목

content

string

1,300

템플릿 내용

plusFriendID

string

검색용 아이디

adultYN

boolean

성인용 메시지 여부

header

string

헤더

addContent

string

부가정보

imageUrl

string

500

이미지 URL

imageLink

string

500

이미지 링크 URL

videoUrl

string

500

카카오 TV 동영상 URL

thumbnailUrl

string

500

동영상 썸네일 URL

state

number

템플릿 상태

1사용
2삭제
3차단

stateDT

string

템플릿 상태 일시

형식 : 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 앱링크

carousel

array

캐러셀 목록

순번

변수명

타입

길이

설명

header

string

헤더

content

string

180

내용

addContent

string

부가정보

imageUrl

string

500

이미지 URL

imageLink

string

500

이미지 링크 URL

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

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 앱링크

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

템플릿 코드

templateType

string

템플릿 유형

BMST브랜드 메시지 텍스트

BMSI브랜드 메시지 이미지

BMSW브랜드 메시지 와이드

BMSL브랜드 메시지 리스트

BMSC브랜드 메시지 캐러셀

BMSP브랜드 메시지 동영상

BMSM브랜드 메시지 커머스

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

templateName

string

200

템플릿 제목

content

string

1,300

템플릿 내용

plusFriendID

string

검색용 아이디

adultYN

boolean

성인용 메시지 여부

header

string

헤더

addContent

string

부가정보

imageUrl

string

500

이미지 URL

imageLink

string

500

이미지 링크 URL

videoUrl

string

500

카카오 TV 동영상 URL

thumbnailUrl

string

500

동영상 썸네일 URL

state

number

템플릿 상태

1사용
2삭제
3차단

stateDT

string

템플릿 상태 일시

형식 : 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 앱링크

carousel

array

캐러셀 목록

순번

변수명

타입

길이

설명

header

string

헤더

content

string

180

내용

addContent

string

부가정보

imageUrl

string

500

이미지 URL

imageLink

string

500

이미지 링크 URL

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

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 앱링크

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": "테스트"
    }
]