# 템플릿 만들기

템플릿 관리 페이지의 <img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fi9YOc3FTnsqGANYpjjoX%2Fimage.png?alt=media&#x26;token=b247884d-e110-4c37-9f9c-bf1a94729dfc" alt="" data-size="line"> 버튼을 클릭하여 새로운 카카오 알림톡 템플릿을 생성할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FL6VzMa11DSLBPsFwK3Mu%2Fimage.png?alt=media&#x26;token=edbf6664-801b-40ec-ab5e-2010bd4452ff" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
카카오 알림톡 템플릿은 정보성 메시지에 한해 승인받을 수 있습니다.\
[**카카오 알림톡 제작 가이드**](https://kakaobusiness.gitbook.io/main/ad/infotalk/content-guide)를 참고하여 템플릿이 반려되지 않도록 유의해 주세요.&#x20;
{% endhint %}

## **1. 기본 설정**

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FyiHk6dcty4U7R25Sczu3%2Fimage.png?alt=media&#x26;token=e96941f0-48a2-4157-800d-1f631450e397" alt=""><figcaption></figcaption></figure>

* **템플릿명:** 템플릿의 이름을 입력해 주세요. (문자 구분 없이 최대 200자 입력 가능)
* **템플릿 코드:** 템플릿의 코드를 입력해 주세요. (문자 구분 없이 최대 30자 입력 가능)
* **카테고리:** 템플릿 목적에 맞는 카테고리를 선택해 주세요. 카테고리는 검수 과정에서 더 적절한 카테고리로 변경될 수 있습니다.
* **태그 #:** 템플릿에 태그를 설정해 주세요. 템플릿 리스트에서 태그 필터를 통해 템플릿을 필터링할 때 활용됩니다.

***

## **2. 개인화 설정**

### **2-1. 개인화 변수 설정**

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FczhGSlcH0WIw1EppMFcP%2Fimage.png?alt=media&#x26;token=c40d2836-5c02-4a43-b424-a0fb22370202" alt="" data-size="line"> 버튼을 클릭하여 사용자별 맞춤 데이터(예: 이름, 등급)를 담아 보낼 개인화 변수를 설정할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FRFi3X9yuTBRadRI5Xiy9%2Fimage.png?alt=media&#x26;token=c300f1ee-8851-4bbf-9e66-14b5452b31de" alt=""><figcaption></figcaption></figure>

* **변수 추가:** 메시지에 사용할 개인화 변수를 최대 40개까지 생성할 수 있습니다.
* **개인화 키:** API 요청 시 개인화 메시지에서 회원 정보로 치환될 변수의 고유한 식별값입니다. (한글, 영문, 숫자만 최대 50자 입력 가능)

{% hint style="success" %}
개인화 키는 사전에 개발 담당자와 협의하여 입력해주세요.
{% endhint %}

{% hint style="warning" %}
개인화 키를 추가, 수정, 삭제할 경우 메시지 작성 시 추가한 모든 변수는 삭제됩니다.
{% endhint %}

### **2-2. 개인화 변수 추가**

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FWWZvxkubDQ8J2leUVSFd%2Fimage.png?alt=media&#x26;token=afa3eaec-d65b-499e-af16-c7319785b238" alt="" data-size="line"> 버튼을 클릭하여 개인화 변수를 메시지 내용에 추가할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FnaJXlyV9UI5Xwqyx3U9Q%2Fimage.png?alt=media&#x26;token=3076ec55-ee45-4acd-a8f5-13626f57e190" alt=""><figcaption></figcaption></figure>

* **변수:** 메시지에 추가할 개인화 변수를 선택해 주세요. 추가된 변수는 개인화된 정보(예: 회원 이름)로 치환하여 메시지를 발송합니다.
* **대체 발송 값:** 회원의 정보가 없을 경우 대체하여 발송할 값을 입력해 주세요. (문자 구분 없이 최대 10자 입력 가능)

***

## **3. 템플릿 메시지 작성**

각 항목의 <img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FQ2vsj45zff8iWUWeL4fb%2Fimage.png?alt=media&#x26;token=a10ff0e5-c97b-44a2-a540-1ec428cabfaa" alt="" data-size="line"> 버튼을 클릭하여 메시지에 필요한 요소를 활성화한 후, 내용을 작성해 주세요.

{% hint style="warning" %}
아래 유의사항을 참고하여 메시지를 작성해 주세요.

(1) 실제 데이터로 치환될 변수 값(또는 대체 발송 값)을 포함하여 제한 글자 수를 넘을 경우 발송에 실패할 수 있습니다.\
(2) 메시지에는 [**https://www.emojiengine.com/ko**](https://www.emojiengine.com/ko)에서 확인되는 기본 이모지 및 카카오톡 이모티콘만 사용할 수 있습니다.
{% endhint %}

### **3-1. 메시지 강조(강조 표기형)**

메시지의 핵심 내용을 말풍선 상단에 별도로 표시하여 강조할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2F4DmHtxerSIb5ycWbzzA9%2Fimage.png?alt=media&#x26;token=533defb1-1d5b-44e7-91c8-34cbe32cacce" alt=""><figcaption></figcaption></figure>

* **제목:** 강조할 내용을 입력해 주세요. (문자 구분 없이 최대 23자 입력 가능)
* **부제목:** 제목을 보충 설명하는 내용을 입력해 주세요. (문자 구분 없이 최대 18자 입력 가능)

### **3-2. 메시지 강조(이미지형)**

메시지의 목적을 나타내는 이미지를 추가하여 내용을 강조할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FupZKvUb2IAt8qrS8JKWM%2Fimage.png?alt=media&#x26;token=59bec0f5-8b35-4fd9-b659-0392675cb8ef" alt=""><figcaption></figcaption></figure>

* **파일 업로드:** 카카오 알림톡 [**이미지 제작 가이드**](https://kakaobusiness.gitbook.io/main/ad/infotalk/audit#id-3)를 준수하여 만든 이미지를 업로드해 주세요.

### **3-3. 메시지 본문**

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fjt52AD0l3JxDUYRVTwTO%2Fimage.png?alt=media&#x26;token=c3645ba4-0972-4204-8b92-09edc4103d79" alt=""><figcaption></figcaption></figure>

* **내용:** 고객에게 반드시 전달해야 하는 내용을 입력해 주세요. (문자 구분 없이 최대 1,000자 입력 가능)
* **부가 정보:** 지속적으로 안내할 부가 정보를 입력해 주세요. (문자 구분 없이 최대 500자 입력 가능)
* **채널 추가 안내:** \[채널 추가] 버튼을 설정한 경우 안내 문구가 자동으로 추가됩니다.

{% hint style="info" %}
본문(내용, 부가 정보, 채널 추가 안내 메시지)은 **치환될 변수 값을 포함하여 최대 1,000자까지 발송**할 수 있습니다.
{% endhint %}

{% hint style="success" %}
**카카오톡 25.8.0 이상 버전**의 사용자에게는 **최대 1,300자까지 발송 가능**합니다.&#x20;
{% endhint %}

### **3-4. 버튼**

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FKmYAHT9tWKMWO3yutXYV%2Fimage.png?alt=media&#x26;token=16616a84-c543-4d0d-a78d-e1777eb2dcd3" alt="" data-size="line"> 버튼을 클릭하여 메시지에 버튼을 추가할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FfKVMVQWXc03STliGZMDh%2Fimage.png?alt=media&#x26;token=4f5f3902-1eb3-42b7-9db6-5ec11e13afed" alt=""><figcaption></figcaption></figure>

| 버튼 유형      | 버튼명                               | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **채널 추가**  | '채널 추가' 고정 노출                     | <p>발신자의 채널을 추가할 수 있는 버튼으로, 메시지 본문에 '채널 추가 안내 문구'가 함께 노출됩니다.</p><p>이미 채널을 추가한 수신자에게는 버튼과 안내 문구가 보이지 않습니다.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **웹 링크**   | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 980자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 980자 발송 가능)</li></ul><p></p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.</p></div>                                                                                                                                                                                         |
| **앱 링크**   | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>Android:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>iOS:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 980자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 980자 발송 가능)</li></ul><p></p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.</p></div> |
| **배송 조회**  | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 '배송조회 페이지'로 이동합니다.</p><p>본문에 입력된 '송장번호'를 조회하여 '배송조회 페이지'로 이동할 수 있는 링크가 자동 생성됩니다.</p><ul><li>배송 조회 버튼은 <strong>메시지 내용</strong>에 <strong>카카오가 지원하는 택배사명과 송장번호가 모두 포함</strong>된 경우에만 사용할 수 있습니다.</li><li><strong>지원 가능 택배사:</strong> 우체국택배, 로젠택배, 일양로지스, FedEx ,한진택배, 경동택배, 합동택배, 롯데택배, 농협택배, 호남택배, CU 편의점택배, CVSnet편의점택배, TNT Express, USPS, EMS, 천일택배, DHL, 대신택배, 건영택배, 한덱스, 굿투럭<br>\* <strong>카카오와 해당 택배사와의 계약 관계에 의해 변동될 수 있음을 유의해 주세요.</strong></li></ul>                                                                                                                                                                              |
| **봇 키워드**  | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 '버튼명'을 상담원에게 전달합니다. </p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채팅 > 채팅 설정]에서 '<strong>1:1 채팅 사용' ON</strong>한 채널에서만 정상 동작합니다.</li><li>'1:1 채팅 사용 OFF'한 경우 채팅이 OFF 되었다는 안내 메시지가 전달됩니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                           |
| **메시지 전달** | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 '버튼명+메시지 본문'을 상담원에게 전달합니다. </p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채팅 > 채팅 설정]에서 '<strong>1:1 채팅 사용' ON</strong>한 채널에서만 정상 동작합니다.</li><li>'1:1 채팅 사용 OFF'한 경우 채팅이 OFF 되었다는 안내 메시지가 전달됩니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                    |
| **상담톡 전환** | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 상담톡으로 전환됩니다.</p><ul><li>상담톡을 이용하지 않는 채널에서 해당 버튼을 추가할 경우 발송 실패 처리됩니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **봇 전환**   | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 챗봇이 호출됩니다.</p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채널 > 챗봇 연결]에서 챗봇과 채널을 연결해야 정상 동작합니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **전화하기**   | '전화 연결', '고객센터 연결', '상담원 연결' 중 선택 | <p>클릭 시 입력한 전화번호로 통화를 연결합니다.</p><p>전화하기 버튼은 모바일에서만 확인할 수 있으며, PC에서는 '모바일에서 확인해 주세요' 문구가 나타납니다.</p><ul><li><strong>전화번호:</strong> 숫자 및 하이픈(-)만 입력해 주세요. (최대 14자 입력 가능)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

