# Обдзвони

Агент обдзвонює список номерів за розкладом, з повторами, і записує кожен дзвінок

> Full REST + WebSocket API reference: https://api.happ.tools/reference

**Обдзвін** — це серія вихідних AI-дзвінків: агент телефонує по вашій базі зі своїм промптом, голосом і номером. Дзвінки йдуть у задані вікна, повторюються при недодзвоні чи «зайнято», а кожен дзвінок потрапляє в **Історію** з транскриптом і записом.

Відкрийте з бічної панелі агента: **Налаштувати** > **Обдзвони**.

<CampaignsPageDemo />

## Перед стартом [#перед-стартом]

* В агента підключений увімкнений **номер телефону** — див. [Номери телефонів](/docs/agents/phones). Без нього обдзвін стане на паузу з помилкою конфігурації.
* У воркспейсі є **баланс**. Дзвінки тарифікуються як звичайне голосове використання; коли баланс закінчується, обдзвін стає на паузу і продовжується після поповнення.
* Щоб створювати й запускати обдзвони, потрібен доступ на запис до **Дзвінків**.

## Створення обдзвону [#створення-обдзвону]

**Новий обдзвін** відкриває майстер із трьох кроків.

**1. Основне**

| Поле  | Що робить                                                                                                                                    |
| ----- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Назва | Щонайменше 2 символи, наприклад «Весняна реактивація»                                                                                        |
| Агент | Зафіксований — телефонує цей агент зі своїм промптом, голосом і мовою                                                                        |
| Лінії | Скільки дзвінків іде одночасно, 1–100 (за замовчуванням 1 — номери набираються по черзі). Обмежено тарифом; можна змінювати під час обдзвону |

**2. Розклад**

| Поле                           | Що робить                                                                                                                         |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| Часовий пояс                   | Годинник обдзвону для вікон і дат                                                                                                 |
| Дата початку / Дата завершення | Необов'язкові. Коли дата завершення минає, обдзвін завершується, а всі, до кого не додзвонилися, позначаються **Не додзвонилися** |
| Вікна дзвінків                 | Проміжки «з–до» (нове вікно — 09:00–18:00). Дзвінки йдуть лише всередині них. Без вікон — у будь-який час доби                    |

**3. Повтори та запуск**

| Поле            | Що робить                                                                      |
| --------------- | ------------------------------------------------------------------------------ |
| Макс. спроб     | 1–10 (за замовчуванням 3). Після цього номер позначається як недодзвін         |
| Режим повтору   | **Одразу**, **Через N хвилин** (1–1440) або **У наступне вікно**               |
| Повторювати при | **Немає відповіді**, **Зайнято**, **Помилка** — усі увімкнені за замовчуванням |

**Створити обдзвін** зберігає його як **Чернетку** і відкриває **Джерела** — звідки беруться номери.

## Додавання номерів [#додавання-номерів]

Обдзвін отримує номери з одного чи кількох джерел:

| Джерело           | Як працює                                                                                                                                                                                                                                                        |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Вставлений список | Один номер на рядок або CSV з `,` чи `;`. Перший стовпець — телефон; решта стає змінними дзвінка (за назвами з рядка заголовків, інакше `var1…varN`), які агент може використати в промпті. До 10 000 номерів за раз; некоректні номери й дублікати відкидаються |
| Вибірка з CRM     | Умови по KeyCRM, NetHunt або SalesDrive з живим попереднім переглядом. Запускається одразу, далі — за інтервалом чи розкладом, пропускаючи номери, яким дзвонили за останні N днів                                                                               |
| Подія CRM         | Скопіюйте адресу вебхука в CRM; кожна подія додає номер. Можна обмежити етапом угоди. Такий обдзвін сам не завершується                                                                                                                                          |
| Google-таблиця    | Надайте доступ до таблиці email-адресі сервісного акаунта, яку показує Happ, вставте посилання, оберіть аркуш і стовпець з телефоном, зіставте інші стовпці зі змінними промпту                                                                                  |

```
+380991234567
phone,name,city
+380991234568,Анна,Київ
```

## Запуск [#запуск]

Поки обдзвін у статусі **Чернетка**, дзвінки не йдуть — натисніть **Запустити обдзвін**.

| Статус                | Дії                          |
| --------------------- | ---------------------------- |
| Чернетка              | Запустити обдзвін, Видалити  |
| Триває                | Пауза, Скасувати обдзвін     |
| На паузі              | Відновити, Скасувати обдзвін |
| Завершено / Скасовано | Видалити                     |

* **Пауза** зупиняє нові дзвінки; ті, що вже передані провайдеру, можуть ще завершитися.
* **Скасувати** скасовує всі номери в очікуванні, і цю дію не можна відмінити.
* Налаштування можна змінювати лише в статусах **Чернетка** і **На паузі**; **Лінії** — також під час обдзвону (діє приблизно за 20 секунд).
* Happ сам ставить обдзвін на паузу при **Недостатньо балансу** або **Помилці конфігурації** (немає номера, номер вимкнено). Усуньте причину й натисніть **Відновити**.

## Результати [#результати]

* **Огляд** — прогрес і лічильники: усього, чекають, набираються, додзвонилися, не додзвонилися, скасовані.
* **Контакти** — кожен номер зі статусом (**Чекає**, **Набирається**, **Додзвонилися**, **Не додзвонилися**, **Скасовано**), використаними спробами, останнім результатом і наступною спробою.
* **Історія спроб** — клікніть номер, щоб побачити результат кожної спроби (**З'єднання**, **Немає відповіді**, **Зайнято**, **Помилка**, **Без набору**), і **Відкрити дзвінок** — транскрипт і запис.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Далі [#далі]

* [Номери телефонів](/docs/agents/phones) — номер, з якого телефонує агент
* [Голос](/docs/agents/voice) — як агент звучить і говорить
* [Аналіз](/docs/workspace/analysis) — оцініть дзвінки обдзвону монітором