# 메시지 구성 가이드

## **메시지 타입 구성 제작 가이드**

{% hint style="warning" %}
모든 메시지타입은 '**(광고)**'가 발신 프로필 좌측 자동 표기됩니다.
{% endhint %}

## **1. 텍스트형**

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FNBYkre18xmkxZEE7e0Hq%2F%E1%84%8E%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AE%E1%84%90%E1%85%A9%E1%86%A8-%E1%84%90%E1%85%A6%E1%86%A8%E1%84%89%E1%85%B3%E1%84%90%E1%85%B3%E1%84%92%E1%85%A7%E1%86%BC%20%E1%84%8C%E1%85%A6%E1%84%8C%E1%85%A1%E1%86%A8%20%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3.png?alt=media&#x26;token=8d194f0e-3c09-40d6-adf2-758be296b888" alt=""><figcaption><p>친구톡 - 텍스트형</p></figcaption></figure>

<table><thead><tr><th width="100">구성 요소</th><th width="213">구분</th><th width="423">상세안내</th></tr></thead><tbody><tr><td>①</td><td>메시지</td><td>띄어쓰기 포함 최대 1,300자<br>- 개인화 변수 사용 시 치환된 변수값이 길이를 초과하는 경우 발송 실패할 수 있음</td></tr><tr><td>②</td><td>버튼(최대 5개) </td><td>• 띄어쓰기 포함 최대 14자<br>• 랜딩 유형 : 웹링크, 딥링크</td></tr><tr><td>③</td><td>쿠폰 강조 버튼</td><td>• 띄어쓰기 포함 최대 12자<br>• 랜딩 유형 : Mobile(필수), PC</td></tr></tbody></table>

## **2. 이미지형**

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FrQTCIuHTogNMuNQUg9Fj%2F%E1%84%8E%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AE%E1%84%90%E1%85%A9%E1%86%A8-%E1%84%8B%E1%85%B5%E1%84%86%E1%85%B5%E1%84%8C%E1%85%B5%E1%84%92%E1%85%A7%E1%86%BC%20%E1%84%8C%E1%85%A6%E1%84%8C%E1%85%A1%E1%86%A8%20%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3.png?alt=media&#x26;token=47f80c81-f3ec-4827-9fea-81bdd1313186" alt=""><figcaption><p>친구톡 - 이미지형</p></figcaption></figure>

<table><thead><tr><th width="100">구성 요소</th><th width="213">구분</th><th width="423">상세안내</th></tr></thead><tbody><tr><td>①</td><td>이미지</td><td>• 파일형식 : jpg, png, jpeg / 최대 5MB<br>• 사이즈/용량 : <mark style="color:red;">가로 500px 이상 필수</mark><br>ㄴ 800x400 (2:1)<br>ㄴ 800x800 (1:1)<br>ㄴ 800x600 (4:3)<br>ㄴ 600x800 (3:4)</td></tr><tr><td></td><td>ㄴ 랜딩(선택)</td><td><p>• 랜딩 유형 : URL</p><p>- 클릭 추적 옵션 활성화 시 랜딩 필수</p></td></tr><tr><td>②</td><td>메시지</td><td><p>• 띄어쓰기 포함 최대 1,300자 (줄바꿈 최대 99회)</p><p>- 개인화 변수 사용 시 치환된 변수값이 길이를 초과하는 경우 발송 실패할 수 있음</p></td></tr><tr><td>③</td><td>버튼(최대5개)</td><td>• 띄어쓰기 포함 최대 14자<br>• 랜딩 유형 : 웹링크, 딥링크</td></tr><tr><td>④</td><td>쿠폰 강조 버튼 </td><td>• 띄어쓰기 포함 최대 12자<br>• 랜딩 유형 : Mobile(필수), PC</td></tr></tbody></table>

