Виджет на сайте
В этом разделе собраны инструкции для разработчика, который подключает виджет Senler AI к сайту. Они помогут передать агенту контекст открытой страницы, связать элементы интерфейса с документацией и добавить действия, которые выполняет сам сайт.
Если вам нужен только обычный чат, начните с инструкции «Подключение виджета». В ней со скриншотами показаны создание канала, настройка внешнего вида и получение готового кода. Страница «Интерфейс виджета» показывает чат со стороны посетителя. Дополнительная разметка и JavaScript API для такого подключения не обязательны.
Подготовка
- Подготовка виджета — как проверить базовое подключение и, если нужны автоматические AI-ответы, привязать к каналу опубликованного и активного агента.
- Как устроена интеграция — чем отличаются контекст, разметка и действия, какие данные используются при подготовке ответа и где проходит граница ответственности сайта.
- Параметры инициализации — размещение виджета, источник настроек, данные посетителя и доступные функции чата.
Контекст и элементы сайта
- Контекст страницы и сообщения — как сообщить агенту, какой раздел, заказ, товар или другой объект сейчас открыт.
- Разметка элементов сайта — как дать важным кнопкам, полям и карточкам стабильные ключи
data-ai-*. - Связь Markdown-документации с сайтом — как связать ключ элемента с понятной фразой в инструкции.
- Выбор элемента и действия — как посетитель выбирает элемент и как виджет подсвечивает его, прокручивает страницу или изменяет поле.
Расширенные возможности
- Custom actions — кнопки в ответах, обработчики которых реализует сайт.
- Inline-правки — сценарий изменения выбранного текста с предварительным просмотром результата.
- Public API и события — методы управления виджетом и события для связи с интерфейсом сайта.
Рекомендуемый порядок
Сначала подключите обычный виджет и пройдите подготовку. Затем разберите общую схему интеграции и настройте только необходимые возможности: параметры инициализации, контекст, разметку и связанные с ней инструкции. К действиям, inline-правкам и Public API переходите, когда простой сценарий уже работает.