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

Учётные записи адаптера

Учётная запись адаптера — это логин и пароль, которыми клиент V2 входит в адаптер. Она привязана к организации V4 и хранит дефолты обзвона, которые подставляются в кампанию, когда запрос клиента не передал параметр.
Что нужно знать до начала
  • Логин и пароль учётной записи действуют только в адаптере. В кабинет и в Web API они не пускают, а токен кабинета и ключ Web API не открывают адаптер.
  • Пароль лежит в хранилище паролей адаптера и больше нигде не записан: сгенерированный пароль показывается один раз.
  • Организация учётной записи — источник агентов, шаблонов отчёта и привязок набора для всех её скриптов. Пока у учётной записи нет скриптов, организацию можно сменить, потом нельзя.

Кто видит раздел и где он

Раздел «Адаптер совместимости» находится в меню кабинета в группе «Администрирование», после пункта «Пакет рынка». Его видит только администратор корневой организации. У разработчика корневой организации и у пользователей клиентских организаций этого пункта нет. В разделе две вкладки: «Учётные записи» и «Реестры совместимости». Выбранная вкладка, учётная запись и фильтры сохраняются в адресе страницы, поэтому ссылку можно отправить коллеге. Вкладка «Учётные записи»
  1. Вкладки раздела: «Учётные записи» и «Реестры совместимости».
  2. «Завести учётную запись».
  3. Фильтры списка: система, организация, «Показать отключённые», «Сбросить фильтры».
  4. Статус: «Активна» или «Отключена с …».
  5. Действия строки: «Реестр», карандаш «Изменить», кнопка питания «Отключить» или «Активировать». Рядом — кнопка «Кампании».
В списке видны логин, система, организация, статус и кто завёл запись.
Плашка «Хранилище паролей адаптера недоступно». Если она висит над вкладками, на этом контуре хранилище паролей адаптера не настроено или не отвечает. Пока так, нельзя заводить учётные записи, менять пароль и логин, отключать и активировать. Остальные поля учётных записей и реестры работают. Кнопка «Проверить снова» перечитывает состояние; ответ может обновиться с задержкой до минуты. Если плашка не уходит, обратитесь к инженерам платформы.

Заведение учётной записи

Перед заведением узнайте у клиента его логин V2 ровно так, как он пишет его в запросах, и решите с бизнесом, оставляете ли прежний пароль V2 или выдаёте новый. Перенести прежний пароль из V2 автоматически нельзя — его надо ввести вручную.
1

Откройте раздел и нажмите «Завести учётную запись»

Кнопка в правом верхнем углу. Пока в разделе пусто, она стоит внутри пустой карточки списка.
2

Выберите систему

V2 · MX или V2 · KZ. От системы зависят общие поля запроса и уникальность логина: один и тот же логин может существовать и в MX, и в KZ. После сохранения система не меняется.
3

Введите логин

Ровно как в запросах клиента: это поле user в теле запроса. Регистр не важен — User_Freedom и user_freedom — один логин. Пробелы запрещены, длина до 150 символов.
4

Задайте пароль или нажмите «Сгенерировать»

Ручной пароль: не пустой, не из одних пробелов, до 255 символов; подходит любой прежний пароль клиента. Сгенерированный пароль покажется один раз после сохранения. Пока выбрана генерация, поле показывает «Сгенерируется при сохранении»; вернуться к ручному вводу можно ссылкой «Ввести вручную».
5

Выберите организацию V4

Дерево организаций с поиском. Из организации берутся агенты для скриптов, шаблоны отчёта и привязки набора. Архивную организацию выбрать нельзя.
6

Заполните блок «Для ядра адаптера»

  • Отображаемое имя — имя клиента в V2, до 255 символов. Справочное поле, агенту не передаётся.
  • Ответ на create — форма ответа клиенту: «Список идентификаторов» ({"type":"success","data":[100000001,…]}) или «Пары batch_id и foreign_id» ([{"batch_id":100000001,"foreign_id":"…"}]). Выбирайте ту, которую разбирает код клиента.
  • Шаблон выгрузки — шаблон отчёта организации, по которому строится ответ на details. Без шаблона details возвращает отказ. Для общей формы V2 есть системный шаблон sys-api-v2, для формы moneyman — sys-api-moneyman.
  • Номер из «не звонить» — что делать со строкой, номер которой есть в реестре «Не звонить» организации: «Пропускать номер, как в V2» (строка получает идентификатор, но контакт не создаётся) или «Отклонять весь запрос» (клиент получает ошибку по полю phone_number).
