# 템플릿 만들기

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

<figure><img src="/files/0SfDaWDgJt4V1A8jDG4E" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
브랜드 메시지 템플릿은 별도의 검수 절차 없이, 생성 즉시 사용할 수 있습니다.
{% endhint %}

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

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

* **템플릿명:** 템플릿의 이름을 입력해 주세요. (문자 구분 없이 최대 200자 입력 가능)
* **메시지 유형:** 캠페인 목적에 적합한 메시지 유형을 선택해 주세요. 유형 변경 시, 입력한 내용은 해당 유형의 최대 규격에 맞춰 자동으로 조정됩니다.
* **태그 #:** 템플릿에 태그를 설정해 주세요. 템플릿 리스트에서 태그 필터를 통해 템플릿을 필터링할 때 활용됩니다.

***

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

캠페인 목적에 맞는 유형을 선택하고, 필요한 구성 요소를 활성화하여 메시지를 작성해 주세요.

### **2-1. 메시지 유형별 안내**

{% tabs %}
{% tab title="텍스트" %}

<figure><img src="/files/8vOETHhE4xUmf3nJYgpv" alt=""><figcaption></figcaption></figure>

| 구성 요소        | 설명                                                                                                                                              |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **내용**       | <ul><li><strong>입력 제한:</strong> 문자 구분 없이 최대 1,000자 입력 가능 (줄바꿈 최대 99회) </li><li><strong>발송 제한:</strong> 치환될 변수 값을 포함하여 최대 1,300자 발송 가능</li></ul> |
| **버튼**       | <ul><li><strong>버튼 개수:</strong> 최대 5개 추가 가능</li><li><strong>쿠폰 첨부 시:</strong> 최대 4개 추가 가능</li></ul>                                             |
| **쿠폰**       | <ul><li><strong>쿠폰 개수:</strong> 최대 1개 추가 가능</li><li><strong>버튼 5개 추가 시:</strong> 추가 불가</li></ul>                                                |
| {% endtab %} |                                                                                                                                                 |

{% tab title="이미지" %}

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

| 구성 요소        | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이미지**      | <ul><li><p><strong>파일 업로드</strong></p><ul><li><strong>파일 형식:</strong> JPG, JPEG, PNG</li><li><strong>파일 용량:</strong> 최대 5MB</li><li><strong>파일 개수:</strong> 최대 1개</li><li><strong>이미지 비율:</strong> 가로:세로 2:1 \~ 3:4</li><li><strong>이미지 사이즈:</strong> 가로 500px 이상, 800x400 권장</li></ul></li><li><p><strong>이미지 링크</strong></p><ul><li>이미지 클릭 시 이동할 랜딩 페이지를 설정할 수 있습니다.</li><li>http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li></ul></li></ul> |
| **내용**       | <ul><li><strong>입력 제한:</strong> 문자 구분 없이 최대 1,000자 입력 가능 (줄바꿈 최대 99회) </li><li><strong>발송 제한:</strong> 치환될 변수 값을 포함하여 최대 1,300자 발송 가능</li></ul>                                                                                                                                                                                                                                                                                                                                   |
| **버튼**       | <ul><li><strong>버튼 개수:</strong> 최대 5개 추가 가능</li><li><strong>쿠폰 첨부 시:</strong> 최대 4개 추가 가능</li></ul>                                                                                                                                                                                                                                                                                                                                                                               |
| **쿠폰**       | <ul><li><strong>쿠폰 개수:</strong> 최대 1개 추가 가능</li><li><strong>버튼 5개 추가 시:</strong> 추가 불가</li></ul>                                                                                                                                                                                                                                                                                                                                                                                  |
| {% endtab %} |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

{% tab title="와이드 이미지" %}

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

| 구성 요소         | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이미지**       | <ul><li><p><strong>파일 업로드</strong></p><ul><li><strong>파일 형식:</strong> JPG, JPEG, PNG</li><li><strong>파일 용량:</strong> 최대 5MB</li><li><strong>파일 개수:</strong> 최대 1개</li><li><strong>이미지 비율:</strong> 가로:세로 2:1 \~ 1:1</li><li><strong>이미지 사이즈:</strong> 가로 500px 이상, 800x600 권장</li></ul></li><li><p><strong>이미지 링크</strong></p><ul><li>이미지 클릭 시 이동할 랜딩 페이지를 설정할 수 있습니다.</li><li>http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li></ul></li></ul> |
| **내용**        | <ul><li><strong>입력 제한:</strong> 문자 구분 없이 최대 76자 입력 가능 (줄바꿈 최대 5회) </li><li><strong>발송 제한:</strong> 치환될 변수 값을 포함하여 최대 1,300자 발송 가능</li></ul>                                                                                                                                                                                                                                                                                                                                       |
| **버튼**        | <ul><li><strong>버튼 개수:</strong> 최대 5개 추가 가능</li><li><strong>쿠폰 첨부 시:</strong> 최대 4개 추가 가능</li></ul>                                                                                                                                                                                                                                                                                                                                                                               |
| **쿠폰**        | <ul><li><strong>쿠폰 개수:</strong> 최대 1개 추가 가능</li><li><strong>버튼 5개 추가 시:</strong> 추가 불가</li></ul>                                                                                                                                                                                                                                                                                                                                                                                  |
| {% endtab %}  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| {% endtabs %} |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

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

