> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 대량 발신

> 캠페인으로 대량 통화를 실행하세요.

캠페인 단위로 수백\~수천 건의 아웃바운드 통화를 실행합니다. 마케팅, 알림, 설문, 리마인더 등 반복 발신에 적합합니다.

## 프로젝트 생성

대시보드 사이드바에서 **발신** → **대량 발신**을 클릭하면 프로젝트 목록이 나타납니다. **+** 버튼에서 생성 방식을 선택하세요.

| 방식         | 설명                                           |
| ---------- | -------------------------------------------- |
| **빈 프로젝트** | 빈 시트가 열립니다. 수신번호와 변수를 직접 입력하세요               |
| **파일 업로드** | CSV, XLS, XLSX 파일을 업로드합니다. 파일명이 프로젝트 이름이 됩니다 |

### 파일 업로드 규격

| 항목    | 제한                                                    |
| ----- | ----------------------------------------------------- |
| 형식    | CSV (.csv), Excel 97-2003 (.xls), Excel 2007+ (.xlsx) |
| 크기    | 50 MB                                                 |
| 행 수   | 65,536행                                               |
| 필수 칼럼 | `전화번호`                                                |

## 시트에서 데이터 편집

프로젝트가 생성되면 시트 에디터가 열립니다. 업로드한 파일의 데이터가 표시되며, 직접 편집할 수 있습니다.

* 칼럼 추가/삭제로 동적 변수를 관리하세요
* 행을 추가하거나 삭제할 수 있습니다
* 실행 취소(Undo)와 재실행(Redo)을 지원합니다

## 캠페인 설정

발신할 행을 선택한 뒤 상단의 **발신** 버튼을 클릭하면 캠페인 설정 다이얼로그가 열립니다.

