> For the complete documentation index, see [llms.txt](https://docs.groobee.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.groobee.ai/new-admin/kakao-brandmessage/kakao-brandmessage-create/schedule.md).

# 스케줄 발송

지정한 발송 일시에 **1회 발송**하거나, 설정한 반복 주기에 따라 타겟 고객에게 메시지를 **정기적으로 발송**하는 방식입니다.

## **1단계: 기본 설정**

<figure><img src="/files/b826xr8RFhq4r3SESG5a" alt=""><figcaption></figcaption></figure>

### **1. 기본 설정**

<figure><img src="/files/oH8OKJiIpPykTLVCOTnU" alt=""><figcaption></figcaption></figure>

* **캠페인명:** 캠페인의 이름을 입력해 주세요. (문자 구분 없이 최대 40자 입력 가능)
* **상세 설명:** 필요시 캠페인에 대한 상세 설명을 입력해 주세요. (문자 구분 없이 최대 400자 입력 가능)
* **태그 #:** 캠페인에 태그를 설정해 주세요. 캠페인 리스트에서 태그 필터를 통해 캠페인을 필터링할 때 활용됩니다.

### **2. 타겟 설정**

<figure><img src="/files/xF5DExpw95MpgcivGph3" alt=""><figcaption></figcaption></figure>

#### **2-1. 타겟팅 유형**

메시지를 발송할 타겟을 설정해 주세요.&#x20;

* **모든 회원:** 가입된 전체 회원을 타겟으로 설정합니다.
* **세그먼트:** 미리 생성해 둔 세그먼트를 불러와 해당 조건에 부합하는 고객을 타겟으로 설정합니다.
* **직접 업로드:** 발송할 고객의 전화번호 목록(CSV 파일)을 직접 업로드하여 타겟을 설정합니다.

{% hint style="warning" %}
**모든 회원** 또는 **세그먼트**를 대상으로 발송하려면, 회원 데이터 연동이 필요합니다. **\[설정 > 회원 정보 연동]**&#xC744; 확인해 주세요.
{% endhint %}

{% hint style="info" %}

* 직접 업로드 시 템플릿 파일을 다운로드한 후, [**도움말**](/new-admin/notes/member-upload.md)을 참고하여 작성해 주세요.
* 업로드된 파일은 캠페인이 **\[발송 완료]** 탭으로 이동한 날로부터 31일간 보관되며, 이후에는 보안을 위해 자동 삭제되어 재사용이 불가능합니다.
  {% endhint %}

#### **2-2. 발송 대상**

설정한 타겟 내에서, 카카오톡 채널 친구 여부 및 광고성 정보 수신 동의 여부에 따라 최종 발송 대상을 선별합니다.

<figure><img src="/files/ofcvQiwgJBdOXal3MEks" alt=""><figcaption></figcaption></figure>

* **채널 친구:** 설정한 타겟 중 채널 친구인 사용자에게 메시지를 발송합니다.
* **수신 동의자 중 채널 친구만:** 설정한 타겟 중, 광고성 정보 수신에 동의했으며 채널 친구인 사용자에게 메시지를 발송합니다.
* **수신 동의자 중 채널 친구 제외:** 설정한 타겟 중, 광고성 정보 수신에 동의했으나 채널 친구가 아닌 사용자에게 메시지를 발송합니다.
* **수신 동의자 전체:** 설정한 타겟 중, 광고성 정보 수신에 동의한 모든 사용자에게 메시지를 발송합니다.

#### **2-3. 예상 타겟 수**

설정한 타겟과 발송 대상 조건에 따라 메시지를 받게 될 예상 인원을 확인해 주세요.

<figure><img src="/files/Coa61RT2k75iWrawk7JR" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

* **메시지 발송 시점**의 **대상자 변동 또는 채널 친구/수신 동의 여부**에 따라, 실제 발송 건수는 예상과 다를 수 있습니다.
* **수신 동의 여부**는 **매일 오전 3시**에 갱신되며, **채널 친구 여부**는 **최근 발송 이력**을 기준으로 추정합니다.
  {% endhint %}

<details>

<summary><strong>예상 타겟 수 산출 방식</strong></summary>

<table><thead><tr><th width="159.8125">발송 대상</th><th>산출 방식</th><th data-hidden>이력상 친구</th><th data-hidden>이력상 비친구</th><th data-hidden>이력 없음</th></tr></thead><tbody><tr><td><strong>채널 친구</strong></td><td><p>최근 이력상 친구 + 확인 예정(미이력) = 예상 타겟 수</p><ul><li>설정한 타겟 전체를 대상으로, 친구일 가능성이 있는 사용자 수</li><li>최근 이력상 '비친구'로 확인된 대상은 제외</li></ul></td><td>O</td><td>X</td><td>O</td></tr><tr><td><p><strong>수신 동의자 중</strong></p><p><strong>채널 친구만</strong></p></td><td><p>수신 동의자 중 이력상 친구 + 수신 동의자 중 확인 예정(미이력) = 예상 타겟 수</p><ul><li>설정한 타겟 중 '광고성 정보 수신 동의자'를 대상으로, 친구일 가능성이 있는 사용자 수</li><li>최근 이력상 '비친구'로 확인된 대상은 제외</li></ul></td><td>O</td><td>X</td><td>O</td></tr><tr><td><p><strong>수신 동의자 중</strong></p><p><strong>채널 친구 제외</strong></p></td><td><p>수신 동의자 중 이력상 비친구 + 수신 동의자 중 확인 예정(미이력) = 예상 타겟 수</p><ul><li>설정한 타겟 중 '광고성 정보 수신 동의자'를 대상으로, 친구가 아닐 가능성이 있는 사용자 수</li><li>최근 이력상 '친구'로 확인된 대상은 제외</li></ul></td><td>X</td><td>O</td><td>O</td></tr><tr><td><strong>수신 동의자 전체</strong></td><td><p>수신 동의자 중 이력상 친구 + 수신 동의자 중 이력상 비친구 + 수신 동의자 중 확인 예정(미이력) = 예상 타겟 수 (설정한 타겟 모수와 동일)</p><ul><li>설정한 타겟 중 '광고성 정보 수신 동의자' 수</li><li>친구 여부와 관계없이 모두 포함</li></ul></td><td>O</td><td>O</td><td>O</td></tr></tbody></table>

{% hint style="info" %}
직접 업로드한 경우 **예상 타겟 수**는 업로드에 성공한 **유효한 전화번호 수**로 표시됩니다.
{% endhint %}

</details>

***

## **2단계: 메시지 설정**

<figure><img src="/files/mjPoMVWOAlBbL837TT3w" alt=""><figcaption></figcaption></figure>

### **1. 템플릿 선택**

캠페인에 사용할 템플릿을 선택해 주세요. 템플릿은 검수가 완료된 **승인 상태의 템플릿**만 선택할 수 있습니다.

### **2. 템플릿 정보**

선택한 템플릿에 설정된 상세 정보를 확인할 수 있습니다.

* **기본 설정:** 템플릿의 이름, 메시지 유형과 같은 기본 정보를 보여줍니다.
* **템플릿 메시지:** 실제 발송될 메시지의 본문, 버튼, 쿠폰 등의 내용을 보여줍니다.
* **미리보기:** 메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.

<details>

<summary>메시지 구성 요소별 발송 가능 최대 글자 수</summary>

| 구성 요소       | 발송 가능 최대 글자 수                                                                                                                                                     |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **메시지 본문**  | <ul><li><strong>텍스트 유형:</strong> 1,300자</li><li><strong>이미지 유형:</strong> 1,300자</li><li><strong>와이드 이미지 유형:</strong> 76자 </li></ul>                               |
| **버튼 > 링크** | <ul><li><strong>모바일:</strong> 920자 </li><li><strong>PC:</strong> 920자</li><li><strong>Android:</strong> 1,000자</li><li><strong>iOS:</strong> 1,000자</li></ul>     |
| **쿠폰 > 링크** | <ul><li><strong>모바일:</strong> 1,000자 </li><li><strong>PC:</strong> 1,000자</li><li><strong>Android:</strong> 1,000자</li><li><strong>iOS:</strong> 1,000자</li></ul> |

</details>

### **3. 발송 테스트**

발송하기 전, 메시지가 사용자에게 어떻게 보이는지 미리 확인해볼 수 있습니다.

<figure><img src="/files/8vN0VAaJtXWK8UmuxCh9" alt=""><figcaption></figcaption></figure>

* **전화번호:** 카카오톡 채널 친구로 등록된 전화번호를 입력해 주세요.
* **발송:** 클릭 시 입력한 전화번호로 선택한 템플릿 내용을 담은 메시지가 발송됩니다.

{% hint style="warning" %}
테스트 발송은 **1회 1명**에게만 가능하며, **일반 발송과 동일한 비용**이 발생합니다.
{% endhint %}

***

## **3단계: 옵션 설정**

<figure><img src="/files/vj3xDxSWUPYfLvTYcZD2" alt=""><figcaption></figcaption></figure>

### **1. 스케줄 설정**

#### **1-1. 단일 발송**

지정한 날짜와 시간에 메시지를 한 번만 발송합니다.

<figure><img src="/files/czJBn1QyxEv8QTkt3Fco" alt=""><figcaption></figcaption></figure>

* **발송 일시:** 메시지를 발송할 날짜와 시간을 지정해 주세요.

#### **1-2. 반복 발송**

캠페인 성격에 따라 설정한 주기(매일, 매주, 매월)에 맞춰 지정된 시간에 메시지를 자동으로 발송합니다.

<figure><img src="/files/7gUQlsMdpELQjq9ohZge" alt=""><figcaption></figcaption></figure>

* **수동 종료 전까지:** 직접 종료하기 전까지 캠페인이 계속 진행됩니다.
* **기간 지정:** 시작일과 종료일을 미리 설정하여, 해당 기간 내에만 캠페인이 진행됩니다.
* **반복 주기:** 캠페인 기간 내 메시지가 발송될 반복 규칙(빈도, 요일)을 설정해 주세요.
* **발송 시간:** 메시지가 발송될 시간을 지정해 주세요.

{% hint style="info" %}
정보통신망법 및 카카오톡 채널 운영 정책에 따라, 브랜드 메시지는 **08:00부터 20:50까지 발송**할 수 있습니다.
{% endhint %}

### **2. 발송 간격 제한**

발송 간격 제한은 같은 대상에게 설정한 기간 동안 메시지가 다시 발송되지 않도록 제한하는 기능입니다. 이 캠페인의 발송 이력, 또는 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 중복·반복 발송을 막을 수 있습니다.

발송 유형(단일 발송 / 반복 발송)에 따라 **적용 범위** 영역이 다르게 표시됩니다.

{% tabs %}
{% tab title="단일 발송" %}

<figure><img src="/files/ZF96MiqDx1lpzdUaNwhb" alt=""><figcaption></figcaption></figure>

적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다.
{% endtab %}

{% tab title="반복 발송" %}

<figure><img src="/files/DF952UyLsBzTyCA7l5FB" alt=""><figcaption></figcaption></figure>

적용 범위를 '이 캠페인만 적용' 또는 '같은 그룹 캠페인 포함' 중 선택할 수 있습니다.
{% endtab %}
{% endtabs %}

#### **2-1. 사용 여부 선택**

* **사용 안 함:** 발송 간격 제한을 적용하지 않습니다.
* **사용:** 아래에서 설정한 기준에 따라 같은 대상에게 일정 기간 동안 다시 발송되지 않도록 제한합니다.

#### **2-2. 적용 범위**

발송 간격 제한의 기준이 될 발송 이력의 범위를 선택합니다.

* **이 캠페인만 적용:** 이 캠페인의 발송 이력만 기준으로 제한합니다. (반복 발송에서만 선택할 수 있습니다.)
* **같은 그룹 캠페인 포함:** 같은 발송 제한 그룹에 속한 캠페인의 발송 이력을 함께 확인하여, 같은 대상에게 설정한 제한 기간 동안 다시 발송되지 않도록 제한합니다.

{% hint style="info" %}
단일 발송은 이 캠페인 자체가 반복 발송되지 않으므로, 적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다. 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 제한이 적용됩니다.

e.g. 푸시와 SMS 캠페인을 같은 그룹으로 묶으면, 푸시 발송 대상을 SMS 발송에서 제외할 수 있습니다.
{% endhint %}

#### **2-3. 발송 제한 그룹**

적용 범위가 '같은 그룹 캠페인 포함'일 때 사용할 발송 제한 그룹을 선택합니다.

* **+ 새 그룹 등록:** 새로운 발송 제한 그룹을 즉시 등록할 수 있습니다.
* **그룹 캠페인 보기:** 선택한 그룹을 사용 중인 캠페인 목록을 확인할 수 있습니다.

{% hint style="info" %}
발송 제한 그룹은 설정 > 발송 제한 그룹 관리에서 미리 만들어 둘 수 있습니다. 같은 그룹에 속한 캠페인은 발송 이력을 함께 공유합니다.
{% endhint %}

#### **2-4. 대상 기준**

같은 대상으로 판단할 기준을 선택합니다.

* **전화번호 또는 회원 기준:** 같은 전화번호 또는 같은 회원으로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다. 한 회원이 여러 전화번호를 사용하는 경우에도 중복 발송을 제한할 수 있습니다.
* **전화번호 기준:** 같은 전화번호로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다.

#### **2-5. 제한 기간**

1\~31일 사이로 설정할 수 있습니다.

{% hint style="info" %}
위 기준과 일치하는 대상에게는 마지막 발송일을 기준으로 설정한 제한 기간 동안 다시 발송되지 않습니다. (1\~31일)

e.g. 5월 1일 발송 / 제한 기간 2일 → 5월 1일·2일은 발송되지 않으며, 5월 3일부터 다시 발송할 수 있습니다.
{% endhint %}

### **3. 예상 발송 비용**

예상 타겟 수와 메시지 유형별 단가를 기준으로 산출된 1회 발송 예상 비용을 확인할 수 있습니다.

<figure><img src="/files/AMnFIHcO8wjwVqJyWiLi" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
예상 비용은 타겟 수를 기준으로 산출된 **부가세(VAT) 별도 금액**이며, 실제 발송 비용과 다를 수 있습니다.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.groobee.ai/new-admin/kakao-brandmessage/kakao-brandmessage-create/schedule.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.