> 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="/files/1kYze2D3BMivRz2KKQrM" 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="/files/yMXY1lGnI9pLkvRFPogW" 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="/files/Ftw03qMVzgofjAWrOl1L" 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="/files/5ArKKMqr6uvt2nkNvirZ" 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="/files/VqC1h1MFE8QZdOY44QcV" alt=""><figcaption></figcaption></figure>

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

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

**② 템플릿 태그**

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

{% endstep %}

{% step %}

### 내용 입력

<figure><img src="/files/3EJ5nxehsCQsOSGLAwZ1" 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="/files/DmTNEAbqXUzWNglIqO4g" 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="/files/ecKP9Q7FfY4BYVZQfuEh" alt="" data-size="original"></p><p>버튼(링크) 클릭 및 메시지에 대한 반응 성과를 확인하고 싶다면, <code>추적용 URL로 변경</code> 버튼을 클릭해주세요. 캠페인명을 입력하여 <mark style="background-color:orange;"><code>변환</code></mark> 을 클릭합니다.<br><br><img src="/files/kKFEVFD8ozE7Y0aF9skF" alt="" data-size="original"><br><br>아래와 같이 트래킹 링크로 변환된 것을 확인할 수 있어요!</p><p><br><img src="/files/Nbycx80gnguwWYx1xXQ6" 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="/files/NUipTP1QuEHj9q7IpOYY" 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="/files/h4oQBWe9yIVHrStlRBTj" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/BrHEgPcRJJS4CnCNW2dY" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

<figure><img src="/files/z6dY1RIoCGDa2pHzjJjy" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### API 연동

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

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

<div align="left"><figure><img src="/files/VOZuhB41hAwalG3J348c" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}