> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 캠페인

> **Info**
>
> 아웃바운드 통화는 국가, 주, 업종에 따라 규제가 다르므로 적절한 통화 시간과 시도 횟수 제한은 누구에게,
> 어떤 목적으로 전화하는지에 따라 달라집니다. 동의 여부, 에이전트의 발화 내용, 다음 단계 관리 등을 포함한 아웃바운드 통화
> 규정 준수와 연락처가 거주하는 지역의 규정에 맞는 제한 설정은 사용자의 책임입니다. 자세한 내용은 [ElevenAgents 이용약관](https://elevenlabs.io/agents-terms) 및 [TCPA 가이드](/docs/ko/eleven-agents/legal/tcpa)를
> 참조하세요.

## 개요

캠페인은 에이전트의 아웃바운드 커뮤니케이션을 실행합니다. 수신자 목록을 제출하면 캠페인이 재시도, 콜백, 리디렉션, 통화 가능 시간 전반에 걸쳐 각 수신자가 사용자가 제어하는 최종 결과에 도달할 때까지 연락합니다. 캠페인은 일괄 통화를 대체합니다.

### 캠페인 활용 사례

완료까지 두 번 이상의 통화가 필요한 아웃리치에 캠페인을 사용하세요.

* **대화 기반 후속 조치.** 수신자가 오후 4시에 다시 전화해 달라고 하거나 동료의 번호로 시도해 달라고 요청합니다. 캠페인은 통화 분석을 읽고 적절한 다음 통화를 예약합니다.
* **통화 가능 시간.** 통화는 지정한 시간대에서 평가되는, 사용자가 정의한 시간 내에만 발신됩니다. 유일한 예외는 수신자가 요청한 시간에 이루어지는 콜백이며, 해당 시간에 발신됩니다.
* **제한된 재시도.** 실패하거나 응답이 없는 통화는 사용자가 제어하는 한도까지 일정에 따라 재시도됩니다.
* **운영자 가시성.** 모든 수신자와 통화, 각 결정이 내려진 이유를 확인할 수 있으며 언제든지 일시 중지하거나 취소할 수 있습니다.

## 캠페인 정책

캠페인 정책은 재시도 강도와 통화 가능 시점을 정의합니다. 워크스페이스의 기본 정책을 설정하면 각 캠페인은 생성 시 해당 정책의 스냅샷을 가져옵니다. 이후 워크스페이스 정책을 변경해도 그 뒤에 생성되는 캠페인에만 적용됩니다.

```json
{
  "policy": {
    "timezone": "America/New_York",
    "retry": {
      "retry_delay_seconds": 600,
      "max_short_retries": 1,
      "max_total_calls": 6,
      "max_callbacks": 2,
      "max_redirects": 2,
      "interval_placement": "start"
    },
    "calling_periods": [
      {
        "weekdays": [0, 1, 2, 3, 4],
        "intervals": [
          { "start": "10:00", "end": "12:00" },
          { "start": "16:00", "end": "18:00" }
        ]
      }
    ],
    "data_collection": {
      "callback_time": "__system_data_collection_callback_time",
      "redirect_phone_number": "__system_data_collection_redirect_phone_number",
      "stop": "__system_data_collection_do_not_call"
    }
  }
}
```

### 재시도 제한

| 필드                                    | 설명                                                                                        |
| ------------------------------------- | ----------------------------------------------------------------------------------------- |
| `retry_delay_seconds`                 | 실패, 무응답 또는 음성사서함 통화 후 짧은 재시도 전까지의 지연 시간입니다.                                               |
| `max_total_calls`                     | 첫 통화를 포함하여 수신자당 시도할 수 있는 횟수의 절대 한도입니다. 수신자에게 이 횟수보다 많이 전화하지 않습니다. 기본값은 6, 최대값은 30입니다.     |
| `max_short_retries`                   | 재시도가 다음 시간대로 넘어가기 전 각 통화 가능 시간 내에서 허용되는 짧은 재시도 횟수입니다.                                     |
| `max_callbacks`, `max_redirects`      | 수신자가 요청할 수 있는 콜백 및 리디렉션 횟수의 한도입니다. 통화가 리디렉션되면 재시도 및 콜백 예산은 번호별로 재설정됩니다.                   |
| `max_consecutive_failures_per_number` | 선택 사항입니다. 한 번호에서 연속 실패한 횟수가 이 값에 도달하면 수신자는 등록된 다음 번호(수신자당 최대 5개)로 이동하며, 다음 번호가 없으면 완료됩니다. |
| `interval_placement`                  | 통화가 이후 시간대로 이동할 때 배치되는 위치입니다. 시간대 시작 시점, 시간대 내 임의 시간 또는 이미 실패한 시간을 피하도록 순환 배치할 수 있습니다.    |

### 통화 가능 시간

`calling_periods`는 통화를 발신할 수 있는 주간 시간대를 정의합니다. 요일은 월요일이 0인 0\~6으로 번호가 매겨집니다. 시간은 정책 `timezone`의 현지 `HH:MM`이며, 같은 요일의 시간대는 겹칠 수 없습니다.

정확한 시간의 콜백은 유일한 예외입니다. 수신자가 특정 시간에 전화해 달라고 요청하면 해당 시간이 설정한 시간대 밖이더라도 그 시간에 발신됩니다. 이를 고려하여 max_callbacks를 설정하세요.

정책에는 단일 `timezone`이 있습니다. 연락처가 여러 시간대에 있다면 각 시간대별로 별도 캠페인을 만들고 각 캠페인에 고유한 `timezone`과 통화 가능 시간을 설정하세요. 그러면 모든 통화가 수신자 거주 지역의 허용 시간 내에 이루어집니다.

### 동적 변수 매핑

캠페인은 클릭 한 번으로 기본 데이터 수집 항목을 에이전트에 연결하여 콜백, 리디렉션, 통화 중지를 활성화합니다.

추가 분석 결과를 후속 통화용 [동적 변수](/docs/ko/eleven-agents/customization/personalization/dynamic-variables)에 매핑할 수도 있습니다. 그러면 재시도나 콜백을 이전 통화에서 파악한 정보로 시작할 수 있습니다.

### 후속 조치 컨텍스트

콜백이 자연스럽게 이어지도록 에이전트 프롬프트에서 다음 변수를 참조하세요.

| 변수                                   | 포함 내용                              |
| ------------------------------------ | ---------------------------------- |
| `campaign__call_type`                | 통화가 첫 연락, 재시도, 콜백 또는 리디렉션인지 여부입니다. |
| `campaign__previous_conversation_id` | 수신자와의 이전 대화 ID입니다.                 |
| `campaign__previous_summary`         | 이전 대화의 요약입니다.                      |
| `campaign__previous_transcript`      | 이전 대화의 트랜스크립트입니다.                  |

## 채널

| 채널       | 모드  | 참고                                                                                                                      |
| -------- | --- | ----------------------------------------------------------------------------------------------------------------------- |
| 전화       | 음성  | 전체 재시도, 콜백 및 리디렉션 동작을 지원합니다.                                                                                            |
| WhatsApp | 음성  | 수신자당 단일 권한 요청을 전송한 뒤 재시도와 콜백을 진행합니다. [WhatsApp 아웃바운드](/docs/ko/eleven-agents/whatsapp/outbound)를 참조하세요.                 |
| WhatsApp | 텍스트 | 각 수신자에게 승인된 WhatsApp 메시지 템플릿을 전송합니다. 재시도는 적용되지 않습니다. [WhatsApp 아웃바운드](/docs/ko/eleven-agents/whatsapp/outbound)를 참조하세요. |

이메일 및 SMS 채널은 곧 제공될 예정입니다.

## 캠페인 만들기

#### 캠페인 열기

ElevenAgents 탐색 메뉴에서 **캠페인**을 선택하세요.

#### 워크스페이스 정책 저장

**설정**을 열어 시간대, 재시도 제한, 통화 가능 시간을 정의한 다음 저장하세요.
[캠페인 정책](#campaign-policy)을 참조하세요.

#### 캠페인 만들기

**새 캠페인**을 선택하고 에이전트, 채널, 전화번호를 선택한 다음 수신자 목록을 업로드하세요.
CSV를 업로드하거나 일괄 통화와 동일한 요청 형식으로 API를 통해 수신자를 제출할 수 있습니다.
각 수신자는 최대 5개의 전화번호를 가질 수 있습니다(CSV의 `phone_number`부터
`phone_number_5`까지).

#### 고급 기능 활성화

**고급 제어**를 켜서 지정된 통화 가능 시간 내 재시도, 콜백 및 후속 조치를 활성화하세요.
이 설정은 워크스페이스 설정에서 자동으로 적용되며, 캠페인별로 여기에서 조정할 수도 있습니다.

#### 진행 상황 모니터링

**분석** 탭에서 진행 상황을 확인하세요.

캠페인을 생성하면 통화가 대기열에 추가되며 통화 가능 시간에 들어오면 발신됩니다.

> **Warning**
>
> [Zero Retention Mode](/docs/ko/eleven-agents/customization/privacy/zrm)를 사용하는 워크스페이스 또는 에이전트에서는 캠페인을 사용할 수 없습니다.
> 후속 조치 결정은 지속적으로 저장되는 통화 상태와 대화 분석에 의존하므로, 보존 없음 워크스페이스의 요청 및
> 보존 없음 에이전트에 대한 제출은 거부됩니다.

## 동시성

캠페인 통화는 워크스페이스 및 에이전트 동시성 제한에 포함됩니다. 기본적으로 캠페인은 워크스페이스 동시성의 50% 또는 에이전트 동시성의 70% 중 더 낮은 값을 사용합니다. 개별 캠페인에 더 낮은 한도를 설정할 수 있습니다.

## API

캠페인 생성, 관리 및 분석은 ElevenLabs API를 통해 사용할 수 있으며, 기존 workflow 및 애플리케이션에 캠페인을 통합할 수 있습니다. 사용 가능한 엔드포인트는 [API 레퍼런스](/docs/ko/api-reference/introduction)를 참조하세요.

## 권장 사항

* **작게 시작하세요.** 전체 대상에게 시작하기 전에 짧은 목록과 보수적인 `max_total_calls`로 테스트하세요.
* **시간대를 신중하게 설정하세요.** 통화 가능 시간은 현지 통화 시간을 준수하기 위한 주요 제어 수단입니다. `timezone`을 수신자 위치로 설정하고, 시간대는 허용 시간 안쪽으로 충분히 여유 있게 지정하세요.
* **후속 조치 신호를 수집하세요.** 캠페인은 에이전트가 캡처한 경우에만 콜백, 리디렉션 및 수신 거부 요청을 처리합니다. 각 항목을 언제 기록해야 하는지 에이전트 프롬프트에 알려주세요.
* **후속 조치 컨텍스트를 활용하세요.** 프롬프트에서 `campaign__previous_summary`를 참조하면 재시도나 콜백이 첫 인사를 반복하는 대신 이전 통화가 끝난 지점부터 이어집니다.
* **한도를 낮게 유지하세요.** 지속적인 연락은 사용자뿐 아니라 수신자에게도 부담입니다. 여러 번의 시도보다 적절한 타이밍의 몇 번의 시도를 권장합니다.

## FAQ

#### 진행 중인 캠페인의 정책을 변경할 수 있나요?

아니요. 캠페인 정책은 생성 시 고정됩니다. 워크스페이스 정책 변경은 그 이후에 생성하는
캠페인에 적용됩니다. 진행 중인 캠페인을 변경하려면 중지하고 새 캠페인을 만드세요.

#### 수신자가 둘 이상의 캠페인에 포함될 수 있나요?

각 캠페인은 자체 리드를 추적하며, 수신 거부 상태는 캠페인에 속합니다. 동일한 사람에게 두 번 연락하지 않아야 한다면 캠페인을 만들기 전에
캠페인 간 수신자 중복을 제거하세요.

## 다음 단계

* [데이터 수집](/docs/ko/eleven-agents/customization/agent-analysis/data-collection): 에이전트가 활용할 신호를 캡처하세요.
* [동적 변수](/docs/ko/eleven-agents/customization/personalization/dynamic-variables): 각 수신자의 통화를 개인화하세요.
* [가드레일](/docs/ko/eleven-agents/best-practices/guardrails): 아웃바운드 에이전트가 주제와 브랜드 방향을 유지하도록 하세요.