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

Реестр совместимости

Реестр совместимости — список скриптов одной учётной записи адаптера. Каждый скрипт говорит:

Как реестр связан с запросом

Клиент V2 шлёт в адаптер запрос вида:
  • Верхний type — операция: create, delete, delete_phone_number, details.
  • data[].type — имя скрипта. По нему адаптер находит строку реестра у этой учётной записи, и только у неё. Сравнение с учётом регистра и ровно по символам.
  • Общие поля строки для системы MX обязательны всегда и идут первыми: phone_number (11–13 цифр), type, gender_voice (male/female), language (en/ru/es). Дальше идут поля схемы скрипта в порядке реестра.
  • Строка с незнакомым скриптом, со скриптом без агента, с архивным или неопубликованным агентом получает ошибку {"line":"1", "fields":["type"]}, и весь запрос отклоняется до любой записи.
Одна кампания создаётся на набор признаков «учётная запись, скрипт, cname, час и минута старта, день, попытки». Повторные запросы с теми же признаками в тот же день добавляют строки в ту же кампанию партиями.

Вкладка «Реестры совместимости»

Вкладка «Реестры совместимости»
  1. Выбор учётной записи: «логин · система · организация».
  2. Статус учётной записи.
  3. «Добавить скрипт». У архивной организации кнопка выключена.
  4. Сводка: число скриптов и дефолты обзвона учётной записи.
  5. Агент V4 со статусом: версия, «скрыт», «в архиве», «не опубликован», «нет агента».
  6. Привязка набора: «Авто по агенту» или «транк · сабгруппа · номер».
  7. Карандаш — изменить, корзина — удалить с подтверждением.
В списке скриптов выбранной учётной записи видны скрипт, агент V4, классификация, привязка набора, число полей и правила повторов. Если учётных записей ещё нет, вкладка показывает «Сначала заведите учётную запись». Если у записи нет скриптов — подсказку «Имя нового скрипта пишется ровно как в поле data[].type запроса клиента» и кнопку «Добавить скрипт».
Статус агента в столбце: блокер или нет?
  • «скрыт» — нормально: скрытие управляет видимостью агента в кабинете, а не отключает его.
  • «в архиве», «не опубликован», «нет агента» — запросы клиента с этим скриптом получают ошибку по полю type. Направьте скрипт на действующего опубликованного агента.
Пока учётная запись активна, её скрипты защищают своих агентов от архивации и удаления.

Вкладка «Скрипт и агент»

Кнопка «Добавить скрипт» открывает окно «Новый скрипт реестра» с четырьмя вкладками: «Скрипт и агент», «Поля и переменные», «Правила повторов», «Маршрутизация». Внизу окна всегда видны сводка, текст отказа и кнопки. Новый скрипт реестра, вкладка «Скрипт и агент»
  1. Имя скрипта — ровно как в data[].type, регистр важен.
  2. Агент V4 — только опубликованные агенты организации учётной записи.
  3. Классификация — цель обзвона, обязательна.
  4. Порог короткого разговора для отчёта V2; пусто — 15 секунд.
  5. Привязка набора: «Авто по агенту» или «Явная».
  6. Сводка: что получит агент, правила, привязка.
  7. «Добавить скрипт» выключена, пока что-то не заполнено; подсказка называет, что именно.
1

Имя скрипта

Ровно как в поле data[].type запроса. Регистр важен: Soft_Script и soft_script — разные скрипты. До 100 символов. Пробелы по краям сохраняются как есть, и кабинет об этом предупредит: тогда запросы клиента обязаны приходить с теми же пробелами. Имя уникально внутри учётной записи.
2

Агент V4

Список открывается поверх окна. Сверху группа «Похоже на имя скрипта» — до пяти агентов, подобранных по имени, ниже — «Все агенты организации». Подходят только опубликованные агенты организации учётной записи; скрытые тоже подходят. После выбора под полем появится: «Опубликованная версия vN. Карта переменных сверяется с ней; новая публикация агента скрипт не перепроверит».
3

Классификация

Маркетинг, Обслуживание или Взыскание задолженности. Обязательна: от неё зависит тир согласия, под которым подписывается аттестация запуска кампании.
4

Порог короткого разговора в отчёте, с

От 1 до 300; пусто — 15, как в V2. Разговор короче порога выгрузка details считает «hung up». На набор не влияет.
5

Привязка набора

См. следующий раздел. Обычно достаточно «Авто по агенту», если у агента ровно одна сабгруппа в организации.
Выбор агента Список агентов открывается поверх окна: сверху «Похоже на имя скрипта», ниже все агенты организации. Строка списка — «имя · vN · скрыт».

Привязка набора

Привязка определяет, через какой SIP-транк, какую сабгруппу и с какого номера идут звонки по кампаниям этого скрипта. Про транки и сабгруппы — Телефония.
  • «Авто по агенту» — берётся единственная сабгруппа агента в организации. Кабинет сразу показывает, что получится:
    • «Ядро возьмёт единственную сабгруппу агента — …» — всё в порядке;
    • «У агента нет сабгрупп в организации учётной записи: ядро не сможет запустить кампанию»;
    • «Агент привязан к N сабгруппам … Задайте привязку явно».
  • «Явная» — три поля: SIP-транк, Сабгруппа (только те, к которым привязан агент) и Исходящий номер («По политике сабгруппы» или конкретный номер из её пула). Смена транка сбрасывает сабгруппу и номер.
Явная привязка набора
  1. Переключатель «Авто по агенту» / «Явная».
  2. SIP-транк организации.
  3. Сабгруппа — только привязанные к агенту.
  4. Исходящий номер из пула сабгруппы или по её политике.
  5. Сводка показывает вид привязки: «авто, однозначна», «авто, неоднозначна», «авто, сабгрупп нет», «явная, …».
Неоднозначная привязка — самый частый отказ при первом запросе. Если у агента несколько сабгрупп, а привязка «Авто по агенту», скрипт сохранится, но первый же create клиента получит «Internal error, try again later»: кампания создастся и тут же отменится. Смотрите на сводку внизу окна: «привязка: авто, неоднозначна» означает, что привязку надо задать явно.