---
title: "Вихідні кампанії"
description: "Завантажте список контактів і доручіть агенту опрацювати його — із вікнами для дзвінків, повторними спробами та відстеженням прогресу в реальному часі."
---
Кампанії телефонують списку контактів від вашого імені: виберіть агента, завантажте
CSV, установіть дозволений час для дзвінків, і ThunderPhone опрацьовуватиме список
— повторюючи дзвінки без відповіді та на голосову пошту за вибраним вами розкладом. Знайдіть
їх у розділі **Взаємодія → Кампанії** (`/dashboard/campaigns`).
Для одноразових програмних дзвінків використовуйте
[API вихідних дзвінків](/uk/guides/place-outbound-calls).
## Передумови
- Розгорнутий голосовий агент.
- Номер телефону з увімкненими вихідними дзвінками. Номери VoIP клієнтів і надалі підтримують кампанії. Номери ThunderPhone спочатку підтримують лише вхідні дзвінки; адміністратор організації може надіслати запит на вихідні дзвінки на сторінці «Номери телефонів». ThunderPhone перевіряє кожен запит вручну, і схвалені номери можуть запускати кампанії. Див. [Підключення постачальника VoIP](/uk/guides/voip-providers).
- Контакти у файлі CSV (або вставлений JSON) зі стовпцем `phone` або `phone_number`. **До 5 000 рядків на завантаження**, кодування UTF-8. Нові завантаження JSON мають бути плоскими: додаткові значення можуть бути рядками, числами, булевими значеннями або `null`. Рядки, що містять масиви або вкладені об’єкти, відхиляються окремо з повідомленням про перевірку; дійсні рядки все одно імпортуються. Комірки CSV є рядками. Прийняті додаткові стовпці зберігаються як змінні для кожного контакту в записах контактів кампанії та автоматично передаються під час кожного набору номера. ThunderPhone також класифікує збережений промпт агента перед кожним вихідним дзвінком, щоб визначити, чи має агент проходити телефонне меню. Заголовки, наприклад `name` і `account_id`, відповідають `{{name}}` і `{{account_id}}` у промпті збереженого агента. Зіставлення імені також може об’єднувати стовпці в `name`. Див. [змінні для кожного дзвінка](/uk/guides/call-variables), щоб дізнатися про значення за замовчуванням, правила іменування, обмеження об’єкта 32 KB і значення, що повертаються у вебхуках завершення.
Старіші записи контактів можуть містити вкладені метадані з попередніх завантажень JSON.
Ці метадані залишаються у збереженому контакті. Під час кожного дзвінка нескалярні значення не передаються
в корисному навантаженні змінних, а назви проігнорованих ключів записуються для цієї спроби без
запису значень. Повторні спроби використовують таке саме фільтрування.
## Створення кампанії
Вкажіть назву, виберіть **голосового агента** та **номер відправника**
(один із ваших номерів із підтримкою вихідних дзвінків).
Рядки з недійсним номером телефону або недійсними змінними відхиляються окремо,
а їхні номери рядків повертаються у звіті — решта імпортується без проблем.
Виберіть **часовий пояс** і **щоденне вікно початку/завершення**; кампанія
здійснює дзвінки лише в його межах. Часовий пояс визначається за поясом вашого номера відправника
(за кодом регіону в США та Канаді, за країною в інших регіонах) або, для
номерів, що охоплюють кілька поясів, наприклад безкоштовних,
за часовим поясом вашого браузера. Підказка під полем вказує, який саме пояс використовується. За замовчуванням вікно
становить 9:00–17:00. Якщо вікно починається до 8:00 або завершується після 21:00, відображається
попередження: дзвінки поза цими годинами можуть порушувати правила щодо часу дзвінків,
наприклад вимоги TCPA. Якщо час завершення раніше за час початку, вікно переходить через північ: 22:00 →
02:00 означає дзвінки з 22:00 до 02:00 наступного дня, з попередженням. Вікно
діє в часовому поясі кампанії, а не кожного контакту, тому розділяйте
контакти за часовими поясами, якщо вони розподілені між ними.
За потреби встановіть **початок о**, щоб запланувати запуск, і
**завершення о**, після якого кампанія завершується автоматично.
- **Одночасні дзвінки** — скільки дзвінків ця кампанія виконує одночасно
(1–10, за замовчуванням 3). Кампанії не починають нові дзвінки, поки у вашій
організації виконується 10 вихідних дзвінків, тому паралельні
кампанії використовують спільний ліміт. Кожен дзвінок також враховується в
[ліміті одночасних дзвінків](/api-reference/introduction#call-limits) вашої організації
(за замовчуванням 20 для вхідних, вихідних, вебдзвінків і тестових дзвінків).
Коли цього ліміту досягнуто або на той самий номер телефонували
протягом останніх 10 секунд, контакт просто чекає наступного проходу; його
спроби не витрачаються.
- **Максимальна кількість спроб** — скільки разів можна зателефонувати кожному контакту
(1–10, за замовчуванням 2).
- **Інтервал перед повторною спробою (хвилини)** — час очікування перед повторною спробою (щонайменше 30,
за замовчуванням 60).
- **Повторювати за** — які результати запускають повторну спробу: **немає відповіді**,
**голосова пошта**, **невдалий дзвінок** (усі ввімкнено за замовчуванням).
Потрібно більше спроб або коротший інтервал? Зверніться до служби підтримки:
працівники можуть збільшити обидва ліміти для вашої організації.
Кампанії створюються як чернетки — контакти можна додавати лише тоді, коли
кампанія є чернеткою. Для запуску кампанії потрібна явна згода
на оплату дзвінків. Якщо вказано майбутній **початок о**, кампанія стає
*запланованою*; інакше вона одразу починає *виконуватися*.
Кампанії, збережені до запровадження цих лімітів, продовжують виконуватися точно відповідно до налаштувань.
Їхня кількість спроб та інтервали залишаються збереженими після інших змін.
## Як працюють результати та повторні спроби
Після кожного дзвінка контакту призначається результат — успішні дзвінки
позначаються як завершені; дзвінок із результатом «немає відповіді», виявленою
голосовою поштою або помилкою повторюється, якщо цей результат є у вашому списку
**повторювати для** і для контакту залишилися спроби. Контакти, у яких
закінчилися спроби, позначаються як *вичерпані*; помилки, для яких повтор не
передбачено, позначаються як *невдалі*.
Набір номерів автоматично призупиняється, якщо баланс вашого облікового запису
не в належному стані, і відновлюється, щойно це зміниться. Для тривалих кампаній
увімкніть [автоматичне поповнення](/uk/guides/billing-and-topups).
## Моніторинг і керування
Кожна картка кампанії відображає її статус і прогрес (наприклад, «173 із 248
завершено»). Відкрийте кампанію, щоб переглянути розподіл за статусами,
результати для кожного контакту та останні дзвінки — кожен із них містить
посилання на повну розшифровку й запис в історії дзвінків.
- **Призупинити / відновити** — призупинення зупиняє нові набори номерів; дзвінки,
що вже виконуються, завершуються природно. Призупинені кампанії можна
редагувати та відновлювати.
- **Скасувати** — назавжди зупиняє кампанію.
- Кампанія завершується самостійно, коли кожен контакт досягає кінцевого
стану або минає час **завершити о**.
Статуси кампанії: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Статуси контакту: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Наступні кроки
Слухайте дзвінки кампанії в реальному часі.
Здійснюйте окремі дзвінки програмно.