7

Проверьте дефолты обзвона

Они подставляются в кампанию, когда запрос не передал параметр:Окно обязано укладываться в окно обзвона организации, иначе сохранение отклонится.
8

Нажмите «Завести»

Учётная запись создаётся вместе с паролем в хранилище. Если хранилище отказало, записи не будет, а причина появится внизу окна.
Окно «Новая учётная запись адаптера» Слева — вход и организация, справа — настройки для ядра адаптера и дефолты обзвона.
  1. Система: V2 · MX или V2 · KZ. После сохранения не меняется.
  2. Логин ровно как в запросах клиента, без пробелов, до 150 символов.
  3. Пароль вручную или «Сгенерировать»: сгенерированный покажется один раз.
  4. Организация V4: источник агентов, шаблонов и привязок.
  5. Отображаемое имя клиента в V2, справочно.
  6. Форма ответа на create: список идентификаторов или пары batch_id/foreign_id.
  7. Шаблон выгрузки для операции details.
  8. Что делать с номером из реестра «Не звонить».
  9. Дефолты обзвона: попытки, скорость, интервал.
  10. Окно обзвона: часы, которые может прислать запрос.
  11. Повторная загрузка: проверка номеров, загруженных сегодня.
  12. «Завести».

Что проверить сразу после заведения

  • Передайте клиенту логин, пароль и адрес адаптера. Самый дешёвый способ проверить вход — запрос {"user":"…","pass":"…","type":"delete","data":[1]}: адаптер отвечает эхом {"type":"deleted", "data": [1]} и ничего не снимает.
  • Заведите реестр: без скриптов любой create клиента получит ошибку по полю type. Кнопка «Открыть реестр» есть прямо в окне с показанным паролем.

Пароль: показ один раз и смена

Если пароль генерировался, после «Завести» откроется окно «Учётная запись заведена» с паролем и кнопкой «Копировать». Скопируйте пароль сразу: он показывается один раз и больше нигде не хранится. Потеряли — задайте новый в окне изменения учётной записи. Поле пароля после выбора генерации
  1. После «Сгенерировать» поле показывает «Сгенерируется при сохранении». Ссылка «Ввести вручную» возвращает ручной ввод.
Смена пароля — из окна изменения: кнопка «Задать новый пароль» рядом с пометкой «задан». Откроется небольшое окно «Новый пароль для <логин>» с тем же полем пароля и кнопкой «Сгенерировать»; «Сохранить пароль» применяет его. Окно нового пароля
Прежний пароль перестаёт работать в течение минуты. После смены пароля прежний может приниматься ещё до минуты — так устроено хранилище паролей. Через минуту работает только новый.

Изменение учётной записи

Карандаш в строке списка открывает окно «Учётная запись <логин>». В заголовке — система, внутренний номер записи и кто её завёл. Окно изменения учётной записи
  1. Система не меняется.
  2. Логин можно сменить.
  3. Пароль: «задан» и кнопка «Задать новый пароль».
  4. Организация заблокирована, пока у учётной записи есть скрипты.
  5. Отображаемое имя, ответ на create, шаблон выгрузки, режим «не звонить» меняются в любой момент.
  6. Окно обзвона с подсказкой «окно организации …»: шире него задать нельзя.
  7. «Отключить учётную запись».
  8. «Сохранить».

Отключение и активация

Кнопка питания в строке списка или кнопка «Отключить учётную запись» в окне изменения открывает подтверждение. Удалить учётную запись нельзя: отключение — единственный способ закрыть клиенту вход. Подтверждение отключения
  • Отключение. Клиент сразу получает на любой запрос {"type":"error", "data":"Authentication failed"}. Скрипты реестра остаются, но перестают защищать своих агентов от архивации и удаления.
  • Активация. Вход возвращается в течение минуты. Скрипты снова защищают своих агентов.
  • Отключённая запись видна в списке, если включён фильтр «Показать отключённые»: строка затемнена, в статусе «Отключена с …». На вкладке реестров у неё висит плашка «Учётная запись отключена».

Отказы при сохранении

Ошибки проверки в самом окне только подсвечивают поле. Отказы сервера показываются текстом внизу окна.