> ## 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 исходящих звонков](/ru/guides/place-outbound-calls).

## Предварительные требования

* Развёрнутый голосовой агент.
* **VoIP-номер**, подключённый к вашей организации для исходящих звонков —
  демо-номера предназначены только для входящих звонков и не могут использоваться для звонков кампании. См.
  [Подключение VoIP-провайдера](/ru/guides/voip-providers).
* Контакты в виде CSV-файла (или вставленного JSON) со столбцом `phone` или
  `phone_number`. **До 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>
  Набор номера автоматически приостанавливается, пока состояние баланса вашего аккаунта
  не будет надлежащим, и возобновляется после его восстановления. Для длительных кампаний
  включите [автопополнение](/ru/guides/billing-and-topups).
</Note>

## Мониторинг и управление

На карточке каждой кампании отображаются её статус и прогресс (например, «173 из 248
завершено»). Откройте кампанию, чтобы посмотреть разбивку по статусам,
результаты по каждому контакту и недавние звонки — для каждого доступны полная расшифровка и
запись в истории звонков.

* **Приостановить / возобновить** — приостановка прекращает новые наборы номера; уже
  выполняемые звонки завершаются естественным образом. Приостановленные кампании можно редактировать и возобновлять.
* **Отменить** — навсегда останавливает кампанию.
* Кампания завершается самостоятельно, когда каждый контакт достигает финального
  статуса или наступает время **окончание в**.

Статусы кампании: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Статусы контакта: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

## Следующие шаги

<CardGroup cols={2}>
  <Card title="Слушайте звонки в реальном времени" icon="tower-broadcast" href="/ru/guides/monitor-live-calls">
    Подключайтесь к звонкам кампании по мере их поступления.
  </Card>

  <Card title="API исходящих звонков" icon="phone-arrow-up-right" href="/ru/guides/place-outbound-calls">
    Совершайте отдельные звонки программно.
  </Card>
</CardGroup>