템플릿 관리

1. GetATSTemplateMgtURL - 알림톡 템플릿 등록 팝업 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	고정값 : TEMPLATE

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
	url	string	-	알림톡 템플릿 등록 팝업 URL

응답 예시

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

2. GetATSTemplate - 알림톡 템플릿 정보 확인

GET https://popbill-test.linkhub.co.kr/KakaoTalk/GetATSTemplate/{templateCode}

GET https://popbill.linkhub.co.kr/KakaoTalk/GetATSTemplate/{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/GetATSTemplate/{templateCode}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번

변수명

타입

길이

설명

templateCode

string

템플릿 코드

templateName

string

템플릿 제목

emphasizeTitle

string

강조표기 타이틀

emphasizeSubtitle

string

강조표기 보조 문구

template

string

1000

템플릿 내용

plusFriendID

string

검색용 아이디

ads

string

광고 메시지

appendix

string

500

부가 메시지

secureYN

boolean

보안템플릿 여부

true보안템플릿

false일반템플릿

state

string

템플릿 상태

0임시저장
2심사중
3승인
4반려
5정지
7휴면
8삭제

stateDT

string

템플릿 상태 일시

형식 : yyyyMMddHHmmss

btns

array

버튼 목록

최대 : 5개

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

응답 예시

{
    "templateCode": "025100000033",
    "templateName": "템플릿 테스트_1014",
    "emphasizeTitle": "",
    "emphasizeSubtitle": ""
    "template": "테스트 메일을 작성합니다. #{변수}}",
    "plusFriendID": "@팝빌",
    "secureYN": false,
    "state": "2",
    "stateDT": "20251014115508",
    "btns": [],
}

3. ListATSTemplate - 알림톡 템플릿 목록 확인

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

GET https://popbill.linkhub.co.kr/KakaoTalk/ListATSTemplate

승인된 알림톡 템플릿 목록을 확인합니다.

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/ListATSTemplate' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번

변수명

타입

길이

설명

templateCode

string

템플릿 코드

templateName

string

템플릿 제목

emphasizeTitle

string

강조표기 타이틀

emphasizeSubtitle

string

강조표기 보조 문구

template

string

1000

템플릿 내용

plusFriendID

string

검색용 아이디

ads

string

광고 메시지

appendix

string

500

부가 메시지

secureYN

boolean

보안템플릿 여부

true보안템플릿

false일반템플릿

state

string

템플릿 상태

0임시저장
2심사중
3승인
4반려
5정지
7휴면
8삭제

stateDT

string

템플릿 상태 일시

형식 : yyyyMMddHHmmss

btns

array

버튼 목록

최대 : 5개

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

응답 예시

[
    {
        "templateCode": "025100000634",
        "templateName": "10월 배포테스트 템플릿 신청",
        "template": "테스트",
        "plusFriendID": "@팝빌",
        "btns": [],
        "secureYN": true,
        "state": "3",
        "stateDT": "20251022123400",
        "emphasizeTitle": "테스트",
        "emphasizeSubtitle": "테스트"
    }
]