> For the complete documentation index, see [llms.txt](https://document.wisetracker.co.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://document.wisetracker.co.kr/crm/kakao-sms/friendtalk.md).

# 친구톡 발송하기

## 친구톡 메시지 유형

### ▪️ 기본형 (이미지형)

<div align="center"><figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FNXa99CJbVfLHre2lmTzE%2Fimage.png?alt=media&amp;token=ab2904a2-502f-4b66-8812-a71a7e3121dd" alt="" width="375"><figcaption><p>친구톡 기본형(이미지형)</p></figcaption></figure></div>

**✴️텍스트 + 버튼**&#x20;

* 한/영 구분없이 띄어쓰기 포함 1,000자 + 링크버튼 최대 5개 (세로 배열)

**✴️텍스트 + 이미지 + 버튼**

* 한/영 구분없이 띄어쓰기 포함 400자 + 이미지 1장 + 링크버튼 최대 5개 (세로 배열)

<mark style="background-color:yellow;">**🖼️ 이미지 규격**</mark>

<table data-header-hidden><thead><tr><th width="177"></th><th></th></tr></thead><tbody><tr><td><strong>파일형식</strong></td><td>JPG, PNG</td></tr><tr><td><strong>용량</strong></td><td>최대 500KB</td></tr><tr><td><strong>사이즈</strong></td><td><strong>가로 500px 이상</strong></td></tr></tbody></table>

***

### ▪️ 이미지 와이드형

<div align="center"><figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FZqhQcrrMWPYSACjR95Vz%2Fimage.png?alt=media&amp;token=54d55f96-67f9-456c-ad2f-79b5d56c43f8" alt="" width="375"><figcaption></figcaption></figure></div>

* 한/영 구분 없이 띄어쓰기 포함 76자 텍스트 + 이미지 1장 + 링크 버튼 1개

<mark style="background-color:yellow;">**🖼️ 이미지 규격**</mark>

<table data-header-hidden><thead><tr><th width="177"></th><th></th></tr></thead><tbody><tr><td><strong>파일형식</strong></td><td>JPG, PNG</td></tr><tr><td><strong>용량</strong></td><td>최대 2MB</td></tr><tr><td><strong>사이즈</strong></td><td><strong>800x600 px</strong></td></tr></tbody></table>

***

### ▪️ 와이드 아이템리스트형

<div align="center"><figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FLDUhWENrVpfCzYlU1UeJ%2Fimage.png?alt=media&amp;token=45970211-b74f-449f-82a2-c02b75e282f6" alt="" width="375"><figcaption></figcaption></figure></div>

* 이미지 아이템 최대 4개 (타이틀 포함하여 아이템 3개 필수) + 링크 버튼 최대 2개 (가로정렬)

<mark style="background-color:yellow;">**⌨️ 글자수**</mark>

<table><thead><tr><th width="204">구성요소</th><th>글자수 제한 (한/영 구분 없이 띄어쓰기 포함)</th></tr></thead><tbody><tr><td>타이틀 (헤더)</td><td>최대 <strong>25</strong>자</td></tr><tr><td>리스트 1 타이틀</td><td>최대 <strong>25</strong>자</td></tr><tr><td>리스트 2~4 타이틀</td><td>최대 <strong>30</strong>자</td></tr><tr><td>버튼명</td><td>최대 <strong>8</strong>자</td></tr></tbody></table>

<mark style="background-color:yellow;">**🖼️ 이미지 규격**</mark>

<table data-header-hidden><thead><tr><th width="206"></th><th></th></tr></thead><tbody><tr><td><strong>파일형식</strong></td><td>JPG, PNG</td></tr><tr><td><strong>용량</strong></td><td>최대 2MB</td></tr><tr><td><strong>리스트 1 이미지 사이즈</strong></td><td><strong>800x400 px (2:1 비율)</strong></td></tr><tr><td><strong>리스트 2~4 이미지 사이즈</strong></td><td><strong>400x400 px (1:1 비율)</strong></td></tr></tbody></table>

***

### ▪️ 캐러셀피드형

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FpUVFWa67O9znF8V26UIK%2Fimage.png?alt=media&amp;token=4b08386a-c0a8-4ae9-94ff-d1a6aedce762" alt=""><figcaption></figcaption></figure>

* 캐러셀 아이템 최대 6개 (아이템 2개 필수) + 아이템당 링크 버튼 최대 2개 (가로정렬, 1개 필수) + 더보기 버튼 (선택)

<mark style="background-color:yellow;">**⌨️ 글자수**</mark>

<table><thead><tr><th width="204">구성요소</th><th>글자수 제한 (한/영 구분 없이 띄어쓰기 포함)</th></tr></thead><tbody><tr><td>캐러셀 제목</td><td>최대 <strong>20</strong>자 *링크 입력 불가</td></tr><tr><td>캐러셀 메시지</td><td>최대 180자</td></tr><tr><td>버튼명</td><td>최대 <strong>8</strong>자</td></tr></tbody></table>

<mark style="background-color:yellow;">**🖼️ 이미지 규격**</mark>

<table data-header-hidden><thead><tr><th width="206"></th><th></th></tr></thead><tbody><tr><td><strong>파일형식</strong></td><td>JPG, PNG</td></tr><tr><td><strong>용량</strong></td><td>최대 2MB</td></tr><tr><td><strong>사이즈</strong></td><td><strong>800x400 px (2:1 비율)</strong><br><strong>800x600 px (4:3 비율)</strong><br><strong>*캐러셀에 사용되는 모든 이미지는 동일한 비율의 이미지로 등록 필요</strong></td></tr></tbody></table>

***

## ✍🏻 친구톡 템플릿 생성하기 <a href="#template" id="template"></a>

{% hint style="info" %}
메시지 유형과 관계없이 필수로 입력해야 하는 항목들에 대한 안내사항을 기재하였으며,

메시지 유형별 필요 항목들에 대한 기준은 [#undefined](#undefined "mention") 을 참고해주세요.
{% endhint %}

{% stepper %}
{% step %}

### 기본 설정

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FGEycB4K9e0A5p0K0Rz1a%2Fimage.png?alt=media&amp;token=394329f1-ed03-4dd8-9a1c-7b719c0712e6" alt=""><figcaption></figcaption></figure>

**① 템플릿 이름** <mark style="color:red;">`필수`</mark>

* 템플릿 이름을 지정해주세요.

**② 템플릿 태그**

* 해시태그처럼 사용할 태그명을 입력하면 템플릿 관리 페이지에서 원하는 태그만 선택하여 볼 수 있습니다.

{% endstep %}

{% step %}

### 내용 입력

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FDdDUelSGVDsTZJ1Powbp%2Fimage.png?alt=media&amp;token=1644844e-0c86-4c33-ba58-050724657fc8" alt=""><figcaption></figcaption></figure>

**① 템플릿 유형** <mark style="color:red;">`필수`</mark>&#x20;

* 발송하고자 하는 메시지 유형을 선택해주세요.

> **메시지 유형** : 기본형(이미지) / 이미지 와이드형 / 와이드 아이템리스트형 / 캐러셀피드형

{% hint style="info" %}
각 메시지 유형에 대한 자세한 설명은 [#undefined](#undefined "mention") 을 참고해주세요.
{% endhint %}

**② 광고 표현**

* 광고 메시지 작성 시 반드시 [**주의사항**](/tracking-management/ad-agency.md)을 참고해주세요.
* 메시지 내용에 광고를 포함할 경우 반드시 광고 표현을 선택해주세요.
* “광고” 선택 시 카카오톡 채널명 좌측에 (광고) 가 표시됩니다.
* 와이드 아이템리스트형, 캐러셀피드형 선택 시 "(광고)" 표기는 필수로 적용됩니다.

**③ 채널 선택** <mark style="color:red;">`필수`</mark>

* 발송할 채널을 선택해주세요.

**④ 본문 입력** <mark style="color:red;">`필수`</mark>

{% hint style="info" %}
기본형(이미지), 이미지 와이드형 메시지 작성 시에만 해당합니다.
{% endhint %}

* 전달해야하는 정보 메시지를 작성합니다.
* 한/영 구분없이 1,000자까지 입력 가능합니다.
* 개인화된 텍스트 영역은 #{변수}로 작성할 수 있습니다.
  * 우측 상단의 + 버튼 을 통해 공통 속성 (서비스명 / 웹사이트주소)을 빠르게 붙여넣거나, 유저 속성을 커스텀 변수로 활용할 수 있습니다.

{% hint style="success" %}
**유저 속성 변수로 사용하기**

[/pages/Pq18q0Rppor1OxuOyZM9#step-1.-greater-than](https://document.wisetracker.co.kr/crm/kakao-sms/pages/Pq18q0Rppor1OxuOyZM9#step-1.-greater-than "mention")

*오디언스 > 유저 관리 >* `유저 리스트` 에서 변수로 사용하고자 하는 유저 속성을 정의합니다.

[/pages/Pq18q0Rppor1OxuOyZM9#step-2.-greater-than](https://document.wisetracker.co.kr/crm/kakao-sms/pages/Pq18q0Rppor1OxuOyZM9#step-2.-greater-than "mention")

유저 속성에 따른 값이 올바르게 수집되어 활용할 수 있도록 유저 데이터를 연동합니다.
{% endhint %}

{% hint style="info" %}
와이즈트래커에서 관리하는 유저 속성의 경우 변수로 작성하고자 하는 유저 속성을 선택하면 자동으로 "`#{유저속성1}`" 형식으로 입력됩니다.

API 메시지 발송 시 와이즈트래커 내 유저 속성으로 관리하지 않는 값을 변수로 작성하고자 한다면, `# {유저속성}` 형식에 맞게 작성하여 활용해주세요.&#x20;
{% endhint %}

{% hint style="danger" %}

* 메세지 발송시 등록된 속성값이 없는 경우에는 공란으로 발송될 수 있으니 주의하여 사용해주시기 바랍니다.
* 분석서비스와의 연동을 통해 오디언스를 대상으로 발송하는 경우, 업로드된 유저 데이터와 setUser 를 통해 수집된 유저 데이터가 페어링 되어야 유저 속성을 변수로 활용할 수 있습니다. [분석서비스와의 연동](/audience/user-management/analytics-crm-sync.md)
  {% endhint %}
  {% endstep %}

{% step %}

### 버튼 설정

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2F3ovihsjspQrIKUUuKm7Z%2Fimage.png?alt=media&amp;token=f19b4d62-b19e-46af-8d9b-4ca188a28e82" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
친구톡은 메시지 유형별로 추가할 수 있는 버튼 수가 다릅니다.

[#undefined](#undefined "mention") 을 참고해주세요.
{% endhint %}

<table><thead><tr><th width="152">버튼 유형</th><th>설정 방법</th></tr></thead><tbody><tr><td>웹링크 버튼</td><td><p>고객이 버튼을 클릭했을 때 웹(PC/모바일) 으로 이동합니다.</p><ul><li>모바일 웹 URL 과PC 웹 URL 모두 필수 입력</li><li>http 또는 https 로 시작하는 URL 입력</li></ul><p><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FVwDwREswOp0uyViQErJ9%2Fimage.png?alt=media&amp;token=5b83a53a-4403-4a48-afac-f680bf54b163" alt="" data-size="original"></p><p>버튼(링크) 클릭 및 메시지에 대한 반응 성과를 확인하고 싶다면, <code>추적용 URL로 변경</code> 버튼을 클릭해주세요. 캠페인명을 입력하여 <mark style="background-color:orange;"><code>변환</code></mark> 을 클릭합니다.<br><br><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FfeS0f5NtznqDFRG1uTTr%2Fimage.png?alt=media&amp;token=f10c4cbd-1ff0-47e1-9b9f-5f01f4fa6269" alt="" data-size="original"><br><br>아래와 같이 트래킹 링크로 변환된 것을 확인할 수 있어요!</p><p><br><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2F8T8Co3kNkwtNxirwHYX7%2Fimage.png?alt=media&amp;token=d551ac51-7b1a-45b3-9405-8d9ed505fba9" alt="" data-size="original"><br><br>위의 캡쳐 화면을 예시로, 해당 버튼(링크) 클릭을 통해 발생한 데이터는 <code>카카오 알림톡</code> 채널의 <code>회원가입 알림톡 웹사이트 이동</code> 캠페인 성과로 인정됩니다.</p></td></tr><tr><td>앱링크 버튼</td><td><p>고객이 버튼을 클릭했을 때 앱(AOS/iOS) 으로 이동합니다.</p><ul><li>AOS, iOS 각 스키마 형태에 맞게 입력</li></ul></td></tr></tbody></table>
{% endstep %}
{% endstepper %}

👀 이제 템플릿 작성이 완료되었다면, <mark style="background-color:orange;">`템플릿 저장`</mark> 버튼을 눌러 주세요.

***

## 💌친구톡 발송하기

### 일반 메시지 발송

{% hint style="info" %}
*마케팅 오토메이션 > 메시지 관리 >* 알림톡 > `친구톡 보내기` 를 클릭합니다.
{% endhint %}

{% stepper %}
{% step %}

### 기본 설정

[메시지 발송 시 공통 안내사항](/crm/kakao-sms/how-to-send.md#undefined)

{% endstep %}

{% step %}

### 템플릿 설정 및 메시지 유형에 맞는 내용 입력

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FjI6qeVaoxnTTypHo6RC7%2Fimage.png?alt=media&amp;token=2f78e842-44c0-43bc-9f1b-2d156f139e03" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
메시지를 발송하고자 하는 템플릿을 미리 생성하였다면, 템플릿을 선택해주세요.

템플릿을 선택하여 내용을 수정하는 것도 가능하며, 미리 생성한 템플릿이 없다면 새롭게 작성해주시면 됩니다. 😸
{% endhint %}

자세한 내용 입력 방법은 [`✍🏻 친구톡 템플릿 생성하기`](#undefined-5) 를 참고해주세요.
{% endstep %}

{% step %}

### 부가옵션 설정

[메시지 발송 시 공통 안내사항](/crm/kakao-sms/how-to-send.md#undefined-2)
{% endstep %}
{% endstepper %}

메시지 작성이 완료되었다면, <mark style="background-color:orange;">`메시지 발송`</mark> 버튼을 눌러 주세요.

***

### API 메시지 발송

{% hint style="info" %}
*마케팅 오토메이션 > 메시지 관리 >* 친구톡 > `API 전용 친구톡 메시지 생성` 을 클릭합니다.
{% endhint %}

{% stepper %}
{% step %}

### API 전용 메시지 저장

기존에 생성한 템플릿을 선택하거나, 새로운 메시지를 작성하여 저장합니다.

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FwQFzmYxMpgFvRmQCcNPz%2Fimage.png?alt=media&amp;token=c985f6dd-e099-4af8-a9c2-1b823bace101" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FIv75oP0WCCmB3A4F2x87%2Fimage.png?alt=media&amp;token=0aa070ec-b145-48a7-892f-3a0ad4c5ea9f" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### API 메시지 발송 안내 확인

저장한 메시지는 메시지 리스트에서 확인 가능하며, `API 조회` 버튼 클릭을 통해 안내 가이드를 확인해주세요.

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FrCLiiP2nks8b72V5zxGI%2Fimage.png?alt=media&amp;token=04273c6a-8972-4104-a079-32b4760d41f8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### API 연동

{% hint style="info" %}
아래 내용을 개발 담당자에게 전달하여,

적절한 시점에 메시지가 발송될 수 있도록 개발해주세요. 🧑🏻‍💻
{% endhint %}

<div align="left"><figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FAnJGm2hh28lsbZbUCnVz%2Fimage.png?alt=media&amp;token=9abb86c1-29a4-4a11-8f26-1eff2732e485" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}