알림톡 템플릿

1. GetATSTemplateMgtURL - 알림톡 템플릿 등록 팝업 URL

미리보기

알림톡 템플릿을 등록하는 팝업 URL을 반환합니다.

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

String getATSTemplateMgtURL(String CorpNum, String UserID) throws PopbillException

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	UserID	String	50	N	팝빌회원 아이디

응답

String - 요청에 대한 응답 URL

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

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

알림톡 템플릿 정보를 확인합니다.

ATSTemplate getATSTemplate(String CorpNum, String TemplateCode, String UserID) throws PopbillException

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	TemplateCode	String	12	Y	템플릿 코드
3	UserID	String	50	N	팝빌회원 아이디

응답

ATSTemplate

순번	변수명	타입	길이	설명
1	templateCode	String	12	템플릿 코드
2	templateName	String	20	템플릿 제목
3	template	String	1,300	템플릿 내용
4	emphasizeTitle	String	50	강조표기 타이틀
5	emphasizeSubtitle	String	50	강조표기 보조 문구
6	plusFriendID	String	30	검색용 아이디
7	ads	String	80	광고 메시지
8	appendix	String	500	부가 메시지
9	secureYN	Boolean	-	보안템플릿 여부 true 보안템플릿 false 일반템플릿
10	state	String	1	템플릿 상태 0 임시저장 2 심사중 3 승인 4 반려 5 정지 7 휴면 8 삭제
11	stateDT	String	14	템플릿 상태 일시 → 형식 : yyyyMMddHHmmss
12	btns	List<KakaoButton>	5	버튼 목록
List<KakaoButton> 순번 변수명 타입 길이 설명 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 전화걸기 번호

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

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

“승인” 상태의 알림톡 템플릿 목록을 확인합니다.

ATSTemplate[] listATSTemplate(String CorpNum, String UserID) throws PopbillException

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	UserID	String	50	N	팝빌회원 아이디

응답

ATSTemplate[ ]

순번	변수명	타입	길이	설명
1	templateCode	String	12	템플릿 코드
2	templateName	String	20	템플릿 제목
3	template	String	1,300	템플릿 내용
4	emphasizeTitle	String	50	강조표기 타이틀
5	emphasizeSubtitle	String	50	강조표기 보조 문구
6	plusFriendID	String	30	검색용 아이디
7	ads	String	80	광고 메시지
8	appendix	String	500	부가 메시지
9	secureYN	Boolean	-	보안템플릿 여부 true 보안템플릿 false 일반템플릿
10	state	String	1	템플릿 상태 0 임시저장 2 심사중 3 승인 4 반려 5 정지 7 휴면 8 삭제
11	stateDT	String	14	템플릿 상태 일시 → 형식 : yyyyMMddHHmmss
12	btns	List<KakaoButton>	5	버튼 목록
List<KakaoButton> 순번 변수명 타입 길이 설명 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 전화걸기 번호

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지