Виджет на сайте

В этом разделе собраны инструкции для разработчика, который подключает виджет Senler AI к сайту. Они помогут передать агенту контекст открытой страницы, связать элементы интерфейса с документацией и добавить действия, которые выполняет сам сайт.

Если вам нужен только обычный чат, начните с инструкции «Подключение виджета». В ней со скриншотами показаны создание канала, настройка внешнего вида и получение готового кода. Страница «Интерфейс виджета» показывает чат со стороны посетителя. Дополнительная разметка и JavaScript API для такого подключения не обязательны.

Приветствие и начало общения

В новом чате можно сразу показать сообщение из автоматизации с текстом, кнопками и вложениями, ещё до первого ответа посетителя. Сам показ не запускает автоматизацию и не создаёт запись диалога.

Выберите сообщение в настройках канала, чтобы задать общее приветствие и разрешить дополнительные варианты из той же или других автоматизаций.
Настройте выбор по условиям сайта, чтобы показывать разные сообщения посетителю без диалогов и тому, кто уже общался, либо учитывать открытую страницу и данные вашего сайта.
Продолжите общение сообщениями автоматизации, если нужно отправлять сообщения и после первого ответа. Это отдельный сценарий от переключения приветствия.

Подготовка

Подготовка виджета — как проверить базовое подключение и, если нужны автоматические AI-ответы, привязать к каналу опубликованного и активного агента.
Как устроена интеграция — чем отличаются контекст, разметка и действия, какие данные используются при подготовке ответа и где проходит граница ответственности сайта.
Параметры инициализации — размещение виджета, источник настроек, данные посетителя и доступные функции чата.

Контекст и элементы сайта

Контекст страницы — как сообщить агенту, какой раздел, заказ или товар сейчас открыт. Данные для одного вопроса передаются через контекст сообщения.
Разметка элементов сайта — как дать важным кнопкам, полям и карточкам стабильные ключи data-ai-*.
Связь Markdown-документации с сайтом — как связать ключ элемента с понятной фразой в инструкции.
Выбор элемента — как посетитель прикладывает кнопку, поле или карточку к своему вопросу.
Действия агента на сайте — как виджет подсвечивает элементы, прокручивает страницу и выполняет разрешённые действия.

Расширенные возможности

Custom actions — действия сайта через кнопки или вызовы агента с возвратом результата.
Inline-правки — сценарий изменения выбранного текста с предварительным просмотром результата.
Public API — методы управления виджетом. Готовность, ошибки и обратные вызовы описаны в событиях виджета.
Авторизация пользователя сайта в MCP — серверные запросы для передачи, обновления и отзыва пользовательского токена и его привязка к лиду виджета.

Настройка с помощью ИИ

Подключите Senler.io MCP к вашей среде разработки. AI сможет найти документацию, прочитать полные инструкции и помочь изменить код интеграции. Для одного проекта подходит Project MCP; для работы от имени пользователя с доступными проектами — User MCP. В инструкции приведены точные адреса серверов и порядок подключения.

Например, задайте задачу так: «Подключи виджет на сайт. До первого обращения показывай сообщение для знакомства, а посетителю, у которого уже есть диалоги, другое. Сначала прочитай документацию и уточни, какие автоматизации и шаги использовать».