## **3. 와이드 이미지형**&#x20;

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2Fm7zNtJXpgTuJWa8XEa93%2F%E1%84%8E%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AE%E1%84%90%E1%85%A9%E1%86%A8-%E1%84%8B%E1%85%AA%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3%20%E1%84%8B%E1%85%B5%E1%84%86%E1%85%B5%E1%84%8C%E1%85%B5%20%E1%84%8C%E1%85%A6%E1%84%8C%E1%85%A1%E1%86%A8%20%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3.png?alt=media&#x26;token=2f498975-47bf-4eed-b4b5-c10e7a4560df" alt=""><figcaption><p>친구톡 - 와이드 이미지형 </p></figcaption></figure>

<table><thead><tr><th width="100">구성 요소</th><th width="213">구분</th><th width="423">상세안내</th></tr></thead><tbody><tr><td>①</td><td>이미지</td><td>• 파일형식 : jpg, png, jpeg / 최대 5MB<br>• 사이즈/용량 : 800x600 (4:3)</td></tr><tr><td></td><td>ㄴ 랜딩(선택)</td><td><p>• 랜딩 유형 : URL</p><p>- 클릭 추적 옵션 활성화 시 랜딩 필수</p></td></tr><tr><td>②</td><td>메시지</td><td><p>• 띄어쓰기 포함 최대 76자 (줄바꿈 최대 5회)</p><p>- 개인화 변수 사용 시 치환된 변수값이 길이를 초과하는 경우 발송 실패할 수 있음</p></td></tr><tr><td>③</td><td>버튼(최대2개)</td><td>• 띄어쓰기 포함 최대 8자<br>• 랜딩 유형 : 웹링크, 딥링크</td></tr><tr><td>④</td><td>쿠폰 강조 버튼 </td><td>• 띄어쓰기 포함 최대 18자 (줄바꿈 불가)<br>• 랜딩 유형 : Mobile(필수), PC</td></tr></tbody></table>

## **4. 와이드 리스트형**

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FBjJrYi8NMQvxaicsE31z%2F%E1%84%8E%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AE%E1%84%90%E1%85%A9%E1%86%A8-%E1%84%8B%E1%85%AA%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3%20%E1%84%8B%E1%85%A1%E1%84%8B%E1%85%B5%E1%84%90%E1%85%A6%E1%86%B7%20%E1%84%85%E1%85%B5%E1%84%89%E1%85%B3%E1%84%90%E1%85%B3%20%E1%84%8C%E1%85%A6%E1%84%8C%E1%85%A1%E1%86%A8%20%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3.png?alt=media&#x26;token=3f4983ea-a73a-48c4-9cda-6ed6937cf745" alt=""><figcaption><p>친구톡 - 와이드 아이템 리스트형 </p></figcaption></figure>

<table><thead><tr><th width="100">구성 요소</th><th width="213">구분</th><th width="423">상세안내</th></tr></thead><tbody><tr><td>①</td><td>상단 제목</td><td>띄어쓰기 포함 최대 20자</td></tr><tr><td>②</td><td>리스트 1 이미지</td><td>• 파일형식 : jpg, png, jpeg / 최대 5MB<br>• 사이즈/용량 : 800x400 (2:1)</td></tr><tr><td></td><td>ㄴ 랜딩(선택)</td><td><p>• 랜딩 유형 : URL</p><p>- 클릭 추적 옵션 활성화 시 랜딩 필수</p></td></tr><tr><td>③</td><td>리스트 1 제목</td><td>띄어쓰기 포함 최대 25자</td></tr><tr><td>④</td><td>리스트 2~4 이미지</td><td>• 파일형식 : jpg, png, jpeg<br>• 사이즈/용량 : 800x800 (1:1)</td></tr><tr><td></td><td>ㄴ 랜딩(선택)</td><td><p>• 랜딩 유형 : URL</p><p>- 클릭 추적 옵션 활성화 시 랜딩 필수</p></td></tr><tr><td>⑤</td><td>리스트 2~4 제목</td><td>띄어쓰기 포함 최대 30자</td></tr><tr><td>⑥</td><td>버튼(최대 2개)</td><td>• 띄어쓰기 포함 최대 8자<br>• 랜딩 유형 : 웹링크, 딥링크</td></tr><tr><td>⑦</td><td>쿠폰 강조 버튼</td><td>• 띄어쓰기 포함 최대 18자<br>• 랜딩 유형 : Mobile(필수), PC</td></tr></tbody></table>

