---
title: "아웃바운드 캠페인"
description: "연락처 목록을 업로드하고 에이전트가 통화 가능 시간, 재시도 및 실시간 진행 상황을 통해 목록을 처리하도록 하세요."
---
캠페인은 사용자를 대신해 연락처 목록에 전화를 겁니다. 에이전트를 선택하고, CSV를 업로드하고, 통화 허용 시간을 설정하면 ThunderPhone이 목록을 처리합니다
— 선택한 일정에 따라 응답 없음 및 음성사서함에 재시도합니다. **인게이지먼트 → 캠페인** (`/dashboard/campaigns`)에서 찾을 수 있습니다.
일회성 프로그래밍 방식 통화에는
[발신 통화 API](/ko/guides/place-outbound-calls)를 대신 사용합니다.
## 사전 요구 사항
- 배포된 음성 에이전트.
- 발신이 활성화된 전화번호. 고객 VoIP 번호는 계속 캠페인을 지원합니다. ThunderPhone 번호는 처음에는 수신 전용이며, 조직 관리자가 전화번호 페이지에서 발신 통화를 요청할 수 있습니다. ThunderPhone은 각 요청을 수동으로 검토하며, 승인된 번호는 캠페인을 실행할 수 있습니다. [VoIP 제공업체 연결](/ko/guides/voip-providers)을 참조하세요.
- `phone` 또는 `phone_number` 열이 있는 CSV 파일(또는 붙여넣은 JSON) 형식의 연락처. **업로드당 최대 5,000개 행**, UTF-8 인코딩. 새 JSON 업로드는 평면 구조여야 합니다. 추가 값은 문자열, 숫자, 불리언 또는 `null`일 수 있습니다. 배열이나 중첩 객체가 포함된 행은 검증 메시지와 함께 개별적으로 거부되지만, 유효한 행은 계속 가져옵니다. CSV 셀은 문자열입니다. 허용되는 추가 열은 캠페인의 연락처 레코드에 연락처별 변수로 유지되며 각 통화에 자동으로 제공됩니다. ThunderPhone은 각 발신 통화 전에 저장된 에이전트 프롬프트도 분류하여 에이전트가 전화 메뉴를 탐색해야 하는지 결정합니다. `name` 및 `account_id` 같은 헤더는 저장된 에이전트 프롬프트의 `{{name}}` 및 `{{account_id}}`와 일치합니다. 이름 매핑은 열을 `name`으로 결합할 수도 있습니다. 기본값, 명명 규칙, 32 KB 객체 제한 및 완료 웹훅에서 반환되는 값은 [통화별 변수](/ko/guides/call-variables)를 참조하세요.
이전 연락처 레코드에는 과거 JSON 업로드의 중첩 메타데이터가 포함될 수 있습니다.
해당 메타데이터는 저장된 연락처에 유지됩니다. 각 발신은 변수 페이로드에서 스칼라가 아닌 값을 제외하고
값을 기록하지 않은 채 해당 시도에서 무시된 키 이름을 기록합니다. 재시도에도 동일한 필터링이 적용됩니다.
## 캠페인 만들기
이름을 지정하고 **음성 에이전트**를 선택한 다음 **발신 번호**를 선택합니다
(아웃바운드가 활성화된 번호 중 하나).
전화번호 또는 변수가 유효하지 않은 행은 개별적으로 거부되며 해당 행 번호와 함께
보고됩니다. 나머지 행은 정상적으로 가져옵니다.
**시간대**와 일일 **시작/종료** 시간을 선택합니다. 캠페인은 해당 시간 내에서만
전화를 겁니다. 시간대는 발신 번호의 시간대(미국과 캐나다에서는 지역 번호 기준,
그 외 지역에서는 국가 기준) 또는 수신자 부담 번호처럼 여러 시간대에 걸치는
번호의 경우 브라우저의 시간대를 기준으로 합니다. 필드 아래의 힌트에 적용되는
시간대가 표시됩니다. 기본 시간은 오전 9시~오후 5시입니다. 오전 8시 이전에
시작하거나 오후 9시 이후에 종료하는 시간대에는 경고가 표시됩니다. 해당 시간
외의 통화는 TCPA 등의 통화 가능 시간 규정을 위반할 수 있습니다. 종료 시간이
시작 시간보다 이르면 자정을 넘깁니다. 예를 들어 22:00 → 02:00은 경고와 함께
오후 10시부터 다음 날 오전 2시까지 전화를 겁니다. 시간대는 각 연락처의
시간대가 아니라 캠페인의 시간대를 기준으로 적용되므로, 연락처가 여러
시간대에 분산되어 있으면 시간대별로 나눕니다.
선택적으로 **시작 시간**을 설정하여 시작을 예약하고, 이후 캠페인이 자동으로
완료되는 **종료 시간**을 설정할 수 있습니다.
- **동시 통화** — 이 캠페인이 동시에 실행하는 통화 수입니다
(1~10, 기본값 3). 조직에서 진행 중인 아웃바운드 통화가 10건이면 캠페인은
새 통화를 시작하지 않으므로, 병렬 캠페인은 이 예산을 공유합니다. 모든 통화는
조직의 [동시 통화 한도](/api-reference/introduction#call-limits)에도 포함됩니다
(기본값 20, 인바운드, 아웃바운드, 웹 및 테스트 통화 전체에 적용).
이 한도에 도달했거나 같은 번호로 지난 10초 이내에 통화한 경우, 연락처는
다음 실행 순서를 기다리며 시도 횟수는 차감되지 않습니다.
- **최대 시도 횟수** — 각 연락처에 전화를 걸 수 있는 횟수입니다
(1~10, 기본값 2).
- **재시도 대기 시간(분)** — 재시도 전 대기 시간입니다(최소 30,
기본값 60).
- **재시도 조건** — 재시도를 실행하는 결과입니다. **응답 없음**,
**음성 사서함**, **실패**(모두 기본적으로 활성화).
더 많은 시도 횟수나 더 짧은 간격이 필요합니까? 지원팀에 문의하십시오. 담당자가
조직의 두 한도를 모두 늘릴 수 있습니다.
캠페인은 초안으로 생성됩니다. 연락처는 캠페인이 초안 상태일 때만 추가할 수
있습니다. 캠페인을 시작하려면 통화 요금에 명시적으로 동의해야 합니다. 미래의
**시작 시간**을 설정하면 *예약됨* 상태가 되고, 그렇지 않으면 즉시 *실행 중*
상태가 됩니다.
이 한도가 적용되기 전에 저장된 캠페인은 구성된 설정 그대로 계속 실행됩니다.
다른 항목을 수정해도 시도 횟수와 간격은 저장된 상태로 유지됩니다.
## 결과 및 재시도 작동 방식
각 통화 후 연락처에 결과가 부여됩니다. 성공한 통화는
완료로 표시됩니다. 부재중으로 분류되거나, 음성사서함으로 감지되거나,
실패한 통화는 해당 결과가 **다음 경우 재시도** 목록에 있고 연락처에
남은 시도 횟수가 있으면 재시도됩니다. 시도 횟수를 모두 사용한 연락처는
*소진됨*으로 표시되며, 재시도할 수 없는 실패는 *실패*로 표시됩니다.
계정 잔액 상태가 양호하지 않은 동안에는 발신이 자동으로 일시 중지되며,
상태가 정상화되면 재개됩니다. 장기 캠페인에서는
[자동 충전](/ko/guides/billing-and-topups)을 활성화해 두세요.
## 모니터링 및 제어
각 캠페인 카드에는 상태와 진행률(예: "248개 중 173개
완료")이 표시됩니다. 캠페인을 열면 상태별 분석, 연락처별 결과,
최근 통화를 확인할 수 있으며, 각 항목은 통화 기록의 전체 녹취록 및
녹음으로 연결됩니다.
- **일시 중지 / 재개** — 일시 중지하면 새 발신이 중단되며, 이미
진행 중인 통화는 자연스럽게 완료됩니다. 일시 중지된 캠페인은 수정하고 재개할 수 있습니다.
- **취소** — 캠페인을 영구적으로 중지합니다.
- 모든 연락처가 최종 상태에 도달하거나 **종료 시간**이 지나면 캠페인은
자동으로 완료됩니다.
캠페인 상태: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. 연락처 상태: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## 다음 단계
진행 중인 캠페인 통화를 실시간으로 청취하세요.
개별 통화를 프로그래밍 방식으로 발신하세요.