> ## 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.

# Добавление звонков

> Как долить номера в уже созданную кампанию: блок «Добавить партию звонков», аттестация, лимиты и что делает пометка «С добавлением звонков».

# Добавление звонков

В уже созданную кампанию можно добавить новые номера — **партию звонков**. Номера добавятся к существующим контактам кампании, а файл запуска и его подпись не изменятся.

## В какие кампании можно добавить звонки

Партию принимает **любая незавершённая кампания**: черновик, запланированная, идущая или на паузе. В завершённую или отменённую кампанию добавить звонки нельзя.

Когда добавленные номера пойдут в набор, зависит от статуса кампании:

* **идущая** — номера сразу встают в очередь набора;
* **на паузе** — после возобновления; под принятой партией будет строка «Кампания приостановлена — набор продолжится после возобновления»;
* **черновик** — после запуска кампании.

## Как добавить партию

1. Откройте карточку кампании на странице **«Кампании»**.
2. Найдите блок **«Добавить партию звонков»** — он под блоком аттестации (в черновике — под загрузкой контактов).
3. Отметьте галочку **аттестации разрешения**. Пока она не отмечена, файл не примется.
4. Перетащите файл в поле или нажмите **«Выберите файл»**.

Галочка аттестации сбрасывается после каждой загрузки — принятой или отклонённой — и при смене версии формулировки аттестации. Для следующей партии её нужно отметить заново.

Добавлять партии могут все роли, которым открыты кампании: **администратор**, **разработчик**, **менеджер** и **участник**. Подпись партии записывается от имени того, кто её загрузил, — так же, как подпись запуска. Подробнее о правах — [Роли и доступ](https://docs.hubtalk.ai/ru/v4/platform/roles.md).

Если агента кампании [скрыли от участников](https://docs.hubtalk.ai/ru/v4/platform/agents/list.md), партию в уже запущенную кампанию всё равно примут: скрытие агента идущую кампанию не останавливает. Партию в черновик на скрытом агенте тоже примут, но менеджер и участник такую кампанию запустить не смогут — после приёма партии кабинет покажет это блокером.

**Требования к файлу:** CSV или XLSX, до 1000 строк в партии, до 10 МБ. Колонки — как у основного [файла контактов](https://docs.hubtalk.ai/ru/v4/platform/campaigns/contacts.md) кампании.

## Партия принимается целиком или отклоняется целиком

Половина файла не заедет. Если в партии есть хотя бы одна строка с ошибкой или хотя бы один номер из реестра «не звонить», не добавится ни один контакт — кабинет назовёт причину и покажет отчёт по строкам:

* **«Партия звонков отклонена целиком: есть строки с ошибками данных»**;
* **«Партия звонков отклонена целиком: номера из реестра «не звонить»»**.

Если в партии есть и ошибки данных, и номера из реестра, причиной называются ошибки данных. Отклонённая партия остаётся в **«Истории загрузок»** с отчётом по строкам. Исправьте файл и загрузите его снова.

* **Тот же самый файл второй раз не примется** — ни повтор файла запуска, ни повтор уже принятой партии. Так двойная загрузка не задвоит номера. Номер, который уже есть в кампании, но пришёл в другом файле, принимается как новый контакт и набирается снова.
* **Если в кампании включено «Звонить по местному времени контакта»** (профиль Казахстана), у каждой строки партии должен быть часовой пояс.

## После приёма партии

Кабинет показывает **«Партия принята: N контактов добавлено»** и под ней — что сейчас мешает набору, если что-то мешает.

* **Если в партии нет колонки, которую требует подпись агента**, это блокер: номера не наберутся, пока колонки нет.
* **Если в партии нет колонки, которая была в файле запуска** и используется агентом, кабинет предупредит об этом: у этих номеров переменная будет пустой.

## Аттестация для каждой партии

Подпись под файлом запуска не распространяется на добавленные номера: право звонить подтверждается для каждой партии отдельно. Подпись партии видна в карточке кампании в результатах загрузки — кто подписал и когда.

## Что значит пометка «С добавлением звонков»

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

* **обычная кампания** завершается сама, как только все контакты обработаны. После этого добавить звонки в неё нельзя;
* **кампания «С добавлением звонков»** при пустой очереди не завершается и принимает новые партии до даты окончания. Завершают её только дата окончания или отмена.

Пока такая кампания не завершена, в списке под прогрессом она показывает **«Ждёт новые звонки»**. Если очередь пуста, в карточке кампании в блоке **«Состояние планировщика»** видна строка «Очередь пуста: кампания ждёт новые звонки и сама не завершится — закроется по дате окончания … или отменой».

Пометка ставится только при создании кампании — галочкой **«Открыть кампанию к добавлению звонков»** на шаге **«Расписание»** или через [Web API](https://docs.hubtalk.ai/ru/v4/web-api.md) — и потом не меняется. У такой кампании дата окончания обязательна и не может быть дальше 30 суток: иначе она не завершилась бы никогда. Если кампания доходит до даты окончания, а в очереди ещё остались номера, они закрываются как **«Исчерпаны»**.

> [!NOTE]
>
> **Через API партия добавляется тем же механизмом**: `POST /v1/campaigns/{id}/calls`. Номера передаются JSON-списком `calls` (до 1000 элементов), подтверждение аттестации — в теле: `"attestation": {"confirmed": true}`; заголовок `Idempotency-Key` обязателен. Проверки строк, реестр «не звонить» и принцип «целиком или никак» — те же, что в кабинете. От двойной отправки защищает ключ идемпотентности: повтор запроса с тем же ключом не создаст вторую партию. Подробно — в [Web API](https://docs.hubtalk.ai/ru/v4/web-api/campaign-manage.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.