Контакты кампании

Загрузка контактов и результаты импорта

В блоке «Загрузка контактов» загружается файл. Блок «Результаты импорта» показывает принятые строки, предупреждения, отклонённые строки, дубликаты, использованную колонку телефона и ошибки по строкам. При наличии ошибок можно скачать отчёт в CSV или XLSX. В таблице переменных отображаются импортированные колонки, их ключи и процент заполнения. «История загрузок» показывает загруженные файлы, время загрузки и количество принятых строк.

Требования к файлу контактов

Принимаются CSV и XLSX. Устаревший XLS не поддерживается — пересохраните файл. Лимиты: до 50 000 строк и до 10 МБ; файл сверх лимита отклоняется целиком, а не обрезается.

Номер телефона — единственная обязательная колонка. Платформа находит её по названию (phone, phone_number, mobile, cell, tel и похожим), а если узнаваемого заголовка нет — определяет по содержимому. Строки с нечитаемым номером не отбрасываются молча: они попадают в отчёт импорта с номером строки.
Имя читается из колонки name / full_name либо собирается из first_name и last_name.
Любые другие колонки становятся переменными звонка: сумма задолженности, номер договора, дата платежа.

Скачайте образец файла из формы создания кампании. Образец собран под конкретного агента — в нём уже стоят те колонки, которые агент использует в промптах. Это самый быстрый способ не получить пустые переменные в разговоре, поэтому берите образец для того агента, с которым будете работать.

Повторяющиеся номера. Один человек может встретиться в файле несколько раз, и вы выбираете, что с этим делать:

Отклонять дубли (по умолчанию) — остаётся первое вхождение, остальные попадают в отчёт как ошибки. Вариант «громкий»: обычно повторы означают, что выгрузка из вашей системы работает неправильно, и об этом лучше узнать.
Оставить первое вхождение — повторы отбрасываются без ошибок.
Оставить последнее вхождение — если исправленные строки дописываются в конец файла.

При любом варианте номер попадает в кампанию не более одного раза. Повторные наборы одного человека возможны только как перезвоны при недозвоне.

Почему файл может быть отклонён целиком: колонка с номерами не найдена или не определяется однозначно; ни одной строки с пригодными данными; превышен лимит 50 000 строк или 10 МБ; неподдерживаемый формат (включая XLS) или повреждённый файл; для кампаний в США — нет ни contact_zip, ни contact_state. Точная причина указана в сообщении при загрузке.

Блок загрузки контактов: лимиты файла и кнопка скачивания образца под конкретного агента

Долить звонки в идущую кампанию

Обычная кампания закрывается сама, как только очередь опустела, и номера в неё после этого не принимаются. Если номера будут приходить партиями, кампанию создают открытой к добавлению звонков: опустевшая очередь её не завершает — завершают только дата окончания или отмена. В такую кампанию контакты доливаются прямо из кабинета, уже на ходу:

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

У открытой кампании дата окончания обязательна и не может быть дальше 30 суток: кампания без очереди и без даты не завершилась бы никогда. Те же партии можно слать через Web API — механизм один и тот же.

Хранение файлов

Загруженные файлы сохраняются: подпись аттестации указывает на конкретный документ, и файл всегда можно скачать в том виде, в каком кампания была запущена. Полный срок хранения отсчитывается с запуска кампании и настраивается для организации. Файл кампании, которая так и не была запущена, хранится недолго — по умолчанию две недели. Хранение можно отключить полностью: тогда останутся только сведения о файле и его контрольная сумма, но вы потеряете возможность предъявить сам файл, под которым подтверждали право звонить. По истечении срока файл удаляется, и это фиксируется: сведения о нём и дата удаления сохраняются.

Проверка по реестру «не звонить»

Загруженный файл сверяется с реестром «не звонить», и блок Совпадения с реестром «не звонить» показывает результат проверки целиком:

проверено читаемых строк — сколько строк файла имели читаемый телефон и были сверены;
не проверено строк — телефон не прочитан; эти строки не считаются чистыми и названы отдельно;
совпало строк · подавлено контактов — два разных числа: один номер мог встретиться в файле несколько раз;
таблица совпадений с колонками строка, номер, имя, причина и в реестре с — с полными цитатами, а не намёками. Если совпадений много, превью урезается, и тогда рядом появляется кнопка Скачать точный список (CSV или XLSX).

При нулевом результате блок не молчит, а сообщает, что совпадений нет и сколько строк проверено.

Блок совпадений с реестром «не звонить» до запуска: две находки с цитатами и выбор решения

Перед запуском требуется решение: блокировать запуск (по умолчанию) или пропустить совпавшие и запустить кампанию без них. Решение пишется в аудит кампании — кто, когда, сколько контактов и по какому файлу; новая загрузка обнуляет прежнее решение. Если набираемых контактов не осталось, пропуск недоступен. Сам файл не изменяется: строки остаются на месте, а платформа отказывает в наборе. После запуска экран заморожен и помечен «На момент запуска» — основание, на котором кампания пошла в набор, не пересчитывается задним числом.

Тот же блок после запуска: пометка «На момент запуска» и замороженный список совпадений

Сами этапы подавления — на запуске и во время кампании — считаются в блоке «Состояние планировщика» на карточке кампании, рядом со строкой «Исключено политикой».

Состояние планировщика: контакты по состояниям, удержания и этапы подавления DNC

Кабинет и Web API выполняют эту проверку одним и тем же кодом, поэтому результат и его след одинаковы независимо от того, откуда запущена кампания. Роль Member видит экраны кампаний и проверки в режиме чтения.