> ## 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 вихідних дзвінків](/uk/guides/place-outbound-calls).

## Передумови

* Розгорнутий голосовий агент.
* **VoIP-номер телефону**, підключений до вашої організації для здійснення дзвінків —
  демо-номери призначені лише для вхідних дзвінків і не можуть здійснювати дзвінки в межах кампаній. Див.
  [Підключення VoIP-провайдера](/uk/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>
  Набір номерів автоматично призупиняється, якщо баланс вашого облікового запису не в належному
  стані, і відновлюється, щойно це зміниться. Для тривалих кампаній увімкніть
  [автоматичне поповнення](/uk/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="/uk/guides/monitor-live-calls">
    Прослуховуйте дзвінки кампанії в реальному часі.
  </Card>

  <Card title="API вихідних дзвінків" icon="phone-arrow-up-right" href="/uk/guides/place-outbound-calls">
    Здійснюйте окремі дзвінки програмно.
  </Card>
</CardGroup>