{% hint style="warning" %}
버튼명에는 이모지 또는 이모티콘을 사용할 수 없습니다.
{% endhint %}

{% hint style="info" %}
모바일 환경 전용 링크 버튼(모바일/Android/iOS)은 PC 카카오톡에서 노출되지 않습니다.&#x20;
{% endhint %}

<details>

<summary><strong>수신자의 실행 환경에 따른 링크 동작</strong></summary>

| 실행 환경   | 1순위        | 2순위    | 3순위   |
| ------- | ---------- | ------ | ----- |
| Android | Android 링크 | 모바일 링크 | PC 링크 |
| iOS     | iOS 링크     | 모바일 링크 | PC 링크 |
| PC      | PC 링크      | 모바일 링크 | -     |

{% hint style="info" %}
수신 환경에 맞는 1순위 링크(앱)가 실행되지 않을 경우 자동으로 2순위 링크(웹)로 연결됩니다.
{% endhint %}

</details>

### **3-5. 보안 템플릿**

민감한 개인정보가 포함된 경우, '보안 템플릿'으로 설정하여 메시지 보안을 강화할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FEFMgf93ZeRFxin1qAo0q%2Fimage.png?alt=media&#x26;token=837a21c4-d072-4a26-aee8-387385d7b126" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
보안 템플릿으로 발송된 메시지는 PC 카카오톡에서 내용이 보이지 않고, "모바일에서 확인해주세요"라는 안내 문구로 대체됩니다.
{% endhint %}

