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

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

Откроется страница **Суфлёры**. Раздел доступен, если в аккаунте включена тарифная опция **Суфлёры** (`prompters`) и у сотрудника есть права на работу с суфлёрами. Как включить опцию, см. в статье [Суфлёры](https://webim.ru/kb/prompters/). Пошаговое создание суфлёра и привязка к отделу — в статье [Добавление суфлёра](https://webim.ru/kb/prompters/add-new-prompter.html).

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

  * селектор **«Суфлёр по умолчанию»** с кнопкой **Применить**

  * вкладки **Активные суфлёры** и **Отключённые суфлёры**

  * таблица со столбцами **№**, **Имя**, **Тип**, **Действие**

  * действия для каждой строки: **редактировать**, **отключить/включить**, **удалить**

  * кнопка **Создать нового суфлёра**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### Удалить

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

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

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

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

Поля формы:

  * **Имя** — внутреннее название. Задаётся для языков интерфейса агента; длина не больше 64 символов.

  * **Тип** — **AutoFAQ** или **L2U**. Протоколы описаны в статьях [AutoFAQ](https://webim.ru/kb/prompters/autofaq.html) и [L2U](https://webim.ru/kb/prompters/l2u.html).

  * **URL** — полный адрес бэкенда суфлёра (`api_url`), схема `http` или `https`. Пример: `https://prompter.example.local/api`.

  * **Токен** — секрет для заголовка `Authorization: Bearer {api_token}`.

  * **Количество подсказок** — сколько вариантов из ответа внешнего API показать оператору. В интерфейсе укажите число не меньше 1.

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

---

Источник: https://webim.ru/kb/prompters/prompters-interface.html