Связанные сценарии

Сценарии можно связать в группу. Сессия, начатая с одним из них, сама выбирает сценарий группы по первому документу пользователя и дальше идёт по его шагам и проверкам. Например, один сценарий — для внутреннего паспорта с проверками по базам, другой — для заграничных паспортов и ID-карт: в интеграцию передаётся идентификатор одного из них, а пользователь проходит проверку по сценарию своего документа. Сценарий, с которым начата сессия (через API, Web SDK или KYC-ссылку), называется сценарием входа; сценарий, который выбрал документ, — выбранным.

Как связать

  1. В таблице активных сценариев щёлкните строку сценария — она выделится рамкой. Двойной щелчок по строке открывает редактор сценария.
  2. Щёлкните значок цепи слева от названия другого сценария — сценарий добавится в группу выделенного. Если выделенный сценарий ещё ни с кем не связан, два сценария образуют новую группу; сценарий из другой группы переходит в группу выделенного.
  3. Чтобы отвязать сценарий, выделите любой сценарий группы и щёлкните подсвеченную цепь сценария, который нужно отвязать. Отвязать можно всегда, без проверок; группа, в которой остался один сценарий, распадается.

Сценарий может состоять только в одной группе. Деактивированный сценарий выходит из своей группы.

Какие сценарии можно связать

  • В первом шаге — только лицевые стороны паспортов (любых, кроме паспорта транспортного средства) и удостоверений личности (ID-карт). Сценарий, в первом шаге которого есть другой документ, оборотная сторона, селфи или liveness, связать нельзя. Сценарий с анкетой тоже связать нельзя.
  • Первые шаги сценариев группы не пересекаются — в них нет общего типа документа с общей страной. «Паспорт» пересекается также со «Страницей паспорта» и «Служебным паспортом»; «Внутренний паспорт» и «Паспорт» — разные типы. Например, «Паспорт — Казахстан» в первых шагах двух сценариев — пересечение, а «Внутренний паспорт — Россия» в одном сценарии и «Паспорт — Россия» в другом — нет.
  • Настройки «Игнорировать ошибки распознавания текста» и «Проверять соответствие серии и номера на разных разворотах документа» (вкладка «Основные настройки») одинаковы у всех сценариев группы.

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

Значки цепи

Цепь стоит слева от названия каждого активного сценария. Пока ни один сценарий не выделен, все цепи неактивны.

  • Подсвечена — сценарий состоит в группе выделенного (у самого выделенного — если он в группе). Щелчок отвязывает сценарий, подсказка «Отвязать сценарий».
  • Погашена — сценарий можно добавить в группу выделенного. Щелчок связывает сценарий, подсказка «Связать сценарий».
  • Тёмно-красная — сценарий нельзя связать. Не нажимается, подсказка «Сценарий не может быть связан».
  • Неактивная (бледная) — связь сейчас невозможна: ни один сценарий не выделен, выделен сценарий, который нельзя связать, или это сам выделенный сценарий вне группы. Не нажимается.

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

Сообщения при связывании

Если связь нарушила бы правила, личный кабинет её не создаёт и до смены выделения показывает красный текст в строке сценария, по цепи которого щёлкнули:

  • «Сценарии пересекаются по типу первого документа: <сценарии> (<документ — страна>)», например «Сценарии пересекаются по типу первого документа: Зарубежные паспорта, Паспорта СНГ (Паспорт — Казахстан)»;
  • «У связанных сценариев должны совпадать настройки распознавания: <сценарии>».

Правка сценария из группы

Сценарий из группы сохраняется, только если после правки его по-прежнему можно связать, его первый шаг не пересекается с первыми шагами других сценариев группы, а настройки распознавания совпадают с ними. Это проверяется и тогда, когда правка меняет только шаги или только настройки. Иначе кнопка «Сохранить» неактивна, а в списке «Сценарий нельзя сохранить:» у кнопки перечислены причины; щелчок по причине открывает вкладку, где её исправляют:

  • «Связанный сценарий: в первом шаге только паспорт или ID-карта; чтобы изменить шаг, отвяжите сценарий»;
  • «Пересекается с <сценарий> (<документ — страна>)»;
  • «У связанных сценариев должны совпадать настройки распознавания: <сценарии>».

В выборе стран первого шага не предлагаются страны, которые дали бы пересечение с первым шагом другого сценария группы; уже отмеченные страны остаются. Если скрыты все страны, в поле выбора стран видна подсказка «Страны заняты сценариями группы: <сценарии>».

Если сценарии или связи в это время меняет другой сотрудник, личный кабинет перепроверяет правила на свежих данных и показывает причину в строке сценария или у кнопки «Сохранить»; связь или правка в этом случае не сохраняется.

Чьи настройки действуют в сессии

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

Сессии связанных сценариев в личном кабинете

  • Пока сценарий не выбран, первый шаг сессии принимает документы первых шагов всех сценариев группы. Документ, не подошедший ни одному из них, отклоняется, и пользователь переснимает его. Сценарий выбирает только лицевая сторона документа; выбор окончательный.
  • В KYC Логах, KYC Отчётах, фильтре по сценарию и статистике сессия относится к выбранному сценарию, до выбора — к сценарию входа.
  • В карточке сессии видны «Сценарий входа» и «Выбранный сценарий» (до выбора — «не выбран»).
  • Карточка клиента, добавление лица в чёрный список и переход к сценарию из карточки сессии относятся к выбранному сценарию, до выбора — к сценарию входа; виджет из карточки открывается по сценарию входа.
  • Пока сценарий не выбран, сессия не получает успешный статус (success), кроме ручной смены статуса; смена статуса сценарий не выбирает.
  • Сценарии сессии фиксируются при её создании: связи, изменённые позже, начатые сессии не меняют, а деактивированный сценарий группы сессия пропускает. Сессия, начатая до связывания её сценария, идёт как обычная.
  • В выгрузке CSV последняя колонка — selectedSchemaId: выбранный сценарий; у обычных сессий и до выбора она пустая.

Как сессия связанных сценариев выглядит в API — раздел «Сессия связанных сценариев» в методе «Создать новую KYC-сессию».

Что дальше