<Steps>
  <Step title="캠페인 이름">
    캠페인을 식별할 이름을 입력하세요.
  </Step>

  <Step title="에이전트 선택">
    통화를 처리할 에이전트와 버전을 선택하세요.
  </Step>

  <Step title="발신번호">
    조직에 등록된 번호 중 아웃바운드가 가능한 번호를 선택하세요. 필요하면 표시번호도 별도로 지정할 수 있습니다.
  </Step>

  <Step title="발송 방식">
    * **즉시 발송** — 설정 완료 후 바로 발신을 시작합니다
    * **예약 발송** — 날짜와 시간을 지정하면 해당 시점에 발신을 시작합니다
  </Step>

  <Step title="발신 허용 시간">
    발신할 요일과 시간대를 설정하세요. 허용 시간 밖에서는 자동으로 발신이 중단되고, 다음 허용 시간에 재개됩니다.

    기본값은 월~~일 08:00~~20:00입니다. 여러 시간대를 추가할 수 있습니다.

    <Warning>
      발신 허용 시간을 설정하지 않으면 24시간 발신됩니다.
    </Warning>
  </Step>

  <Step title="동시 통화 수">
    한 번에 발신할 최대 통화 수를 설정하세요. 조직의 동시 통화 한도 내에서 설정할 수 있습니다.

    <Tip>
      테스트 시에는 1\~5로 낮게 시작하세요. 동시 통화 수를 높이면 발신 속도가 빨라지지만 비용도 비례하여 증가합니다.
    </Tip>
  </Step>

  <Step title="통화 후 처리">
    에이전트에 설정된 통화 후 처리 항목 중 시트에 기록할 항목을 선택하세요. 선택한 항목은 통화 완료 후 시트에 자동으로 채워집니다.
  </Step>

  <Step title="알림 이메일">
    캠페인 완료 시 알림을 받을 이메일을 입력하세요. 기본으로 현재 사용자의 이메일이 추가됩니다.
  </Step>

  <Step title="(선택) 자동 재발신">
    캠페인이 끝난 뒤 미연결 건을 자동으로 다시 발신할지 설정합니다. 자세한 설정 방법은 [자동 재발신](#자동-재발신)을 참고하세요.
  </Step>
</Steps>

설정을 마치고 **발신**을 클릭하면 캠페인이 시작됩니다.

## 자동 재발신

캠페인이 종료된 뒤 미연결 건을 자동으로 다시 발신하는 기능입니다. 사용자가 받지 못한 통화를 운영자가 직접 챙기지 않아도 시스템이 정해진 횟수만큼 재발신합니다.

캠페인 설정 다이얼로그의 **재시도** 탭에서 활성화할 수 있습니다.

| 항목               | 설명                                                                     |
| ---------------- | ---------------------------------------------------------------------- |
| **자동 재발신**       | 활성화 시 자동 재발신이 동작합니다. 비활성화면 캠페인은 한 번만 발신됩니다                             |
| **재시도 횟수**       | 0\~3회 사이로 설정합니다. 한 번호당 설정한 횟수만큼 추가 발신됩니다                               |
| **재시도 대상 종료 사유** | 어떤 종료 사유의 통화를 재발신 대상으로 삼을지 선택합니다. 기본값은 `사용자 무응답`, `발신 실패`, `시스템 오류`입니다 |

### 동작 방식

* 재발신은 원본 캠페인이 **완료** 상태에 도달했을 때 트리거됩니다.
* 재시도마다 새로운 child 캠페인이 생성되며, 원본 캠페인과 같은 시트의 별도 STATUS 칼럼에 결과가 기록됩니다.
* 재시도별로 완료 알림 이메일이 따로 발송됩니다.
* child 캠페인의 정책(재시도 횟수, 대상 종료 사유 등)은 원본 캠페인 설정을 그대로 따르며 도중에 변경할 수 없습니다.

### 종료 사유와 재발신 대상

종료 사유 구분은 [통화 종료 사유](/docs/operate/monitor/disconnection-reasons) 페이지를 참고하세요. 의도적으로 통화를 끊은 경우(고객 거절 등)는 재발신 대상에서 빼 두는 편이 안전합니다.

<Tip>
  처음 설정할 때는 `사용자 무응답`, `발신 실패` 정도만 선택해 시작하는 것을 권장합니다. 재시도 횟수가 많거나 대상 종료 사유가 넓을수록 통신료와 AI 사용료가 비례해서 늘어납니다.
</Tip>

## 캠페인 관리

진행 중인 캠페인은 시트 에디터에서 바로 관리하거나, **발신** → **대량 발신 기록** 페이지에서 전체 캠페인을 확인할 수 있습니다.

### 캠페인 상태

```mermaid theme={null}
stateDiagram-v2
    [*] --> 대기 : 즉시 발송
    [*] --> 초안 : 예약 발송 생성
    초안 --> 대기 : 예약 처리 시작
    대기 --> 진행 : 발신 시작
    대기 --> 취소 : 사용자 중지
    진행 --> 일시정지 : 수동 중단 / 허용 시간 밖
    진행 --> 완료 : 모든 통화 완료
    진행 --> 취소 : 사용자 중지
    진행 --> 실패 : 오류 발생
    일시정지 --> 진행 : 재개 / 허용 시간 진입
    일시정지 --> 취소 : 사용자 중지
    완료 --> [*]
    취소 --> [*]
    실패 --> [*]
```

| 상태       | 설명                                  |
| -------- | ----------------------------------- |
| **초안**   | 예약 캠페인이 저장되었지만 아직 발신 작업이 생성되지 않은 상태 |
| **대기**   | 발신 작업이 생성되어 시작을 기다리는 중              |
| **진행**   | 발신이 진행 중                            |
| **일시정지** | 수동 중단 또는 발신 허용 시간 밖                 |
| **완료**   | 모든 통화가 완료됨                          |
| **취소**   | 사용자가 중단함                            |
| **실패**   | 오류로 중단됨                             |

### 관리 동작

| 동작       | 가능한 상태       | 설명                     |
| -------- | ------------ | ---------------------- |
| **일시정지** | 진행           | 발신을 일시 중단합니다           |
| **재개**   | 일시정지         | 중단된 발신을 재개합니다          |
| **중지**   | 대기, 진행, 일시정지 | 캠페인을 취소합니다. 되돌릴 수 없습니다 |
| **삭제**   | 모든 상태        | 캠페인을 목록에서 제거합니다        |
| **다운로드** | 모든 상태        | 결과 파일을 다운로드합니다         |

<Note>
  **일시정지**와 **중지**는 아직 시작되지 않은 대기 작업과 새 발신 생성을 막습니다.
  이미 연결되었거나 진행 중인 통화는 즉시 끊지 않고 통화 종료까지 진행됩니다.
</Note>

## 대량 발신 기록

**발신** → **대량 발신 기록** 페이지에서 모든 캠페인의 이력을 확인할 수 있습니다.

각 캠페인에 표시되는 정보:

* **진행률** — 예약 / 발신 / 수신 건수
* **비용** — 캠페인 총 비용
* **발신번호 / 표시번호**
* **시작일시 / 완료일시**

날짜 범위와 검색으로 캠페인을 필터링하고, 결과를 내보낼 수 있습니다.

## API로 캠페인 생성

API로도 캠페인을 생성할 수 있습니다. 전체 파라미터는 [v3 API 참조](/api-reference/v3/introduction)에서 확인하세요.

## 관련 문서

* [단건 발신](/docs/operate/deploy/outbound-single) — 1건씩 통화 실행
* [전화번호](/docs/operate/deploy/phone-numbers) — 번호 구매와 에이전트 연결
* [동적 변수](/docs/build/variables/dynamic-variables) — 수신자별 에이전트 개인화

***

<Accordion title="연관 검색어">
  대량 발신, 캠페인, batch call, CSV 업로드, 예약 발송, 동시 통화, 대량 통화, 자동 재발신, 재시도, retry, 미연결 재발신
</Accordion>