## **5. 캐러셀 피드형**

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FXmLxALYh0qjONBR2mL8k%2F%E1%84%8E%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AE%E1%84%90%E1%85%A9%E1%86%A8-%E1%84%8F%E1%85%A2%E1%84%85%E1%85%A5%E1%84%89%E1%85%A6%E1%86%AF%20%E1%84%91%E1%85%B5%E1%84%83%E1%85%B3%20%E1%84%8C%E1%85%A6%E1%84%8C%E1%85%A1%E1%86%A8%20%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3.png?alt=media&#x26;token=9dd4d925-ae44-43c4-bf84-a6e2c1e83a86" alt=""><figcaption><p>친구톡 - 캐러셀 피드형 </p></figcaption></figure>

### **캐러셀 1\~2 영역 (필수 입력)**

<table><thead><tr><th width="100">구성 요소</th><th width="213">구분</th><th width="423">상세안내</th></tr></thead><tbody><tr><td>①</td><td>이미지 </td><td>• 파일형식 : jpg, png, jpeg / 최대 5MB<br>• 사이즈/용량 : <mark style="color:red;">가로 500px 이상 필수</mark><br>ㄴ 800x400 (2:1)<br>ㄴ 800x800 (1:1)<br>ㄴ 800x600 (4:3)<br>ㄴ 600x800 (3:4)<br><mark style="color:blue;">※ 캐러셀 1~6 영역의 이미지는 동일한 비율의 이미지 업로드 권장</mark></td></tr><tr><td></td><td>ㄴ 랜딩(선택)</td><td><p>• 랜딩 유형 : URL</p><p>- 클릭 추적 옵션 활성화 시 랜딩 필수</p></td></tr><tr><td>②</td><td>제목</td><td>띄어쓰기 포함 최대 20자</td></tr><tr><td>③</td><td>내용</td><td>띄어쓰기 포함 최대 180자</td></tr><tr><td>④</td><td>버튼(최대 2개)</td><td>• 띄어쓰기 포함 최대 8자<br>• 랜딩 유형 : 웹링크, 딥링크</td></tr><tr><td>⑤</td><td>쿠폰 강조 버튼</td><td>• 띄어쓰기 포함 최대 12자<br>• 랜딩 유형 : Mobile(필수), PC</td></tr></tbody></table>

### **캐러셀 3\~6 영역 (선택 입력)**

<table><thead><tr><th width="100">구성 요소</th><th width="213">구분</th><th width="423">상세안내</th></tr></thead><tbody><tr><td>①</td><td>이미지 </td><td>• 파일형식 : jpg, png, jpeg / 최대 5MB<br>• 사이즈/용량 : <mark style="color:red;">가로 500px 이상 필수</mark><br>ㄴ 800x400 (2:1)<br>ㄴ 800x800 (1:1)<br>ㄴ 800x600 (4:3)<br>ㄴ 600x800 (3:4)<br><mark style="color:blue;">※ 캐러셀 1~6 영역의 이미지는 동일한 비율의 이미지 업로드 권장</mark></td></tr><tr><td></td><td>ㄴ 랜딩(선택)</td><td><p>• 랜딩 유형 : URL</p><p>- 클릭 추적 옵션 활성화 시 랜딩 필수</p></td></tr><tr><td>②</td><td>제목</td><td>띄어쓰기 포함 최대 20자</td></tr><tr><td>③</td><td>내용</td><td>띄어쓰기 포함 최대 180자</td></tr><tr><td>④</td><td>버튼(최대 2개)</td><td>• 띄어쓰기 포함 최대 8자<br>• 랜딩 유형 : 웹링크, 딥링크</td></tr><tr><td>⑤</td><td>쿠폰 강조 버튼</td><td>• 띄어쓰기 포함 최대 12자<br>• 랜딩 유형 : Mobile(필수), PC</td></tr></tbody></table>

### **더보기 영역 (선택 입력)**

