Перейти к основному содержанию

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

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

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

Партию принимает любая незавершённая кампания: черновик, запланированная, идущая или на паузе. В завершённую или отменённую кампанию добавить звонки нельзя. Когда добавленные номера пойдут в набор, зависит от статуса кампании:
  • идущая — номера сразу встают в очередь набора;
  • на паузе — после возобновления; под принятой партией будет строка «Кампания приостановлена — набор продолжится после возобновления»;
  • черновик — после запуска кампании.

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

  1. Откройте карточку кампании на странице «Кампании».
  2. Найдите блок «Добавить партию звонков» — он под блоком аттестации (в черновике — под загрузкой контактов).
  3. Отметьте галочку аттестации разрешения. Пока она не отмечена, файл не примется.
  4. Перетащите файл в поле или нажмите «Выберите файл».
Галочка аттестации сбрасывается после каждой загрузки — принятой или отклонённой — и при смене версии формулировки аттестации. Для следующей партии её нужно отметить заново. Добавлять партии могут все роли, которым открыты кампании: администратор, разработчик, менеджер и участник. Подпись партии записывается от имени того, кто её загрузил, — так же, как подпись запуска. Подробнее о правах — Роли и доступ. Если агента кампании скрыли от участников, партию в уже запущенную кампанию всё равно примут: скрытие агента идущую кампанию не останавливает. Партию в черновик на скрытом агенте тоже примут, но менеджер и участник такую кампанию запустить не смогут — после приёма партии кабинет покажет это блокером. Требования к файлу: CSV или XLSX, до 1000 строк в партии, до 10 МБ. Колонки — как у основного файла контактов кампании.

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

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

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

Кабинет показывает «Партия принята: N контактов добавлено» и под ней — что сейчас мешает набору, если что-то мешает.
  • Если в партии нет колонки, которую требует подпись агента, это блокер: номера не наберутся, пока колонки нет.
  • Если в партии нет колонки, которая была в файле запуска и используется агентом, кабинет предупредит об этом: у этих номеров переменная будет пустой.

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

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

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

Пометка не про то, можно ли добавить звонки, а про то, что происходит, когда очередь опустела:
  • обычная кампания завершается сама, как только все контакты обработаны. После этого добавить звонки в неё нельзя;
  • кампания «С добавлением звонков» при пустой очереди не завершается и принимает новые партии до даты окончания. Завершают её только дата окончания или отмена.
Пока такая кампания не завершена, в списке под прогрессом она показывает «Ждёт новые звонки». Если очередь пуста, в карточке кампании в блоке «Состояние планировщика» видна строка «Очередь пуста: кампания ждёт новые звонки и сама не завершится — закроется по дате окончания … или отменой». Пометка ставится только при создании кампании — галочкой «Открыть кампанию к добавлению звонков» на шаге «Расписание» или через Web API — и потом не меняется. У такой кампании дата окончания обязательна и не может быть дальше 30 суток: иначе она не завершилась бы никогда. Если кампания доходит до даты окончания, а в очереди ещё остались номера, они закрываются как «Исчерпаны».
Через API партия добавляется тем же механизмом: POST /v1/campaigns/{id}/calls. Номера передаются JSON-списком calls (до 1000 элементов), подтверждение аттестации — в теле: "attestation": {"confirmed": true}; заголовок Idempotency-Key обязателен. Проверки строк, реестр «не звонить» и принцип «целиком или никак» — те же, что в кабинете. От двойной отправки защищает ключ идемпотентности: повтор запроса с тем же ключом не создаст вторую партию. Подробно — в Web API.