{% hint style="success" %}
템플릿에 민감 정보가 포함되지 않았다고 판단될 경우, 검수 과정에서 카카오가 보안 설정을 해제할 수 있습니다.
{% endhint %}

### **3-6. 미리보기 메시지**

알림창과 채팅 목록에 표시될 미리보기용 메시지를 별도로 설정할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FB4e5lH1J5t19YYFejb7r%2Fimage.png?alt=media&#x26;token=ac98b0fa-f840-4761-b9c3-da345d6ea469" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
보안 템플릿으로 설정된 경우에는 미리보기 메시지를 사용할 수 없습니다.
{% endhint %}

{% hint style="success" %}
미설정 시 본문 앞부분이 노출되므로, 핵심 내용을 미리보기로 전달하려면 별도로 작성하는 것을 권장합니다.
{% endhint %}

### **3-7. 대표 링크**

알림톡 말풍선 클릭 시 이동할 랜딩 페이지를 설정할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FsQzK2ZRysVz7IkINPxTw%2Fimage.png?alt=media&#x26;token=19024e36-c654-4cc7-a399-2ccf85a217e4" alt=""><figcaption></figcaption></figure>

* **모바일:** http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)
* **PC:** http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)
* **Android:** Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)
* **iOS:** Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)

{% hint style="info" %}
웹 링크와 앱 링크를 모두 입력하면, 모바일 기기 사용자에게는 딥링크가 우선적으로 동작합니다.
{% endhint %}

