> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Кампании

> Управление исходящими кампаниями в HubTalk AI v4.

# Кампании

Кампании объединяют исходящие звонки для определённой группы контактов. На этой странице описываются создание, запуск, мониторинг и анализ кампаний обзвона.

## Что позволяют кампании

С помощью кампании можно:

* подготовить список контактов для исходящих звонков
* назначить агента и параметры обзвона
* определить расписание звонков
* отслеживать прогресс и результаты кампании
* открывать отдельные звонки для проверки

## Список кампаний

При открытии вкладки **«Кампании»** отображаются счётчик **«Всего: N»** и кнопка **«Создать кампанию»**. Для поиска доступны фильтры:

* **«Поиск по имени»** — по названию кампании.
* **«Все статусы»** — черновик, запланирована, идёт, пауза, завершена или отменена.
* **«Все агенты»** — по назначенному агенту.
* **«Только с добавлением звонков»** — оставляет кампании, открытые к доливу номеров.

В таблице кампаний отображаются:

* **«Имя»** — название кампании.
* **«Агент»** — агент, назначенный для обзвона.
* **«Статус»** — текущее состояние: «Черновик», «Запланирована», «Идёт», «Пауза», «Завершена» или «Отменена».
* **«Даты»** — даты кампании.
* **«Скорость»** — скорость обзвона.
* **«Контакты»** — количество контактов.
* **«Прогресс»** — процент выполнения.
* **«Создана»** — дата и время создания.

Нажмите на строку кампании, чтобы открыть её детали.

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_campaigns_list.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=30cb7ea4ea20e4b2a71a6ad7af01d40e" alt="Список кампаний с фильтрами и кнопкой «Создать кампанию»" width="1440" height="900" data-path="images/v4_campaigns_list.png" />

## Детали кампании

При открытии кампании на странице деталей отображаются её статус и основные показатели:

* **«Контактов»** — сколько всего контактов в кампании.
* **«Дозвонились»** — сколько контактов удалось достать и какой это процент от всех.
* **«Средняя длительность»** — по подписи под числом, «только соединившиеся звонки».
* **«Наборов»** — сколько было попыток набора, и отдельной строкой «контактов набрано: N».

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_campaign_details_overview.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=756e7342bea12090c51b5390815e9e55" alt="Метрики кампании: «Контактов», «Дозвонились», «Средняя длительность» и «Наборов»" width="1440" height="900" data-path="images/v4_campaign_details_overview.png" />

### Результаты и конфигурация обзвона

* **«Разбивка исходов»** — сводка по результатам звонков; единица счёта — контакты, по последней завершённой попытке. Если завершённых попыток ещё нет, блок так и пишет.
* **«Конфигурация набора»** — показывает агента, классификацию обзвона, **«SIP-транк»**, **«Сабгруппу»**, **«Исходящий номер»**, **«Скорость обзвона»**, **«Дубли номеров»**, **«Повторы»** и **«Звонить по местному времени контакта»**. Повторы подписаны парой чисел и режимом интервалов: «9 повторов · 10 наборов, каждые 15 мин» либо «9 повторов · 10 наборов, интервалы: 2 мин, 5 мин, 1 сутки». После запуска конфигурация заморожена.
* **«Аттестация разрешения»** — отдельная карточка ниже: кто подписал, момент подписи, файл и его отпечаток, версия формулировки. Сама цель обзвона — маркетинг, обслуживание или взыскание задолженности — и выведенный из неё тир согласия стоят строкой **«Классификация»** в конфигурации набора. У кампаний, запущенных до введения аттестации, карточка честно сообщает, что подписи нет.

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_campaign_outcome_breakdown.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=e34e88aae25fa15a86de197698dfd8cd" alt="Блок «Разбивка исходов»" width="1440" height="900" data-path="images/v4_campaign_outcome_breakdown.png" />

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_campaign_dialing_config.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=ca97a2a2f15c3ea52847a5bfbd50ab96" alt="Блок «Конфигурация набора»" width="561" height="482" data-path="images/v4_campaign_dialing_config.png" />

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_campaign_attestation_card.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=ad4c204c1da6b5797421b31d9f584fa8" alt="Карточка аттестации: кто подписал, когда, под каким файлом и его отпечаток" width="1135" height="242" data-path="images/v4_campaign_attestation_card.png" />

