# 친구톡 발송하기

### 📢 **친구톡 API 종료 안내** 

{% hint style="warning" %}
카카오 광고메시지 채널 ‘**친구톡**’ 서비스가 **2025년 12월 31일**부로 종료됩니다. 

카카오의 새로운 광고 메시지 채널인 ‘**브랜드 메시지**’ 신규 서비스를 준비중이며, **2025년 12월 23일** 업데이트 예정입니다.

\
친구톡 캠페인 생성 및 발송은 **25년 12월 31일 23시 59분** 까지 정상 동작되며, \
친구톡 캠페인 리포트 확인은 **26년 1월 8일**까지 가능합니다.

\
위 내용 참고하여, 운영 예정인 캠페인 집행 시 고려 부탁드립니다.

관련 궁금하시거나 자세한 안내 사항은 <dfn@igaworks.com>을 통해 문의 부탁드립니다.

감사합니다.
{% endhint %}

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2F1zCPsoJc3Mcnn10pEafU%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%20%E1%84%83%E1%85%A2%E1%84%91%E1%85%AD%E1%84%8B%E1%85%B5%E1%84%86%E1%85%B5%E1%84%8C%E1%85%B5.png?alt=media&#x26;token=b7dd5e30-d4b6-4b23-bbe2-c919f85b9e40" alt=""><figcaption></figcaption></figure>

## **시작하기 전에**

