# Обзвоны

Агент обзванивает список номеров по расписанию, с повторами, и записывает каждый звонок

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

**Обзвон** — это серия исходящих AI-звонков: агент звонит по вашей базе со своим промптом, голосом и номером. Звонки идут в заданные временные окна, повторяются при недозвоне или «занято», а каждый звонок попадает в **Историю** с транскриптом и записью.

Откройте из боковой панели агента: **Настроить** > **Обзвоны**.

<CampaignsPageDemo />

## Перед стартом [#before-you-start]

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

## Создание обзвона [#create-a-campaign]

**Новый обзвон** открывает мастер из трёх шагов.

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

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

**2. Расписание**

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

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

| Поле          | Что делает                                                         |
| ------------- | ------------------------------------------------------------------ |
| Макс. попыток | 1–10 (по умолчанию 3). После этого номер помечается как недозвон   |
| Режим повтора | **Сразу**, **Через N минут** (1–1440) или **В следующее окно**     |
| Повторять при | **Нет ответа**, **Занято**, **Ошибка** — все включены по умолчанию |

**Создать обзвон** сохраняет его как **Черновик** и открывает **Источники** — откуда берутся номера.

## Добавление номеров [#add-numbers]

Обзвон получает номера из одного или нескольких источников:

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

```
+380991234567
phone,name,city
+380991234568,Anna,Kyiv
```

## Запуск [#run-it]

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

| Статус             | Действия                     |
| ------------------ | ---------------------------- |
| Черновик           | Запустить обзвон, Удалить    |
| Идёт               | Пауза, Отменить обзвон       |
| На паузе           | Возобновить, Отменить обзвон |
| Завершён / Отменён | Удалить                      |

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

## Результаты [#results]

* **Обзор** — прогресс и счётчики: всего, ждут, набираются, дозвонились, не дозвонились, отменены.
* **Контакты** — каждый номер со статусом (**Ждёт**, **Набирается**, **Дозвонились**, **Не дозвонились**, **Отменён**), использованными попытками, последним результатом и следующей попыткой.
* **История попыток** — кликните номер, чтобы увидеть результат каждой попытки (**Соединение**, **Нет ответа**, **Занято**, **Ошибка**, **Без набора**), и **Открыть звонок** — транскрипт и запись.

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

## Дальше [#next]

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