***

## **4. 미리보기**

작성 중인 메시지가 사용자에게 어떻게 보일지 실시간으로 확인할 수 있습니다.&#x20;

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fbx4CfBJn0eSoSnrpQMSf%2Fimage.png?alt=media&#x26;token=b6f707c9-82ae-4b78-af93-f34cd6bea5e0" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
미리보기는 **참고용으로 제공**되며, 실제 메시지는 수신자의 기기나 앱 환경에 따라 다르게 보일 수 있습니다.
{% endhint %}

***

## **5. 부가 옵션**

### **5-1. 즉시 검수 요청**

템플릿 저장과 동시에 카카오에 검수를 요청합니다.\
필요 시, 카카오 검수 담당자에게 전달할 참고 의견이나 파일을 첨부해 주세요.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FxLj0EqYQrzGLY2yAEKnk%2Fimage.png?alt=media&#x26;token=3f6c5faa-4a0f-4656-a8d6-2d32de63e6ab" alt=""><figcaption></figcaption></figure>

* **검수자 참고 의견:** 검수자에게 전달할 내용을 입력해 주세요. (문자 구분 없이 최대 500자 입력 가능)
* **첨부 파일:** 패널 하단의 '업로드 유의사항'을 준수하여 검수에 필요한 참고 파일을 업로드해 주세요.

{% hint style="warning" %}
아래 기준을 충족하지 않을 경우 템플릿이 반려될 수 있습니다.

(1) 작성한 템플릿이 광고성이 아닌 **정보성 메시지**가 맞는지 확인해주세요.\
(2) 카카오의 **알림톡 서비스 운영정책**에 부합하는지 확인해주세요.

[카카오 알림톡 심사 가이드](https://kakaobusiness.gitbook.io/main/ad/infotalk/audit#1.)
{% endhint %}