# 템플릿 만들기

템플릿 관리 페이지의 <img src="/files/5B0jn1jTvVpKXqBmXUxB" alt="" data-size="line"> 버튼을 클릭하여 새로운 카카오 알림톡 템플릿을 생성할 수 있습니다.

<figure><img src="/files/KNKTzhezj6LExKH6Kkxj" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/Pb3CzCXqqSIXGiQbVpwz" alt=""><figcaption></figcaption></figure>

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

***

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

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

<img src="/files/agoRlsX2T6GHYrekY8AR" alt="" data-size="line"> 버튼을 클릭하여 사용자별 맞춤 데이터(예: 이름, 등급)를 담아 보낼 개인화 변수를 설정할 수 있습니다.

<figure><img src="/files/F4Gd9AYpZegFU8idm7bh" alt=""><figcaption></figcaption></figure>

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

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

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

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

<img src="/files/eruMmrftrvYAsSBxEPLE" alt="" data-size="line"> 버튼을 클릭하여 개인화 변수를 메시지 내용에 추가할 수 있습니다.

<figure><img src="/files/cR7RMk7lnwJ6gFW7iU4U" alt=""><figcaption></figcaption></figure>

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

***

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

각 항목의 <img src="/files/O6dnb9RjN86R3m4Xdzqc" 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="/files/lttvfjLsvAHYeohm4yL8" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/53wySJryOaH9wWQOl63L" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/UKziMQuk3bJH8Do4SVZ1" 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="/files/UgNjq0tMlWtmJ1ZPwA8E" alt="" data-size="line"> 버튼을 클릭하여 메시지에 버튼을 추가할 수 있습니다.

<figure><img src="/files/1rEK7LhDFU5se18ZH6nh" 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="/files/sIRZDDwQdc1f8qzPuRjz" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="/files/FGK3WrNrOjJnjlUqbpdr" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="/files/cABaGiBy343Q1hSIa8ZP" 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="/files/H6JEq1PwKpKq0w8skfu0" alt=""><figcaption></figcaption></figure>

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

***

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

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

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

<figure><img src="/files/cspuetz1Q6mYxypjom8t" alt=""><figcaption></figcaption></figure>

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.groobee.ai/new-admin/kakao-alimtalk/template-create.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.