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

# 아웃바운드 캠페인

> 연락처 목록을 업로드하고 에이전트가 통화 가능 시간, 재시도, 실시간 진행 상황을 활용해 목록을 처리하도록 하세요.

캠페인은 연락처 목록에 대신 전화를 겁니다. 에이전트를 선택하고, CSV를 업로드하고,
통화 허용 시간을 설정하면 ThunderPhone이 목록을 순차적으로 처리합니다.
— 선택한 일정에 따라 부재중 및 음성사서함 응답에 재시도합니다. **참여 → 캠페인**에서
확인할 수 있습니다 (`/dashboard/campaigns`).

일회성 프로그래밍 방식 통화에는 대신
[아웃바운드 통화 API](/ko/guides/place-outbound-calls)를 사용합니다.

## 사전 요구 사항

* 배포된 음성 에이전트.
* 발신에 사용할 조직에 연결된 **VoIP 전화번호** —
  데모 번호는 인바운드 전용이며 캠페인 통화를 발신할 수 없습니다.
  [VoIP 제공업체 연결](/ko/guides/voip-providers)을 참조하세요.
* `phone` 또는 `phone_number` 열이 포함된 CSV 파일(또는 붙여넣은 JSON) 형식의
  연락처. **업로드당 최대 5,000행**, UTF-8 인코딩이어야 합니다.
  추가 열은 캠페인 연락처 레코드에서 연락처별 변수로 유지됩니다.

## 캠페인 만들기

<Steps>
  <Step title="새 캠페인 클릭">
    이름을 지정하고, **음성 에이전트**를 선택한 다음 **발신 번호**
    (VoIP 번호 중 하나)를 선택합니다.
  </Step>

  <Step title="연락처 CSV 업로드">
    전화번호가 유효하지 않은 행은 개별적으로 거부되며 해당 행 번호와 함께
    보고됩니다 — 나머지 행은 정상적으로 가져옵니다.
  </Step>

  <Step title="통화 시간 설정">
    **시간대**와 일일 **시작/종료** 시간을 선택합니다. 캠페인은
    해당 시간 내에서만 전화를 겁니다. 시간대는 자정을 넘길 수 있습니다
    (예: 22:00 → 02:00). 필요에 따라 실행 예약을 위한 **시작 시간**과
    캠페인을 자동으로 완료할 **종료 시간**을 설정합니다.
  </Step>

  <Step title="통화 속도 및 재시도 조정">
    * **동시 통화** — 이 캠페인이 동시에 실행하는 통화 수입니다
      (1–10, 기본값 3). 조직 전체도 모든 항목에서 **동시 아웃바운드 통화**
      최대 10건으로 제한되므로, 병렬 캠페인은 이 한도를 공유합니다.
    * **최대 시도 횟수** — 각 연락처에 전화를 걸 수 있는 횟수입니다
      (기본값 2).
    * **재시도 대기 시간(분)** — 재시도 전 대기 시간입니다 (기본값 60).
    * **재시도 조건** — 재시도를 트리거하는 결과입니다: **응답 없음**,
      **음성사서함**, **실패** (기본적으로 모두 활성화됨).
  </Step>

  <Step title="초안 생성 후 시작">
    캠페인은 초안으로 생성됩니다 — 연락처는 캠페인이 초안 상태일 때만
    추가할 수 있습니다. 캠페인을 시작하려면 통화 요금에 명시적으로 동의해야
    합니다. 미래의 **시작 시간**을 설정하면 *예약됨* 상태가 되며,
    그렇지 않으면 즉시 *실행 중* 상태로 시작합니다.
  </Step>
</Steps>

## 결과 및 재시도 작동 방식

각 통화 후 연락처에 결과가 지정됩니다 — 성공한 통화는 완료로
표시됩니다. 응답 없음으로 분류되거나, 음성사서함으로 감지되거나,
실패한 통화는 해당 결과가 **재시도 조건** 목록에 있고 연락처에 남은
시도 횟수가 있으면 재시도됩니다. 시도 횟수를 모두 사용한 연락처는
*소진됨*으로 표시되며, 재시도할 수 없는 실패는 *실패*로 표시됩니다.

<Note>
  계정 잔액 상태가 정상적이지 않으면 발신이 자동으로 일시 중지되며,
  정상 상태가 되면 재개됩니다. 장기 캠페인에는
  [자동 충전](/ko/guides/billing-and-topups)을 활성화해 두세요.
</Note>

## 모니터링 및 제어

각 캠페인 카드에는 상태와 진행 상황(예: "248건 중 173건
완료")이 표시됩니다. 캠페인을 열면 상태별 분류, 연락처별
결과 및 최근 통화를 확인할 수 있습니다 — 각각 통화 기록의 전체
트랜스크립트 및 녹화로 연결됩니다.

* **일시 중지 / 재개** — 일시 중지하면 새 발신이 중단됩니다. 이미
  진행 중인 통화는 자연스럽게 완료됩니다. 일시 중지된 캠페인은 수정하고 재개할 수 있습니다.
* **취소** — 캠페인을 영구적으로 중지합니다.
* 모든 연락처가 최종 상태에 도달하거나 **종료 시간**이 지나면
  캠페인은 자동으로 완료됩니다.

캠페인 상태: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. 연락처 상태: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

## 다음 단계

<CardGroup cols={2}>
  <Card title="통화를 실시간으로 모니터링" icon="tower-broadcast" href="/ko/guides/monitor-live-calls">
    캠페인 통화가 진행되는 동안 실시간으로 청취합니다.
  </Card>

  <Card title="아웃바운드 통화 API" icon="phone-arrow-up-right" href="/ko/guides/place-outbound-calls">
    프로그래밍 방식으로 개별 통화를 발신합니다.
  </Card>
</CardGroup>