<table><thead><tr><th width="101">구성 요소</th><th width="214">구분</th><th>상세안내</th></tr></thead><tbody><tr><td>①</td><td>더보기(선택)</td><td>랜딩 유형 : Mobile(필수), PC, Android, iOS</td></tr></tbody></table>

## **6. 캐러셀 커머스형**

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FUSbv9dl6I4BGCQK9QNzt%2F%E1%84%8E%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AE%E1%84%90%E1%85%A9%E1%86%A8-%E1%84%8F%E1%85%A2%E1%84%85%E1%85%A5%E1%84%89%E1%85%A6%E1%86%AF%20%E1%84%8F%E1%85%A5%E1%84%86%E1%85%A5%E1%84%89%E1%85%B3%20%E1%84%8C%E1%85%A6%E1%84%8C%E1%85%A1%E1%86%A8%20%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3.png?alt=media&#x26;token=753d4130-0543-4bbd-b6a3-ff3fd6aa25bc" alt=""><figcaption><p>친구톡 - 캐러셀 커머스형 </p></figcaption></figure>

### **인트로 영역 (선택 입력)**

<table><thead><tr><th width="100">구성 요소</th><th width="213">구분</th><th width="423">상세안내</th></tr></thead><tbody><tr><td>①</td><td>이미지 </td><td>• 파일형식 : jpg, png, jpeg / 최대 5MB<br>• 사이즈/용량 : <mark style="color:red;">가로 500px 이상 필수</mark><br>ㄴ 800x400 (2:1)<br>ㄴ 800x800 (1:1)<br>ㄴ 800x600 (4:3)<br>ㄴ 600x800 (3:4)<br><mark style="color:red;">※ 모든 캐러셀 이미지는 동일한 비율의 이미지 업로드 필수</mark></td></tr><tr><td>②</td><td>홍보 제목</td><td>띄어쓰기 포함 최대 20자</td></tr><tr><td>③</td><td>홍보 문구</td><td>띄어쓰기 포함 최대 50자</td></tr><tr><td></td><td>ㄴ 캐러셀 랜딩(선택)</td><td>랜딩 유형 : Mobile(필수), PC, Android, iOS</td></tr></tbody></table>

### **캐러셀 영역 (인트로 제외 시 2개 필수 입력)**

{% hint style="danger" %}
캐러셀 커머스형에서 '공유하기'버튼은 지원하지 않습니다.&#x20;
{% endhint %}

<table><thead><tr><th width="100">구성 요소</th><th width="213">구분</th><th width="423">상세안내</th></tr></thead><tbody><tr><td>①</td><td>이미지 </td><td>• 파일형식 : jpg, png, jpeg / 최대 5MB<br>• 사이즈/용량 : <mark style="color:red;">가로 500px 이상 필수</mark><br>ㄴ 800x400 (2:1)<br>ㄴ 800x800 (1:1)<br>ㄴ 800x600 (4:3)<br>ㄴ 600x800 (3:4)<br><mark style="color:red;">※ 모든 캐러셀 이미지는 동일한 비율의 이미지 업로드 필수</mark></td></tr><tr><td></td><td>ㄴ 랜딩(선택)</td><td><p>• 랜딩 유형 : URL</p><p>- 클릭 추적 옵션 활성화 시 랜딩 필수</p></td></tr><tr><td>②</td><td>상품 제목</td><td>띄어쓰기 포함 최대 30자</td></tr><tr><td>③</td><td>정상 가격 </td><td>정수만 입력 가능(0 ~ 99,999,999)</td></tr><tr><td>④</td><td>할인 가격 (선택)</td><td>• 정수만 입력 가능(0 ~ 99,999,999)<br>※ 정상 가격 미만 값만 입력 가능</td></tr><tr><td></td><td>ㄴ 할인율(자동)</td><td>• 정상 가격과 할인 가격 입력 시 할인율 자동 계산<br>※ 소수점 이하 절사</td></tr><tr><td></td><td>ㄴ 정액 할인 가격(자동)</td><td>정상 가격과 할인 가격 입력 시 정액 할인 가격 자동 계산</td></tr><tr><td>⑤</td><td>부가 정</td><td>• 띄어쓰기 포함 최대 34<br>※ 개인화 변수 및 이모지 사용 가능</td></tr><tr><td>⑥</td><td>버튼(최대 2개)</td><td>• 띄어쓰기 포함 최대 8자<br>• 랜딩 유형 : 웹링크, 딥링크</td></tr><tr><td>⑦</td><td>쿠폰 강조 버튼</td><td>• 띄어쓰기 포함 최대 12자<br>• 랜딩 유형 : Mobile(필수), PC</td></tr></tbody></table>

