> ## 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.
# 23. Кампания обзвона
> От файла контактов до первого набора: импорт, повторы, окна времени, аттестация.
# Кампания обзвона: от файла до первого набора
**Цель модуля:** запустить обзвон списка контактов с правильными окнами времени, повторами и подписанной аттестацией.
Кампания собирается мастером на отдельной странице — **пять шагов**, и все они обратимы, пока кампания в статусе **Черновик**. «Далее» не пропускает вперёд при неполных данных и называет недостающие поля.
Имя, агент и **классификация** — цель обзвона: маркетинг, обслуживание или взыскание задолженности. От неё зависит требуемый тир согласия и текст аттестации, который вы подпишете на пятом шаге.
Окно дат, часовой пояс, рабочие часы и галочка «Звонить по местному времени контакта».
Транк, сабгруппа и исходящий номер (сворачиваемая группа «Телефония»), скорость обзвона, что делать с дублями, повторы и логика обзвона.
CSV или XLSX. Телефонная колонка распознаётся по заголовку, **все остальные колонки становятся переменными звонка**. Тут же читается отчёт импорта: сколько принято, что отклонено и почему.
Блокеры, предупреждения и подпись аттестации.
Запись кампании создаётся на переходе к шагу **Контакты** — до этого загружать файл некуда. **Уже созданную кампанию правят не мастером**, а диалоговым окном из её карточки; поля там те же.
**Выбор агента на первом шаге — список с поиском.** Наберите несколько букв имени вместо того, чтобы листать; так же устроены и остальные места выбора агента — карточка входящей сабгруппы, диалог тестового звонка, правило правки фраз.
Список предлагает только опубликованных агентов, а участнику — ещё и только тех, кто [помечен как видимый для участников](/ru/v4/platform/agents/list): недоделанные и снятые с обслуживания агенты ему не показываются вовсе. Администратор и разработчик видят всех, у скрытого стоит пометка «Скрыто от участников». Если агента скрыли уже после того, как кампания собрана, она продолжает работать и правиться, но **запустить** её участник не сможет — на шаге проверки появится блокер.
**Скорость обзвона означает ровно то, что написано.** Тиров девять — до **200** звонков в минуту, — и кампания наберёт ровно столько, сколько вы попросили: подбирать тир по фактической скорости не нужно. Общего потолка контура нет.
## Файл контактов: лимиты и колонки
CSV или XLSX; старый **XLS не поддерживается**. До **50 000 строк** и **10 МБ** — файл сверх лимита отклоняется целиком, а не обрезается. Обязательна одна колонка — телефон: платформа находит её по заголовку (`phone`, `mobile`, `tel` и похожим), а если узнаваемого заголовка нет — по содержимому. Имя берётся из `name` / `full_name` либо собирается из `first_name` и `last_name`. Все остальные колонки становятся переменными звонка.
**Самый полезный приём во всём модуле: скачайте образец файла прямо из формы создания кампании.** Образец собирается **под конкретного агента** — в нём уже стоят те колонки, которые агент использует в промптах. Это ровно та проверка, которую иначе делают вручную, сверяя `{{переменные}}` в узлах со заголовками в Excel.
**Дубли номеров** — три варианта на выбор: отклонять (по умолчанию, повторы едут в отчёт как ошибки), оставить первое вхождение или оставить последнее. В любом случае **номер попадает в кампанию не более одного раза**; повторные наборы бывают только перезвонами при недозвоне.
## Отчёт импорта — читать обязательно
На скриншоте: принято 6, с предупреждениями 1, отклонено 1, найден 1 дубль. Отчёт называет **номера строк** и причину («строки без читаемого телефона — строка 8»), выгружается в CSV/XLSX и хранится с версией загрузки.
Отдельно про географию: если хотя бы одна строка отклонена как «без пригодной локации», **запуск блокируется целиком** — с указанием количества строк и имени файла. Обхода нет и частичного запуска не бывает: файл нужно исправить и загрузить заново. Ниже — таблица переменных и красная строка про то, что агент использует переменные, для которых в файле нет колонок: они будут пустыми. Это самая частая причина «агент говорит странное»: в промпте есть `{{doctor}}`, а в файле такой колонки нет.
## Повторы: стандарт и экспертная логика
Стандарт — «перезвонить до N раз с интервалом M». Считаются именно **повторы** (0–9), первый набор в это число не входит, и на экране всегда стоят оба числа: «9 повторов · 10 наборов».
Интервал задаётся в двух режимах:
* **Один интервал** — одинаковая пауза между всеми наборами одного номера.
* **Свой интервал на каждый повтор** — интервал на каждый повтор отдельно, пилюлями «Повтор 1», «Повтор 2», … Так строится «сначала часто, потом реже»: 2 мин → 5 мин → 1 сутки → 3 суток. Значения — из фиксированного списка, **от 1 минуты до 7 суток**.
Если лестница повторов не укладывается в срок кампании, запуск предупредит («N повторов не состоится»), но не заблокирует.
Экспертная логика — правила «если *причина* → *действие*»: например `нет ответа → перезвонить на следующем проходе (до 2 раз)`, `голосовая почта → прекратить набор номера`, `цель не достигнута → перезвонить`. По постоянным причинам (клиент отказался, неверный номер, спам-блок) повтор запрещён на уровне схемы — так и должно быть.
Собирать правила руками каждый раз не нужно: над редактором правил стоит селектор **Пресет стратегии** с тремя встроенными наборами — **Стандартный** (занято до 3 перезвонов, нет ответа до 2), **Агрессивный** (занято ×5, нет ответа ×4, автоответчик ×2) и **Осторожный** (занято ×2, нет ответа ×1, автоответчик останавливает номер). Свой набор сохраняется кнопкой **Сохранить как пресет** и переиспользуется в других кампаниях; до 20 пресетов на организацию.
**Две грабли с пресетами.** Первая: любая правка правила переводит селектор в «Свои правила» — это нормально, но «Сохранить как пресет» доступно только в этом состоянии. Вторая: пресет несёт **только правила**, число повторов и интервалы остаются полями кампании — выбор пресета их не меняет. И правка своего пресета не догоняет уже настроенные кампании.
**Что считается постоянной причиной — зависит от рынка.** «Абонент отклонил» закрывает номер навсегда только на профиле США; на остальных профилях, включая наш, это транзиентная причина — номер вернётся в набор и потратит попытку.
## Частота: сколько раз вообще можно позвонить человеку
Повторы отвечают на вопрос «когда набрать снова». Частотные лимиты отвечают на другой — «сколько раз этому номеру вообще можно звонить», и считаются по номеру во всех кампаниях организации сразу. Две кампании, звонящие одному человеку, делят один бюджет, поэтому лестница повторов может не отработать до конца не из-за ошибки, а из-за частоты.
В мастере кампании и в карточке у каждого лимита показаны четыре вещи: **применяемый лимит** (то, что реально действует), **источник** — настройка организации, настройка кампании или законный кап, **рекомендация** и пометка **неприменимости**, если к этому типу кампании лимит не относится.
**Настройка кампании умеет только ужесточать.** Раздел называется «Настройка для этой кампании» и принимает значения строже организационных: ниже лимит или дольше пауза. Всё, что мягче, сервер откажется сохранить — узнать об этом лучше здесь, чем на кнопке «Сохранить» перед запуском.
В прогрессе кампании есть блок **Частота**: он разделяет контакты, **придержанные** ограничением (позвоним позже), и **закрытые** им (этой кампанией не позвоним). В листинге контактов рядом с каждым видна причина и сохранённое частотное решение — какое именно ограничение сработало, с какими счётчиками и до какого момента.
**В Казахстане лимиты по умолчанию выключены.** Рекомендованные значения — 2 звонка в сутки, 7 за неделю, пауза 24 часа — это американская практика; норма Казахстана другая: окно обзвона и реестр отказов. Если лимиты вам нужны, включите их себе сами — это будет добровольное самоограничение компании. Подробности — в [Кампаниях](/ru/v4/platform/campaigns/frequency#как-выключить-лимиты).
**Рабочие часы и часовые пояса**
Расписание задаётся днями недели и интервалами (переключатель «Ограничить расписанием»). Галочка **«Звонить по местному времени контакта»** берёт пояс из колонки `timezone` файла — для Казахстана это важно: Алматы и Актобе разъезжаются на час, и «09:00 по кампании» может оказаться 08:00 у клиента.
**Пустое расписание не означает «круглосуточно».** Если расписание не задано, действует **окно обзвона организации** — платформенный дефолт 08:00–21:00, и форма это прямо пишет. Расписание кампании может окно только сузить: контакт вне окна откладывается до ближайшего открытия, а расписание, целиком не пересекающееся с окном, отклоняется с причиной «пустое пересечение». Само окно меняет только администратор платформы, и изменение действует сразу на все кампании организации, включая запущенные.
**Пауза и остановка**
Кампанию можно поставить на паузу и возобновить; отменённую — нельзя. После запуска конфигурация набора заморожена: чтобы поменять скорость или правила, нужна новая кампания. Поэтому первый запуск делают на 20–30 контактах, а не на всей базе.