(1) 실제 데이터(변수 또는 대체값)로 치환된 최종 길이가 발송 제한 글자 수를 넘지 않도록 주의해 주세요.\
(2) 메시지에는 [**https://www.emojiengine.com/ko**](https://www.emojiengine.com/ko)에서 확인되는 기본 이모지 및 카카오톡 이모티콘만 사용할 수 있습니다.
{% endhint %}

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

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

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

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

{% hint style="warning" %}
서로 다른 변수는 **최대 10개**까지 추가할 수 있습니다.
{% endhint %}

{% hint style="info" %}
사용할 변수는 [**\[설정 > 개인화 변수 설정\]**](/new-admin/settings/user-property.md)에서 추가해 주세요.
{% endhint %}

### **2-3. 버튼**

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

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

| 버튼 유형      | 버튼명                                                                                                                             | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **채널 추가**  | '채널 추가' 고정 노출                                                                                                                   | <p>클릭 시 발신자의 채널을 추가합니다.</p><p>이미 채널을 추가한 수신자에게는 버튼이 보이지 않습니다.</p>                                                                                                                                                                                                                                                                                                                                                                                      |
| **웹 링크**   | <ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul>        | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 920자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 920자 발송 가능)</li></ul>                                                                                                                                                                                         |
| **앱 링크**   | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <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자 입력 가능, 최대 920자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 920자 발송 가능)</li></ul> |
| **봇 키워드**  | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <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>                                                                                                                                                                                                 |
| **메시지 전달** | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <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>                                                                                                                                                                                          |
| **상담톡 전환** | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <p>클릭 시 상담톡으로 전환됩니다.</p><ul><li>상담톡을 이용하지 않는 채널에서 해당 버튼을 추가할 경우 발송 실패 처리됩니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                 |
| **봇 전환**   | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <p>클릭 시 챗봇이 호출됩니다.</p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채널 > 챗봇 연결]에서 챗봇과 채널을 연결해야 정상 동작합니다.</li></ul>                                                                                                                                                                                                                                                                                             |

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

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

<details>

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

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

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

</details>

### **2-4. 쿠폰**

<img src="/files/O6dnb9RjN86R3m4Xdzqc" alt="" data-size="line"> 버튼을 클릭하여 쿠폰을 활성화하면, 메시지에 쿠폰을 추가할 수 있습니다.

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

| 쿠폰 유형      | 쿠폰명                         | 쿠폰 설명                                                                                                                            |
| ---------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **할인 금액**  | 1\~99,999,999 범위의 숫자만 입력 가능 | <ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul>        |
| **할인율**    | 1\~100 범위의 숫자만 입력 가능        | <ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul>        |
| **배송비 할인** | '배송비 할인 쿠폰' 고정 노출           | <ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul>        |
| **무료 증정**  | 문자 구분 없이 최대 7자 입력 가능        | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul> |
| **업그레이드**  | 문자 구분 없이 최대 7자 입력 가능        | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul> |

#### **2-4-1. 쿠폰 링크**

쿠폰 클릭 시 연결될 페이지의 링크를 입력해 주세요.

| 링크 유형     | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **직접 입력** | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>Android:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>iOS:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li></ul> |
| **채널 쿠폰** | <p><a href="https://kakaobusiness.gitbook.io/main/channel/run/biztool#id-1"><strong>카카오 쿠폰 작성 가이드</strong></a>를 참고하여 쿠폰을 작성 후, 해당 쿠폰의 URL을 입력해 주세요.</p><p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>Android:</strong> alimtalk=coupon://를 포함한 딥 링크를 입력해 주세요.</li><li><strong>iOS:</strong> alimtalk=coupon://를 포함한 딥 링크를 입력해 주세요.</li></ul>                                                                                                             |

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

{% hint style="warning" %}
외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.
{% endhint %}

{% tabs %}
{% tab title="채널 쿠폰 URL 위치" %}
**\[카카오톡 채널 관리자 센터 > 비즈니스 도구 > 쿠폰 목록 > 쿠폰 상세 > 브랜드 메시지 URL 복사]** &#x20;

<figure><img src="/files/XA9Yj2lVxkQlim0CBgLj" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="채널 쿠폰 예시" %}
**\[온라인 쿠폰]**

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

**\[오프라인 쿠폰]**

<figure><img src="/files/Se3BxiXUJAEBA6feqQBQ" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

<details>

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

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

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

</details>

### **2-5. 연령 인증 메시지**

청소년에게 부적절한 업종 및 관련 콘텐츠 포함된 경우, 성인 인증을 완료한 사용자만 내용을 볼 수 있도록 설정할 수 있습니다.

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

{% hint style="info" %}
연령 인증 메시지는 **20세 이상 성인만 확인**할 수 있으며, 인증 전까지는 내용이 가려집니다.&#x20;
{% endhint %}

<details>

<summary><strong>연령 인증 메시지 가이드</strong></summary>

청소년에게 부적절한 콘텐츠가 포함된 경우, 아래 기준을 준수해야만 발송 가능합니다.

* **일반 유해 콘텐츠:** 메시지 발송 설정 시 ‘연령 인증 메시지’로 설정해야 합니다.
* **주류 및 전자담배 (판매/제조 등):** 카카오톡 채널 자체를 ‘성인인증 채널’로 전환해야 합니다. *(※ 단, 성인인증 채널인 경우 메시지 내 연령 인증 기능은 생략 가능)*

**\[필수 적용 대상]**\
청소년 이용불가 등급의 게임, 영화/비디오, 음반, 웹툰, 간행물/서적, 기타 청소년 유해 업종 및 콘텐츠

</details>

***

## **3. 미리보기**

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

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

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