### Состояние планировщика

Блок **«Состояние планировщика»** показывает контакты по состояниям — **«Ждут»**, **«В наборе»**, **«Завершены»**, **«Исчерпаны»**, **«Исключены»**, — строку **«Следующий набор»** с целевым и фактическим темпом, **«Удержания»** с причиной переноса, **«Исключено политикой»**, **«Этапы подавления DNC»**, а также счётчики ограничения нагрузки и инфраструктурных повторов.

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_campaign_scheduler_state.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=6749dad0f49c09d750897dbe7d7526c3" alt="Блок состояния планировщика: контакты по состояниям, следующий звонок и темп" width="1135" height="263" data-path="images/v4_campaign_scheduler_state.png" />

## Частые вопросы

**Кампания идёт медленнее, чем я ожидал.** Вероятнее всего, часть контактов ждёт своего окна: в США человек в другом часовом поясе может быть доступен всего несколько часов в день по вашему времени. Контакты не теряются — они обзваниваются, когда наступает разрешённое время.

**Часть контактов не была набрана.** Три обычные причины: номер в реестре «не звонить»; строка отклонена при загрузке (смотрите отчёт импорта); контакт ещё ждёт своего окна. Всё это видно на карточке кампании.

**Почему звонки прекратились в 20:00, если я поставил до 21:00?** В этом штате закон строже федерального. Кампания может сузить окно, но не расширить. Вне американского профиля та же логика действует для окна обзвона организации.

**Что происходит, когда правила обновляются?** Правила обновляются по мере изменения законов. Изменение действует на все последующие звонки, уже отложенные контакты пересчитываются по новым правилам. История изменений доступна для просмотра.

**Можно ли отключить ограничения для одной кампании?** Смотря какие. **Законодательные — нет:** капы штатов, Reg F и окна звонков не отключаются и не расширяются ни через интерфейс, ни через API. Сузить своё окно можно. **Свои частотные лимиты — да,** это делает администратор платформы, для одной кампании или для всей компании; см. [Как выключить лимиты](/ru/v4/platform/campaigns/frequency#как-выключить-лимиты).

## Что нужно от вас

* **Право звонить.** Платформа фиксирует вашу аттестацию, но не проверяет её: основания для звонка обеспечиваете вы.
* **Точность данных о локации** — для кампаний в США часовой пояс и штат выводятся из того, что вы указали.
* **Актуальность реестра «не звонить».** Если человек просил не звонить другим способом — письмом, через сайт, оператору — внесите номер в реестр: платформа узнаёт об этом только из разговора, и только под американским профилем.
* **Корректная выгрузка.** Дубли, пустые номера и потерянные ведущие нули в индексах — самые частые причины отклонения строк.

## Сценарий работы с кампанией

Кампания создаётся мастером из пяти шагов — подробно на странице [Запуск кампании](/ru/v4/platform/campaign-launch):

1. **Кампания** — имя, агент и классификация обзвона.
2. **Расписание** — даты, часовой пояс, рабочие часы.
3. **Дозвон** — телефония, скорость, дубли, повторы и логика обзвона.
4. **Контакты** — загрузка файла и отчёт импорта.
5. **Проверка и запуск** — блокеры, предупреждения и подпись аттестации.

Дальше следите за прогрессом и анализируйте завершённые звонки.

## Дальше по теме

<CardGroup cols={2}>
  <Card title="Контакты кампании" icon="address-book" href="/ru/v4/platform/campaigns/contacts">
    Файл контактов и требования к нему, долив партий в идущую кампанию, хранение файлов и сверка с реестром «не звонить».
  </Card>

  <Card title="Частота звонков" icon="repeat" href="/ru/v4/platform/campaigns/frequency">
    Как часто можно звонить на один номер, откуда берутся цифры, как выключить лимиты и чего выключатель не касается.
  </Card>

  <Card title="Кампании в США" icon="flag-usa" href="/ru/v4/platform/campaigns/us-market">
    Окна звонков по местному времени контакта и требования к географии в файле.
  </Card>

  <Card title="Запуск кампании" icon="rocket" href="/ru/v4/platform/campaign-launch">
    Мастер из пяти шагов: агент и классификация, расписание, дозвон, контакты, проверка и аттестация.
  </Card>
</CardGroup>
