# 친구톡 발송하기

## 친구톡 메시지 유형

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

<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 %}


---

# 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://document.wisetracker.co.kr/crm/kakao-sms/friendtalk.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.