카카오 친구톡 발송을 위해서는 카카오톡 발신 프로필이 있어야 합니다. 발신 프로필 등록과 관련한 자세한 내용은 \
[카카오톡 발신 프로필 설정하기](https://docs.dfinery.ai/user-guide/action/off-site-campaign/kakao-talk/setting-profile) 아티클을 참고해 주세요.&#x20;

## **친구톡 메시지 작성하기**&#x20;

알림톡은 별도의 템플릿을 사전에 생성하고 불러와서 메시지를 보낼 수 있지만, 친구톡은 콘솔에서 캠페인별로 직접 메시지를 작성하고 발송해야 합니다. 즉, **친구톡은 템플릿 없이 콘솔에서 실시간으로 캠페인을 생성·운영**하는 형태로 제공됩니다.

### **친구톡 유형 선택**

친구톡 메시지의 경우 6가지 유형으로 제공되며, 와이드 아이템 리스트, 캐러셀 피드, 캐러셀 커머스형의 경우 (광고) 표기가 필수입니다. 캠페인 목적과 타겟에 맞춰 다양한 친구톡 메시지를 전송해보세요.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FPezttfrZSZtdxeX0qxqb%2F%E1%84%90%E1%85%A6%E1%86%B7%E1%84%91%E1%85%B3%E1%86%AF%E1%84%85%E1%85%B5%E1%86%BA.png?alt=media&#x26;token=5803bb97-e7f7-4ba4-8f4d-10c15f5a66b6" alt="" width="563"><figcaption></figcaption></figure>

#### **텍스트** <a href="#undefined" id="undefined"></a>

텍스트 + 버튼으로 이루어진 기본 상품입니다. 한/영 구분없이 띄어쓰기 포함 1,000자 + 링크버튼 최대 5개 (세로 배열) 지원합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FoJcn4GvbuPegkvoVb3oC%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.png?alt=media&#x26;token=8e6f1d71-b3a2-4509-9880-aa547faf34ae" alt=""><figcaption></figcaption></figure>

#### **이미지**

텍스트 + 이미지 + 버튼으로 이루어진 기본 상품입니다. 한/영 구분없이 띄어쓰기 포함 400자 + 이미지 1장 + 링크버튼 최대 5개 (세로 배열) 지원합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FF5TQ47cKpkrUyFy8x57g%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.png?alt=media&#x26;token=cad44788-bae5-4a0a-89a3-62bcf1df0859" alt=""><figcaption></figcaption></figure>

#### **와이드 이미지**

와이드 이미지와 버튼 최대 2개가 들어간 상품입니다. 한/영 구분없이 띄어쓰기 포함 76자 + 이미지 1장 + 링크버튼 최대 2개 (가로 정렬) 지원합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FgfQoGayysLM5FsdcOKhf%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.png?alt=media&#x26;token=dcd01f00-7255-44d0-8aec-2a50fe757121" alt=""><figcaption></figcaption></figure>

#### **와이드 아이템 리스트 (광고 표기 필수)**

최소 3개의 리스트 (이미지 + 아이템) 추가가 가능한 상품입니다. 제목 20자, 내용 25자 \~ 30자 + 리스트당 이미지 1장 첨부 + 링크버튼 최대 2개 (가로 정렬) 지원합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FSktwNSuJ3ck13urpMNXK%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.png?alt=media&#x26;token=324b7b9e-b914-448a-960f-de7e96eb6e2a" alt=""><figcaption></figcaption></figure>

#### **케러셀 피드 (광고 표기 필수)**

최대 10개까지의 이미지와 다양한 텍스트 정보를 담을 수 있는 상품입니다. 제목 20자, 본문 180자 + 캐러셀당 이미지 1장 첨부 + 링크버튼 최대 2개 (가로 정렬) + 더보기 버튼 지원합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FkwGISOb0FZOe14tiBo3w%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.png?alt=media&#x26;token=09afbaa6-34e5-4e1d-9eea-1ea2c25e404f" alt=""><figcaption></figcaption></figure>

#### **캐러셀 커머스 (광고 표기 필수)**

최대 10개까지의 이미지와 가격 정보를 담을 수 있는 상품입니다. 인트로를 설정할 수 있으며 각 캐러셀은 이미지 + 가격정보 + 링크버튼 최대 2개(가로 정렬) + 더보기 버튼 지원합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FnyLTleL1yka4x0kGe0sq%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.png?alt=media&#x26;token=44983544-d21e-42f0-bfdb-c73adbc49615" alt=""><figcaption></figcaption></figure>

### **메시지 세팅하기**

메시지 작성을 위한 세부 가이드는 아래 링크를 참고해 주세요.&#x20;

{% content-ref url="undefined-1" %}
[undefined-1](https://docs.dfinery.ai/user-guide/action/off-site-campaign/kakao-talk/friend-talk/undefined-1)
{% endcontent-ref %}

### **스케줄 설정하기**&#x20;

오프사이트 캠페인은 발송 타입에 따라서 스케줄 설정에 차이가 있습니다.

{% hint style="danger" %}
친구톡 메시지는 정보성 또는 광고성에 관계없이 전송 시간이 제한됩니다. (20:00 \~ 익일 오전 08:00 발송 제한)
{% endhint %}

{% tabs %}
{% tab title="한 번 발송" %}
‘한 번 발송’ 타입을 선택하면, 원하는 발송 일시를 지정할 수 있습니다. 이때 발송 일시는 설정 시점으로부터 1시간 이후부터 선택해야 합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FywTOcELlvuE8QMKHOSAL%2F%EC%A0%95%EB%B3%B4%EC%84%B1.png?alt=media&#x26;token=700a0c03-a617-49c4-b96b-dc702a73862d" alt=""><figcaption></figcaption></figure>

스케줄 설정에서는 피로도 관리(글로벌 피로도 설정) 적용 여부를 선택할 수 있습니다. 피로도 관리는 채널 단위로 적용되며, '친구톡' 전체 채널에 대한 메시지 발송이 설정한 기준에 따라 제한됩니다.
{% endtab %}

{% tab title="트리거 발송" %}
‘트리거 발송’ 타입을 선택하면, 원하는 운영 기간을 지정할 수 있습니다. 이때 운영 기간은 최대 1년까지 설정할 수 있으며, 트리거 발송은 기간 단위로 운영되기 때문에 반드시 ‘방해 금지 시간’이 필수로 설정됩니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FsHVzApHMzT5L6wy1PG6H%2F%EA%B4%91%EA%B3%A0%EC%84%B1.png?alt=media&#x26;token=f3a5c12b-1037-4b92-9849-1e8dbcce49db" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**발송 대기 시간**

* 유저가 특정 조건을 달성시 발송하고자 하는 해당 메시지의 대기 시간을 입력합니다.
* 종료 이벤트 설정 시 대기 시간 동안 종료 이벤트를 수행한 유저에게는 캠페인이 발송되지 않습니다.

**친구톡 방해 금지 시간**

* 방해 금지 시간 설정은 20:00 \~ 08:00으로 고정되며, 건너뛰기 및 발송하지 않기 옵션을 선택할 수 있습니다.
  {% endhint %}
  {% endtab %}
  {% endtabs %}

### **타겟 설정하기**&#x20;

친구톡을 발송할 타겟을 설정합니다. 타겟 설정도 스케줄 설정과 마찬가지로 발송 타입에 따라서 타입 설정에 차이가 있습니다.

{% tabs %}
{% tab title="한 번 발송" %}
‘한 번 발송’ 타입을 선택하면, 특정 오디언스를 선택하거나 직접 필터를 지정하여 발송 대상을 설정할 수 있습니다. 더 정교한 타겟팅이 필요한 경우, 미리 생성된 오디언스를 선택하는 것을 권장합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2Ffps8Ec0cvczzoHZWphB4%2Fimage.png?alt=media&#x26;token=1035e932-ec87-4e47-9191-5db799f1078f" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="트리거 발송" %}
‘트리거 발송’ 타입을 선택하면, 전체 대상에게 캠페인을 운영하거나, 특정 오디언스를 선택하여 발송 대상을 지정할 수 있습니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FP2FwISzSfoQlYdHP6Viq%2Fimage.png?alt=media&#x26;token=8533525e-27de-47fb-b4cc-26f744343cc7" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### **전환 설정하기**&#x20;

구매 전환 및 커스텀 전환 추적을 설정할 수 있습니다. 전환 추적을 위해서는 **메시지 설정에서 반드시 하나 이상의 클릭 액션을 지정**해야 합니다. 본문에 링크를 삽입하거나, 버튼 또는 이미지에 링크를 추가해주시기 바랍니다.

구매 전환 추적에 대한 자세한 내용은 ‘[구매 전환 기간 설정](https://docs.dfinery.ai/user-guide/action/conversion_setting)’ 문서를 참고해주시기 바랍니다.

커스텀 전환 추적은 구매 전환과 별도로, 추적이 필요한 이벤트를 최대 4개까지 추가할 수 있는 기능입니다. 필요에 따라 원하는 이벤트를 선택적으로 등록해주시기 바랍니다.

## **개인화 변수 설정하기**

개인화 변수란, 메시지나 콘텐츠 내에서 각 사용자(수신자)에게 맞춤형 정보를 자동으로 삽입할 수 있도록 도와주는 일종의 "**치환 변수**"입니다. 예를 들어, 수신자의 이름, 휴대전화 번호, 가입일, 적립 포인트 등 각기 다른 고객 정보를 메시지에 자동으로 반영할 수 있습니다.

**예시 상황**

* 메시지 원문: `{이름}`님, 이번 달 적립 포인트는 `{포인트}`점입니다!
* 사용자 A에게 발송: `홍길동`님, 이번 달 적립 포인트는 `1,500점`입니다!
* 사용자 B에게 발송: `김철수`님, 이번 달 적립 포인트는 `3,200점`입니다!

친구톡의 개인화 변수는 발송 타입에 따라 설정할 수 있는 속성이 다릅니다.

* 한 번 발송 : 유저 프로필 속성
* 트리거 발송 : 유저 프로필 속성, 이벤트 속성
  * 이벤트 속성의 경우, 선택한 트리거 이벤트의 하위 속성으로만 개인화 변수를 설정할 수 있습니다.

#### 친구톡 텍스트 개인화 사용 안내

개인화 변수는 아래 항목에서 활용할 수 있습니다. <mark style="color:red;">(※ 모든 유형의 버튼명에서는 개인화 변수를 사용할 수 없습니다.)</mark>

<table><thead><tr><th width="262">친구톡 유형</th><th width="258">위치</th><th width="106">사용 가능 여부</th></tr></thead><tbody><tr><td>텍스트</td><td>메시지</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>이미지</td><td>메시지</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>와이드 이미지</td><td>메시지</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>와이드 아이템 리스트</td><td>상단 제목, 제목</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>캐러셀 피드</td><td>제목, 내용</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>캐러셀 커머스 / 인트로</td><td>홍보 제목, 홍보 문구</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>캐러셀 커머스</td><td>상품 제목</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>캐러셀 커머스</td><td>가격 정보, 할인 가격 정보</td><td>사용불가</td></tr></tbody></table>

#### 친구톡 링크 영역 변수 사용 안내&#x20;

개인화 변수는 아래 항목에서 활용할 수 있습니다. <mark style="color:red;">(※ 링크 클릭 추적 활성화 시 개인화 변수는 사용할 수 없습니다.)</mark>

<table><thead><tr><th width="262">링크 구분</th><th width="258">구성</th><th width="106">사용 가능 여부</th></tr></thead><tbody><tr><td>웹링크</td><td>Mobil, PC(선택)</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>딥링크</td><td>Android, iOS</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>딥링크</td><td>Mobil, PC(선택)</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>구매하기 버튼</td><td>Mobil, PC(선택)</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td></tr><tr><td>쿠폰 강조 버튼</td><td>-</td><td>미지원</td></tr></tbody></table>

## **친구톡 성과 확인하기**&#x20;

{% hint style="info" %}
캐러셀형 메시지의 경우 각 캐러셀별 성과 뿐만 아니라 캐러셀 내 이미지, 버튼 등 개별 요소별 성과도 확인할 수 있습니다.&#x20;
{% endhint %}

### **발송 성과**&#x20;

발송된 친구톡 메시지의 통계 데이터를 확인할 수 있습니다. 메시지 발송 후 <mark style="background-color:purple;">**클릭 수치를 집계하려면 반드시 클릭 추적 기능을 활성화해야 합니다.**</mark>

<table><thead><tr><th width="175">확인 가능한 지표</th><th width="576">설명</th></tr></thead><tbody><tr><td>발송 대상</td><td>메시지는 통합 ID 기준으로 선정된 1개 번호(가장 최근에 수집된 정보)로 발송됩니다.</td></tr><tr><td>발송 성공</td><td>실제 메시지 발송 후 ‘성공’ 응답을 받은 건수입니다.</td></tr><tr><td>클릭</td><td>클릭 추적 기능이 활성화된 경우, 해당 부분에서 발생한 클릭 수를 집계한 수치입니다.</td></tr><tr><td>클릭률</td><td>발송 성공 건수 대비 클릭이 발생한 비율입니다.</td></tr><tr><td>발송 비용</td><td>채널별 단가에 발송 성공 건수를 곱해 계산한 금액입니다.</td></tr></tbody></table>

### **전환 성과**&#x20;

기여 기간 내에 발생한 전환 이벤트의 통계 데이터를 확인할 수 있습니다. 전환 성과를 확인하려면 메시지 설정 시 전환 추적 기능을 활성화해야 하며, <mark style="background-color:purple;">**전환 집계는 '클릭'을 기준으로 산정됩니다.**</mark> 따라서 캠페인 내에서 클릭 추적이 활성화된 요소가 최소 1개 이상 포함되어 있어야 합니다.

<table><thead><tr><th width="173">확인 가능한 지표</th><th width="544">설명</th></tr></thead><tbody><tr><td>구매 전환</td><td>기여 기간 내 구매 이벤트가 발생한 횟수입니다.</td></tr><tr><td>구매 금액</td><td>기여 기간 내 발생한 구매 이벤트의 누적 금액입니다.</td></tr><tr><td>ROAS</td><td>발송 비용 대비 구매 금액의 비율입니다.</td></tr><tr><td>전환 이벤트 A~D</td><td>기여 기간 내 설정한 전환 이벤트가 발생한 수 및 비율입니다.</td></tr></tbody></table>

### **클릭 추적 설정**

클릭 추적은 버튼 또는 이미지에 웹링크 연결 시에만 적용되며, 딥링크 연결에는 클릭 집계가 제공되지 않습니다.

{% hint style="info" %}
**딥링크 연결이 필요한 경우 아래 절차에 따라 진행해 주세요.**

1. 사용자를 중간 리다이렉트 페이지로 안내한 후 해당 페이지에서 다시 **딥링크로 리다이렉트** 처리해야 합니다.
2. 이때 Shorten URL이 실제 딥링크 주소로 **리다이렉트**됩니다.
3. 사용자가 버튼을 클릭하면, 해당 **Shorten URL**로 접근하게 됩니다.
   {% endhint %}