Выбор элемента посетителем

Что происходит для посетителя

Посетитель может выбрать кнопку, поле, карточку или другой элемент вашего сайта через виджет и отправить вопрос именно об этом элементе. Его название и разметка передаются вместе с вопросом, поэтому ИИ-помощник может объяснить назначение элемента, найти связанную инструкцию, подсветить его, прокрутить к нему или выполнить разрешённое действие.

Включите выбор элементов

5. В настройках канала включите «Выбор элемента страницы» и сохраните изменения. Другой способ — передать features: { element_selection: true } в init на сайте. Явное значение из init имеет приоритет. Изменение применяется при следующей инициализации виджета.

Как посетитель выбирает элемент

1. Посетитель открывает меню «Контекст» в поле ввода виджета и нажимает «Выбор».
2. На странице включается режим выбора: под курсором подсвечивается доступный элемент.
3. Посетитель нажимает на нужный элемент. Обычное действие элемента в этот момент не выполняется.
4. В меню «Контекст» появляется выбранный элемент. Через значок информации можно проверить его данные, через крестик — убрать его до отправки вопроса.
5. После успешной отправки выбранный элемент прикладывается только к этому сообщению и очищается. При ошибке он остаётся в черновике для повторной попытки.

Клавиша Escape отменяет режим выбора. Контекст текущей страницы сайт передаёт отдельно через Public API виджета; выбранный элемент его не заменяет.

Проверьте передаваемые данные

Контекст выбранного элемента содержит только сведения, которые виджет извлёк из страницы:

• URL и заголовок страницы;
• видимый текст или data-ai-label;
• область и раздел страницы;
• тип элемента, роль HTML и описанный смысл действия;
• стабильный data-ai-context-id;
• поисковая подсказка data-ai-kb-query;
• тип и ID бизнес-сущности для повторяющихся карточек или строк.

Для повторяющихся элементов задавайте data-ai-entity-type и data-ai-entity-id парой. Тогда агент отличит конкретный товар, заказ или строку списка. Если несколько элементов имеют одинаковый контекстный ключ и различить их нельзя, автоматическое действие не выполняется.

Технически сведения распределены по element (название, роль, тег, тип, действие и видимый текст), place (URL, заголовок, область и раздел), ref (контекстный ключ, ссылка на документ, поисковая фраза и сущность) и state (признаки disabled, selected и invalid). Скрипт-загрузчик не читает JavaScript-свойство value у поля и не передаёт введённый пароль. При этом видимый текст и значения data-ai-*, aria-*, title и placeholder, использованные для описания элемента, могут попасть в контекст — не помещайте в них секретные данные.

Контекст страницы и бизнес-сущности передаётся отдельно. Выбор кнопки сам по себе не добавляет в контекст выбранного элемента ID лида, заказа или проекта. Системные данные лида при этом могут быть доступны агенту из профиля; данные сайта добавляйте через контекст виджета или разметку конкретной сущности.

Подготовьте сайт

Используйте примеры разметки для устойчивых целей и скрытых меню, затем свяжите элементы с документацией. Если посетитель просит не объяснение, а действие, проверьте разрешённые действия и их результаты.