# 템플릿 가이드 팝빌 카카오톡 이용을 위한 템플릿 신청에 대하여 안내하는 문서입니다. ## 알림톡 팝빌로 카카오톡 채널 등록이 완료되면 알림톡 템플릿을 신청합니다. 알림톡은 반드시 카카오의 승인을 받은 템플릿으로만 전송이 가능합니다. 템플릿 심사는 카카오에서 직접 처리하며 영업일 기준 최대 3일 소요됩니다. - **사이트 >** 팝빌 사이트 () 접속 > 카카오톡 > 전송준비 > 알림톡 템플릿 - **API >** [\[GetATSTemplateMgtURL - 알림톡 템플릿 등록 팝업 URL\]](https://developers.popbill.com/api-reference/kakaotalk/api/template#GetATSTemplateMgtURL) API 호출 ![팝빌 카카오톡 알림톡 템플릿 등록 화면](https://developers.popbill.com/images/guide/introduction/kakaotalk/ats-template-guide.webp) | 번호 | 구분 | 설명 | | :-: | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ➊ | 검색용 아이디 | 템플릿을 등록할 카카오톡 채널 아이디입니다. | | ➋ | 카테고리 | 알림톡의 활용 카테고리를 설정하는 기능입니다. | | ➌ | 템플릿명 | 템플릿을 구별하기 위하여 사용하는 이름으로, 중복된 템플릿명 이용은 불가합니다. | | ➍ | 유형 | 텍스트, 강조표기, 이미지 중 원하는 템플릿 유형을 선택합니다. | | ➎ | 보안템플릿 | 개인정보 등 보안에 유의가 필요한 메시지를 모바일 외 다른 디바이스에서 노출되지 않도록 설정합니다. | | ➏ | 내용 | 전송할 템플릿 내용을 작성합니다. 수신자마다 다르게 작성이 필요한 정보는 변수를 사용합니다. | | ➐ | 부가메시지 | \[최대 500자, 변수 사용불가] 문의 연락처, 이용 안내 등 보조적인 정보성 메시지 내용을 작성합니다. | | ➑ | 광고메시지 | \[최대 80자, 변수/URL 사용불가] 채널추가 메시지 내용을 작성합니다. | | ➒ | 버튼 | 메시지 하단에 버튼을 추가하여 고객 행동을 유도할 수 있습니다. └ 배송조회 : 메시지에 기재된 택배사명과 송장번호를 이용하여 택배사의 배송조회 링크를 자동으로 생성합니다. └ 앱/웹링크 : 작성 링크로 앱을 실행하거나 웹 페이지로 이동합니다. 변수를 사용하여 수신자마다 다른 링크로 연결할 수 있습니다. └ 봇키워드 : 버튼명이 카카오톡 메시지로 전송되어 상담원과 채팅을 진행할 수 있습니다. └ 메시지전달 : 버튼명과 메시지 내용이 카카오톡 메시지로 전송되어 상담원과 채팅을 진행할 수 있습니다. └ 전화걸기 : 버튼을 클릭하면 등록된 전화번호로 연결되어 상담원과 통화를 진행할 수 있습니다. └ 채널추가 : 카카오톡 채널 추가를 유도하는 버튼으로 ‘광고메시지’를 사용하는 경우에만 추가 가능합니다. | ### 변수 작성가이드 | 구분 | 설명 | | ------ | --------------------------------------------------------------------------------------------------------------- | | 작성방법 | #{변수명 입력} 올바른 예시> #{고객사명}, #{주문번호} 잘못된 예시> #(상품명), \[이름] | | 버튼 URL | 도메인을 고정으로 포함하여 변수를 작성합니다. 올바른 예시> https\://www\.popbill.com/#\\{고객번호} 잘못된 예시> https\://#{링크} | | 최대 글자수 | 최대 글자수는 치환된 변수 메시지를 포함하므로 변수의 최대 글자 길이를 고려하여 내용을 작성해야 합니다. 치환된 변수 메시지로 최대 글자수를 초과하는 경우 템플릿 내용 불일치 사유로 전송실패 됩니다. | ## 브랜드 메시지 팝빌로 카카오톡 채널 등록이 완료되면 브랜드 메시지 템플릿을 신청할 수 있습니다. 브랜드 메시지는 알림톡과 달리 템플릿 신청이 필수사항이 아니며, 카카오의 사전 심사없이 등록 즉시 전송이 가능합니다. - **사이트 >** 팝빌 사이트 () 접속 > 카카오톡 > 전송준비 > 브랜드 메시지 템플릿 - **API >** [\[GetBMSTemplateMgtURL - 브랜드 메시지 템플릿 관리 팝업 URL\]](https://developers.popbill.com/api-reference/kakaotalk/api/bms-template#GetBMSTemplateMgtURL) API 호출 > **브랜드 메시지 템플릿을 등록하는 이유** > > - 반복 전송이 많은 메시지는 템플릿 등록으로 운영 효율을 상승 시킬 수 있습니다. > - 템플릿 등록으로 오탈자나 문구 누락 등 인적 실수를 감소 시킬 수 있습니다. > - 부여되는 템플릿코드로 템플릿별 전송결과 및 사용내역 관리가 가능합니다. ![팝빌 카카오톡 브랜드 메시지 템플릿 등록 화면](https://developers.popbill.com/images/guide/introduction/kakaotalk/bms-template-guide.webp) | 번호 | 구분 | 설명 | | :-: | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ➊ | 검색용 아이디 | 템플릿을 등록할 카카오톡 채널 아이디입니다. | | ➋ | 템플릿명 | 템플릿을 구별하기 위하여 사용하는 이름으로, 중복된 템플릿명 이용은 불가합니다. | | ➌ | 유형 | 텍스트, 이미지, 와이드, 리스트, 캐러셀, 캐러셀커머스, 커머스 중 원하는 템플릿 유형을 선택합니다. | | ➍ | 연령인증 | 청소년보호조치 필요 업종 및 콘텐츠를 포함한 메시지는 본인인증을 거친 성인만 확인할 수 있도록 설정합니다. | | ➎ | 내용 | 전송할 템플릿 내용을 작성합니다. 수신자마다 다르게 작성이 필요한 정보는 변수를 사용합니다. | | ➏ | 버튼 | 메시지 하단에 버튼을 추가하여 고객 행동을 유도할 수 있습니다. └ 앱/웹링크 : 작성 링크로 앱을 실행하거나 웹 화면으로 이동합니다. 변수를 사용하여 수신자마다 다른 링크로 연결할 수 있습니다. └ 봇키워드 : 버튼명이 카카오톡 메시지로 전송되어 상담원과 채팅을 진행할 수 있습니다. └ 메시지전달 : 버튼명과 메시지 내용이 카카오톡 메시지로 전송되어 상담원과 채팅을 진행할 수 있습니다. └ 채널추가 : 카카오톡 채널 추가를 유도하는 버튼으로 채널친구가 아닌 수신자를 대상에게만 노출할 수 있습니다. | | ➐ | 쿠폰 | 할인ㆍ프로모션ㆍ혜택 제공과 같이 쿠폰 사용을 인지시키고, 고객의 참여를 유도할 수 있습니다. | ### 쿠폰 사용방법 쿠폰은 \[카카오비즈니스 파트너센터]에서 쿠폰을 직접 발급하고 관리하는 “채널쿠폰”과 고객사가 직접 운영하는 웹사이트 또는 앱으로 연결하여 쿠폰을 발급하고 관리할 수 있는 “외부쿠폰”이 있습니다. **채널쿠폰** 온라인이나 오프라인 매장에서 사용할 수 있는 다양한 유형의 쿠폰을 [\[카카오비즈니스 파트너센터\]](https://business.kakao.com) 에서 직접 발급ㆍ관리하여 브랜드 메시지 수신자에게 쿠폰을 전달할 수 있습니다. ![브랜드메시지 채널쿠폰 예시 이미지](https://developers.popbill.com/images/guide/introduction/kakaotalk/bms-channel-coupon1.webp) 1. \[카카오비즈니스 파트너센터 > 소식ㆍ쿠폰 > 쿠폰 만들기] 메뉴에서 쿠폰을 발급합니다. ![카카오비즈니스 파트너센터에서 쿠폰을 생성합니다.](https://developers.popbill.com/images/guide/introduction/kakaotalk/bms-channel-coupon2.webp) 2. \[카카오비즈니스 파트너센터 > 소식ㆍ쿠폰 > 내 쿠폰 > 쿠폰 상세]에서 발급한 쿠폰의 브랜드 메시지 URL을 복사합니다. ![카카오비즈니스 파트너센터에서 생성한 쿠폰의 브랜드 메시지 URL을 복사합니다.](https://developers.popbill.com/images/guide/introduction/kakaotalk/bms-channel-coupon3.webp) 3. 카카오비즈니스 파트너센터에서 발급한 쿠폰 정보를 입력하고 쿠폰을 추가합니다. ![카카오비즈니스 파트너센터에서 복사한 브랜드 메시지 URL을 쿠폰 정보에 입력하여 쿠폰을 추가합니다.](https://developers.popbill.com/images/guide/introduction/kakaotalk/bms-channel-coupon4.webp) **외부쿠폰** 고객사가 직접 운영하는 웹사이트 또는 앱으로 연결하여 수신자가 쿠폰을 직접 발급받거나 코드 입력을 통해 쿠폰 혜택을 받을 수 있습니다. ![브랜드메시지 외부쿠폰 예시 이미지](https://developers.popbill.com/images/guide/introduction/kakaotalk/bms-outer-coupon1.webp) 1. 직접 운영하는 웹사이트 또는 앱에 수신자가 쿠폰을 발급받을 수 있는 페이지를 생성합니다. ![직접 운영하는 웹사이트 또는 앱에 수신자가 쿠폰을 발급받을 수 있는 쿠폰 발급 페이지를 생성합니다.](https://developers.popbill.com/images/guide/introduction/kakaotalk/bms-outer-coupon2.webp) 2. 팝빌에 쿠폰 발급 페이지 정보를 입력하고 쿠폰을 추가합니다. ![생성한 쿠폰 발급 페이지 URL을 쿠폰 정보에 입력하여 쿠폰을 추가합니다.](https://developers.popbill.com/images/guide/introduction/kakaotalk/bms-outer-coupon3.webp) ### 변수 작성가이드 | 구분 | 설명 | | ------ | --------------------------------------------------------------------------------------------------------------------- | | 작성방법 | 브랜드 메시지 변수는 띄어쓰기 없이 한글, 영문, 그리고 특수기호 ‘-’, ‘\_’만 입력할 수 있습니다. 올바른 예시> #{고객사명}, #{주문번호} 잘못된 예시> #(상품명), \[이름], #{■ 고객사명} | | 버튼 URL | 도메인을 고정으로 포함하여 변수를 작성합니다. 올바른 예시> https\://www\.popbill.com/#\\{고객번호} 잘못된 예시> https\://#{링크} | | 최대 글자수 | 최대 글자수는 치환된 변수 메시지를 포함하므로 변수의 최대 글자 길이를 고려하여 내용을 작성해야 합니다. 치환된 변수 메시지로 최대 글자수를 초과하는 경우 템플릿 내용 불일치 사유로 전송실패 됩니다. | ### 사용 가능한 변수 개수 | 구분 | 텍스트 | 이미지 | 와이드 | 리스트 | 캐러셀 | 캐러셀커머스 | 커머스 | | ----------------------------- | --- | --- | --- | ----- | --- | ------ | --- | | 내용 | 20 | 20 | 20 | - | 20 | - | - | | 버튼 | 20 | 20 | 20 | 20 | 20 | 20 | 20 | | 쿠폰 | 20 | 20 | 20 | 20 | 20 | 20 | 20 | | 제목 + 타이틀 + 이미지 URL | - | - | - | 합산 40 | - | - | - | | 인트로 제목 + 인트로 내용 + 인트로 이미지 URL | - | - | - | - | - | 합산 20 | - | | 상품명 | - | - | - | - | - | 20 | 20 | | 정상가격 | - | - | - | - | - | 1 | 1 | | 할인가격 | - | - | - | - | - | 1 | 1 | | 할인율 | - | - | - | - | - | 1 | 1 | | 할인금액 | - | - | - | - | - | 1 | 1 | | 부가메시지 | - | - | - | - | - | 20 | 20 | > 캐러셀 및 캐러셀커머스 유형에서 제공되는 ‘사용 가능한 변수 개수’는 캐러셀 1개 기준 입니다.