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

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

Загрузка контактов

Файл контактов загружается в блоке «Загрузка контактов» — на шаге «Контакты» при создании кампании и в карточке кампании в статусе «Черновик». Заменить файл можно тоже только в черновике:
  • каждая новая загрузка заменяет контакты предыдущей — кабинет просит подтвердить замену; история загрузок сохраняется;
  • после замены заново нужны решение по совпадениям с реестром «не звонить» (раздел «Проверка по реестру «не звонить»» ниже) и подпись аттестации — подпись под прежней версией файла не действует.
В идущую кампанию номера добавляются только партиями — блоком «Добавить партию звонков», см. «Долить звонки в идущую кампанию».
Скачайте образец файла кнопкой «Скачать образец файла». Образец собирается из опубликованной версии агента кампании — в нём уже стоят колонки, которые агент использует в промптах. Без выбранного агента кнопка недоступна: «Выберите агента — образец строится из его переменных». Это самый быстрый способ не получить пустые переменные в разговоре.
Блоки «Загрузка контактов» и «Результаты импорта»

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

Формат и лимиты

  • Принимаются CSV и XLSX. Устаревший XLS не поддерживается — пересохраните файл.
  • CSV: кодировка UTF-8 (с BOM или без) либо Windows-1251; разделитель ,, ; или табуляция определяется автоматически.
  • XLSX: читается только первый лист.
  • Первая строка — заголовки, данные начинаются со второй.
  • Лимиты: до 50 000 строк и до 10 МБ; файл сверх лимита отклоняется целиком, а не обрезается.

Номер телефона

Номер телефона — единственная колонка, обязательная на любом рынке. Для профиля рынка США (us_tcpa) обязательна ещё колонка contact_zip или contact_state — см. «Кампании в США».
  • Платформа находит колонку по заголовку: phone, contact_phone, phone_number, mobile, cell, tel, telephone, msisdn, телефон, номер, номер_телефона и похожим.
  • Если узнаваемого заголовка нет, колонка определяется по содержимому: берётся та, где не меньше 80% значений похожи на номера. Если такой нет — файл отклоняется.
  • Номер читается, если в нём не меньше 10 цифр. Строка с нечитаемым номером не отбрасывается молча: она попадает в отчёт импорта с номером строки.
  • Номера сравниваются по последним 10 цифрам: +7 701 123 45 67 и 8 701 123 45 67 — один и тот же номер.

Имя

Имя контакта берётся из колонки name, full_name или фио, а если их нет — собирается из пары колонок: contact_first_name + contact_last_name, first_name + last_name или имя + фамилия. Собранное имя доступно агенту как переменная {{name}}.

Часовой пояс

Колонка timezone (также tz, time_zone, contact_timezone, часовой_пояс) задаёт пояс контакта в формате IANA, например Asia/Almaty. Неизвестный пояс — предупреждение в отчёте, а не отказ строки: контакту звонят по часовому поясу кампании. Пустой пояс тоже означает пояс кампании.

Переменные

Любые другие колонки становятся переменными звонка: сумма задолженности, дата платежа и т. п.
  • Ключ переменной получается из заголовка: регистр не важен, пробелы и дефисы заменяются на _ — «Amount Due» становится amount_due.
  • Если два заголовка дают один ключ, побеждает первая колонка, а в отчёт попадает предупреждение «Коллизия имён колонок».
  • Колонки телефона, часового пояса, договора и роли переменными не становятся.
Переменные, отмеченные у агента флажком «В сигнатуре», сверяются с файлом при запуске: если колонки нет, запуск блокируется.

Группы договора

Чтобы связать несколько номеров с одним договором (заёмщик и третьи лица), добавьте две колонки:
  • contract_id (также contract, договор, номер_договора) — номер договора, до 64 символов;
  • role (также роль) — borrower (заёмщик) или third_party (третье лицо).
Строка отклоняется, если номер договора длиннее 64 символов, если договор указан, а роль пуста или неизвестна, или если роль указана без договора. Строки без договора и роли — обычные контакты вне группы. Участники одной группы набираются параллельно. После успешного разговора с заёмщиком ожидающие набора контакты того же договора во всех запущенных кампаниях организации исключаются с причиной «Согласие по группе договора». Успешным считается разговор с достигнутой целью, если у агента задан критерий успеха, а без него — любой состоявшийся разговор.

Кампании в США

Для профиля рынка us_tcpa в файле должна быть колонка contact_zip или contact_state. Строка, у которой локация не распознана или география не обзванивается, отклоняется построчно; расхождения ZIP, штата и города — предупреждения. Подробно — на странице «Кампании в США».

Повторяющиеся номера

Один человек может встретиться в файле несколько раз; что с этим делать, задаёт настройка «Дубли номеров»:
  • «Отклонять дубли (в отчёт)» (по умолчанию) — остаётся первое вхождение, остальные попадают в отчёт как ошибки. Обычно повторы означают, что выгрузка из вашей системы работает неправильно, и об этом лучше узнать.
  • «Оставить первое вхождение» — повторы отбрасываются и попадают в отчёт как предупреждения.
  • «Оставить последнее вхождение» — остаётся последняя строка; подходит, если исправленные строки дописываются в конец файла.
Внутри одного файла номер попадает в кампанию не более одного раза. Партия, добавленная в идущую кампанию, с номером, который в кампании уже есть, принимается как новый контакт, и номер набирается снова.
Почему файл может быть отклонён целиком: колонка с номерами не найдена или не определяется однозначно; в файле нет строк данных или ни одной пригодной строки; превышен лимит 50 000 строк или 10 МБ; неподдерживаемый формат (включая XLS) или повреждённый файл; для профиля us_tcpa нет ни contact_zip, ни contact_state. Причина и совет, что исправить, показываются в блоке «Файл отклонён».
Блок загрузки контактов: лимиты файла и кнопка скачивания образца под конкретного агента

Результаты импорта

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

Отчёт импорта

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

История загрузок

Если загрузок больше одной, появляется блок «История загрузок»: файл, время загрузки, версия (запущенная помечена «запущенная»), число принятых строк или отметка «Отказ» и кнопка «Скачать исходный файл», если исходник хранится. Щелчок по строке открывает результаты этой загрузки.

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

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

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

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

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

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

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

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

Снятие контактов с обзвона

Снять контакты с обзвона по требованию клиента можно только через Web API: POST /v1/campaigns/{id}/contacts/withdraw — в одной кампании, по номерам или идентификаторам контактов; POST /v1/contacts/withdraw — во всех запущенных кампаниях организации, по номерам. Снятый контакт переходит в состояние «Исключён» с причиной «Снят по требованию клиента». Подробно — в разделе «Снятие контакта с обзвона».