Интерфейс для настройки суфлёров

Путь в меню Панели управления: Ассистенты → Суфлёры.

Откроется страница Суфлёры. Раздел доступен, если в аккаунте включена тарифная опция Суфлёры (prompters) и у сотрудника есть права на работу с суфлёрами. Как включить опцию, см. в статье Суфлёры. Пошаговое создание суфлёра и привязка к отделу — в статье Добавление суфлёра.

На странице доступны:

селектор «Суфлёр по умолчанию» с кнопкой Применить
вкладки Активные суфлёры и Отключённые суфлёры
таблица со столбцами №, Имя, Тип, Действие
действия для каждой строки: редактировать, отключить/включить, удалить
кнопка Создать нового суфлёра

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

Суфлёр по умолчанию

В селекторе перечислены только активные (не отключённые) суфлёры. Пункт Не выбрано означает, что суфлёр аккаунта по умолчанию не задан.

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

Идентификатор суфлёра записывается в чат при его создании и при смене отдела посетителя.

Если выбранного суфлёра нет в списке (например, все суфлёры отключены), селектор показывает, что суфлёры не найдены.

Список суфлёров

Вкладка Активные суфлёры показывает не отключённых суфлёров, вкладка Отключённые суфлёры — отключённых.

В столбце Тип отображается название: AutoFAQ (внутренний тип operator_hints) или L2U (внутренний тип dialog_composer).

Редактировать

Открывается страница с именем суфлёра в заголовке и подзаголовком Редактировать суфлёра. Кнопка сохранения — Сохранить изменения.

На форме те же поля, что при создании (см. ниже). Поля URL и Токен заблокированы: у уже созданного суфлёра их изменить нельзя. Чтобы задать другой адрес или токен, создайте нового суфлёра.

Поле Количество подсказок на форме редактирования видно, но сервер при сохранении применяет только имя, тип и признак отключения. Лимит подсказок задаётся при создании.

На форме редактирования токен показывается частично скрытым: видна примерно первая треть символов, остальное заменено звёздочками. Полностью он виден только после сохранения, пока страница не обновлена.

Отключить и включить

Действие запрашивает подтверждение. Отключённый суфлёр переносится на вкладку Отключённые суфлёры, пропадает из селектора Суфлёр по умолчанию и из поля Суфлёр в настройках отдела.

Если отключаемый суфлёр был суфлёром по умолчанию для аккаунта или для отдела, эта привязка сбрасывается.

Включение возвращает суфлёра в список активных; привязку по умолчанию при необходимости задайте снова.

Удалить

Действие запрашивает подтверждение. Запись исчезает из списка. Как и при отключении, если этот суфлёр был выбран по умолчанию в аккаунте или в отделе, привязка сбрасывается.

Создание, изменение и удаление суфлёров фиксируются в Истории действий.

Создание суфлёра

Кнопка Создать нового суфлёра открывает страницу Новый суфлёр. Кнопка сохранения на форме — Новый суфлёр. После успешного создания открывается тот же суфлёр в режиме редактирования.

Поля формы:

Имя — внутреннее название. Задаётся для языков интерфейса агента; длина не больше 64 символов.
Тип — AutoFAQ или L2U. Протоколы описаны в статьях AutoFAQ и L2U.
URL — полный адрес бэкенда суфлёра (api_url), схема http или https. Пример: https://prompter.example.local/api.
Токен — секрет для заголовка Authorization: Bearer {api_token}.
Количество подсказок — сколько вариантов из ответа внешнего API показать оператору. В интерфейсе укажите число не меньше 1.

Все поля обязательны. После создания URL и Токен больше не меняются в интерфейсе.