# API 트리거 발송

외부 API 요청을 통해 **원하는 시점에 특정 고객**에게 메시지를 보내는 방식입니다.

고객사의 자체 시스템(CRM, 주문/재고 관리 등)에서 **이벤트가 발생했을 때 실시간으로 맞춤형 메시지**를 보낼 수 있습니다. (예: 품절 상품 재입고 알림, 주문 상태 변경 안내)

{% hint style="warning" %}
 메시지 구성 요소별 [**발송 가능 최대 글자 수**](https://docs.groobee.ai/~/changes/276/new-admin/kakao-alimtalk/kakao-alimtalk-create/api-trigger#id-2-1)를 고려하여 API를 요청해 주세요.
{% endhint %}

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

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

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

***

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

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

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

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

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

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

* **기본 설정:** 템플릿의 이름, 코드, 카테고리와 같은 기본 정보를 보여줍니다.
* **개인화 설정:** 메시지에 사용된 개인화 변수의 목록을 보여줍니다.
* **템플릿 메시지:** 실제 발송될 메시지의 제목, 본문, 버튼 등의 내용을 보여줍니다.
* **미리보기:** 알림톡 메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.

<details>

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

| 구성 요소        | 발송 가능 최대 글자 수                                                                             |
| ------------ | ----------------------------------------------------------------------------------------- |
| 강조 표기형 > 제목  | 50자                                                                                       |
| 강조 표기형 > 부제목 | 18자                                                                                       |
| 메시지 본문       | <ul><li>카카오톡 25.8.0 버전 이상 사용자: 1,300자</li><li>카카오톡 25.8.0 버전 미만 사용자: 1,000자</li></ul>     |
| 버튼 > 링크      | <ul><li>Android: 1,000자</li><li>iOS: 1,000자</li><li>모바일: 920자 </li><li>PC: 920자</li></ul> |

</details>

{% hint style="info" %}
미리보기는 **참고용으로 제공**되며, 실제 메시지는 수신자의 기기나 앱 환경에 따라 다르게 보일 수 있습니다.
{% endhint %}

***

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

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

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

캠페인이 진행될 기간을 설정해 주세요.

* **수동 종료 전까지:** 설정한 시작일부터 직접 종료하기 전까지 캠페인이 계속 진행됩니다.
* **기간 지정:** 설정한 시작일과 종료일 동안에만 캠페인이 진행됩니다.

{% hint style="warning" %}
캠페인은 저장 후 **진행중**<img src="/files/YzqC75eI0qntSoUip8GU" alt="" data-size="line">으로 상태를 변경해야 설정한 시간에 맞춰 진행됩니다.
{% endhint %}

### **2. 코드 샘플**

API를 통해 알림톡을 발송할 때 사용하는 코드 예시입니다. 아래 설명을 참고하여 개발팀과 소통 후 알림톡 발송을 요청해 주세요.

* **캠페인 키:** 캠페인마다 부여되는 고유 ID입니다. 이 키를 통해 발송할 캠페인이 식별되므로, API 요청 시 필수로 포함해 주세요.
* **메시지 발송 대상:** 메시지를 수신할 대상을 지정하는 값으로, **phoneNumber, appUserId, userKey** 중 하나를 선택하여 요청해 주세요.
* **개인화 데이터:** 템플릿에 개인화 변수(예: #{name})를 사용한 경우, 각 변수에 치환될 실제 값을 담아 요청해 주세요. 치환 값이 없으면 설정된 대체 값으로 발송됩니다.


---

# 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://docs.groobee.ai/~/changes/276/new-admin/kakao-alimtalk/kakao-alimtalk-create/api-trigger.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.