### **더보기 영역 (선 입력)**

<table><thead><tr><th width="102">구성 요소</th><th width="213">구분</th><th>상세안내</th></tr></thead><tbody><tr><td>①</td><td>더보기(선택)</td><td>랜딩 유형 : Mobile(필수), PC, Android, iOS</td></tr></tbody></table>

## **브랜드 메시지 링크 유형**

카카오톡 메시지의 경우 아래의 사용자 행동을 결정할 수 있습니다.

{% tabs %}
{% tab title="웹링크" %}
**웹링크**

* 웹페이지로 이동할 수 있는 웹링크를 설정할 수 있습니다.
* 필요한 경우 개인화 변수를 입력하실 수 있습니다.
* http\://, <https://를> 모두 지원합니다.
* 웹링크는 클릭 추적이 가능하며, 캠페인 상세 리포트를 통해 확인 가능합니다. 클릭 추적이 필요할 경우 클릭 추적을 반드시 활성화(On) 해주시기 바랍니다.
* 클릭 추적 활성화시 클릭 추적을 위해 웹링크 내 #{변수} 입력이 제한됩니다.
* 링크 총 길이는 1,000자까지 가능하며, **#{변수}값이 치환됨에 따라** 총 길이를 초과하는 경우 발송이 실패할 수 있습니다.
  * 스킴 포함 인풋 내 최대 `1000`자까지 입력 가능(모든 버튼 타입 동일)
  * 링크 내 `#{변수}` 삽입 글자까지 포함
    * ex) `http://igaworks.com/XXX…XXX/#{변수}` → 1,000자 이하까지 입력 가능
      {% endtab %}

{% tab title="딥링크" %}
**딥링크**&#x20;

* 딥링크 설정시 앱, 마켓, 웹 페이지로 목적에 따라 랜딩 지점을 달리 할 수 있습니다.
* Android, iOS, Mobile은 필수 입력 사항이며, Scheme 영역 내 개인화 변수 입력이 불가합니다.
* 카카오 정책 상 딥링크 오픈 트래킹이 불가능하여, 클릭, 구매 및 커스텀 전환 추적이 불가능합니다.
* 링크 총 길이는 1,000자까지 가능하며, **#{변수}값이 치환됨에 따라** 총 길이를 초과하는 경우 발송이 실패할 수 있습니다.
  * 스킴 포함 인풋 내 최대 `1000`자까지 입력 가능(모든 버튼 타입 동일)
  * 링크 내 `#{변수}` 삽입 글자까지 포함
    * ex) `http://igaworks.com/XXX…XXX/#{변수}` → 1,000자 이하까지 입력 가능
      {% endtab %}
      {% endtabs %}

### 쿠폰 강조 버튼 링크

{% hint style="info" %}
**'쿠폰 강조 버튼' 설정 방법 안내**

> 1. \[카카오톡 비즈니스 채널 관리자센터]에 접속해 **비즈니스 도구 > 쿠폰 작성** 메뉴에서 쿠폰을 생성합니다.
> 2. 쿠폰 목록에서 원하는 쿠폰의 **상세 페이지**로 이동합니다.
> 3. 쿠폰 상세 페이지에서 **\[URL 복사]** 버튼을 클릭해 쿠폰 링크를 복사합니다.
> 4. 디파이너리 콘솔에서 **쿠폰 강조 버튼**을 설정한 후, 링크 연결의 Mobile 입력란에 복사한 쿠폰 링크를 붙여넣습니다.
>    {% 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.dfinery.ai/user-guide/action/off-site-campaign/kakao-talk/undefined/undefined-1.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.