# 메시지 설정 가이드

## **카카오 메시지 유형별 가이드**

카카오톡(카카오 모먼트)에서 제공하는 메시지 유형별 메시지 내용을 구성하는 가이드 및 유의사항을 확인합니다.

{% hint style="danger" %}
**개인화 변수 사용 시 변** **치환 후에는 메시지 유형에 따른 가이드를 준수하여야 발송되며, 준수하지 않을 시 발송이 실패됩니다.**
{% endhint %}

### **와이드 리스트**

* 와이드 리스트 유형은 다양한 한 메시지 안에 최대 4개의 이미지와, 다양한 상품 정보를 담을 수 있는 메시지 유형입니다.

{% hint style="warning" %}
필수 : 타이틀, 리스트 1 이미지, 리스트 2\~3, 각 리스트의 랜딩 URL / 선택 : 리스트 4, 버튼 1\~2, PC URL
{% endhint %}

<img src="/files/QbcAvGpr5yr6muBxWA32" alt="" width="188">

<table><thead><tr><th width="157.140625">요소</th><th width="431.45703125">가이드</th><th>개인화 변수</th></tr></thead><tbody><tr><td>⓵ 타이틀</td><td><ul><li>치환 후 최대 20자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓶ 리스트 1 이미지</td><td><ul><li>파일 형식 : JPG, JPEG, PNG (동영상 미지원)</li><li><p>사이즈</p><ul><li>800x400 (2:1 비율) 권장</li><li>가로 80px 이상, 가로:세로 비율 1:2.5 이하 지원 안함</li></ul></li><li>용량 : 10MB</li><li>파일 : 고정 이미지 업로드 또는 변수 이미지 URL 등록</li><li>※ 리스트 1의 이미지는 대표 이미지로, 고정 이미지 사용을 권장합니다.</li></ul></td><td><ul><li>이미지 URL</li></ul></td></tr><tr><td>⓷ 리스트 1 텍스트</td><td><ul><li>치환 후 최대 25자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓸ 리스트 2~4 이미지</td><td><ul><li>파일 형식 : JPG, JPEG, PNG (동영상 미지원)</li><li><p>사이즈</p><ul><li>800x800 (1:1 비율) 권장</li><li>가로 80px 이상, 가로:세로 비율 1:2.5 이하 지원 안함</li></ul></li><li>용량 : 10MB</li><li>파일 : 고정 이미지 업로드 또는 변수 이미지 URL 등록</li></ul></td><td><ul><li>이미지 URL</li></ul></td></tr><tr><td>⓹ 리스트 2~4 텍스트</td><td><ul><li>치환 후 최대 30자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓺ 버튼 1~2</td><td><ul><li>버튼명 : 최대 8자</li><li>랜딩 유형 : URL</li></ul></td><td><ul><li>사용 불가</li></ul></td></tr><tr><td>URL</td><td><ul><li>최대 1000자 입력 가능</li><li>http:// 또는 https:// 형식의 랜딩 URL 지원</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.</p></div></td><td><ul><li>모바일 URL</li><li>PC URL</li></ul></td></tr></tbody></table>

### **캐러셀 피드**

* 캐러셀 피드 유형은 최대 6개의 캐러셀 영역에 대표 이미지와 타이틀, 내용 등의 다양한 요소를 담아 보낼 수 있는 유형입니다.

{% hint style="warning" %}
필수 : 캐러셀은 최소 2개 이상 사용, 이미지, 타이틀, 텍스트, 버튼 1 / 선택 : 버튼 2, 캐러셀 3\~6
{% endhint %}

![](/files/E1kuXUMb8Kjr50qKAHAi)

<table><thead><tr><th width="141.6484375">요소</th><th width="451.77734375">가이드</th><th>개인화 변수</th></tr></thead><tbody><tr><td>⓵ 이미지 영역</td><td><ul><li>파일 형식 : JPG, JPEG, PNG (동영상 미지원)</li><li><p>사이즈</p><ul><li>800x400 (2:1 비율) 권장</li><li>800x600 (4:3 비율) 권장</li><li>가로 80px 이상, 가로:세로 비율 1:2.5 이하 지원 안함</li></ul></li><li>용량 : 10MB</li><li>파일 : 고정 이미지 업로드 또는 변수 이미지 URL 등록</li></ul><p>※ 캐러셀 1 ~ 6 영역의 이미지는 동일한 비율의 이미지를 등록해 주세요.</p></td><td><ul><li>이미지 URL</li></ul></td></tr><tr><td>⓶ 타이틀</td><td><ul><li>치환 후 최대 20자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓷ 텍스트</td><td><ul><li>치환 후 최대 180자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓸ 버튼 1</td><td><ul><li>버튼명 : 최대 8자(변수 사용 불가)</li><li>랜딩 유형 : URL</li><li>※ 캐러셀 유형에서는 이미지 영역 클릭 시 버튼 1과 동일한 URL로 랜딩됩니다.</li></ul></td><td><ul><li>버튼 1 URL만 사용</li><li>모바일 URL</li><li>PC URL</li></ul></td></tr><tr><td>⓹ 버튼 2(선택)</td><td><ul><li>버튼명 : 최대 8자</li><li>랜딩 유형 : URL</li></ul></td><td><ul><li>사용 불가</li></ul></td></tr><tr><td>⓺ 더보기 버튼(선택)</td><td><ul><li>랜딩 유형 : URL</li></ul></td><td><ul><li>사용 불가</li></ul></td></tr><tr><td>URL</td><td><ul><li>최대 1000자 입력 가능</li><li>http:// 또는 https:// 형식의 랜딩 URL 지원</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>버튼 1 URL만 사용</li><li>모바일 URL</li><li>PC URL</li></ul></td></tr></tbody></table>

***

## **유의 사항**

{% hint style="warning" %}
작성 가이드는 카카오 모먼트 정책을 준수합니다.
{% endhint %}

* 각 영역에서 공백만 입력할 수 없습니다.
* 본문이 들어가는 영역에 링크 형식을 작성할 수 없습니다.
* 줄바꿈의 횟수에 대한 제한이 있습니다.
* 각 어절 간 공백은 한 번만 사용 가능합니다.
* URL을 작성하는 영역에 다양한 쿼리 파라미터(링크 뒤에 ?나 & 기호로 연결하여 추적하는 URL 형식)가 붙은 딥링크 형태는 정상 동작되지 않을 수 있어 참고하여 설정해 주세요.
* 개인화 변수는 변수별 사용 가능한 영역에서 사용하여야 합니다.

{% hint style="danger" %}
**개인화 메시지 내 변수를 이용하여 수신자의 개인정보를 침해하거나 개인적인 특성이나 민감한 정보를 언급 또는 암시하여 타인의 권리를 침해할 수 있는 내용이 포함된 메시지를 발송한 채널은 카카오광고 운영정책에 따라 한시적 또는 영구적으로 메시지 발송이 제한될 수 있습니다.**
{% endhint %}

{% hint style="warning" %}
URL 내 UTF-8 코드로 인코딩되지 않은 특수문자나 한글이 있을 경우, iOS 기기 > 카카오톡 인앱 브라우저에서 정상 랜딩되지 않을 수 있습니다. 랜딩 오류가 발생할 수 있는 특수문자를 미리 참고하여 URL을 셋팅해 주세요.\
• %\
• | (vertical bar)\
• “
{% endhint %}

{% hint style="warning" %}
파라미터/매크로 치환이 필요한 딥링크 형식의 URL은 메시지 광고에서는 지원하고 있지 않아 정상 동작하지 않을 수 있습니다.\
해당 내용 참고하여 **메시지 소재 내 딥링크 형식의 URL 설정은 지양해 주세요.**
{% 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-moment/kakao-moment-create/message-guide.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.