Подготовка виджета к интеграции

Сначала подключите обычный виджет и убедитесь, что он открывается на сайте. Агент для этого не обязателен: без агента посетитель сможет написать в проект, а сотрудники — продолжить диалог в кабинете. Подключайте агента только тогда, когда посетителям нужны автоматические AI-ответы.

1. Подключите обычный виджет

Создайте канал «Виджет». В форме создания укажите домен сайта, на котором будет работать чат.
Если канал уже создан, проверьте разрешённые домены. Непустой список ограничивает внешние сайты; пустой разрешает любые домены. Лендинги этого проекта на доменах Senler разрешены автоматически.
Настройте внешний вид и сохраните канал.
Откройте раздел «Код для встраивания», скопируйте весь готовый фрагмент кнопкой рядом с кодом.
Вставьте этот фрагмент на сайт перед закрывающим тегом </body>.

Готовый фрагмент уже содержит адрес скрипта-загрузчика и channel_id нужного канала. При обычном подключении искать или заменять эти значения вручную не нужно.

2. Решите, должен ли отвечать агент

Сам виджет — это канал общения с посетителем. Он не запускает агента автоматически только потому, что установлен на сайте.

Если автоматические ответы не нужны

Дополнительная настройка не требуется. Откройте сайт, убедитесь, что виджет появляется и открывается, затем отправьте сообщение и проверьте, что диалог появился в кабинете.

Если нужны автоматические AI-ответы

Создайте агента или откройте существующего.
В настройках автозапуска для условия «Входящее сообщение» выберите «На все сообщения» либо «По ключевым словам». Во втором случае добавьте фразы, на которые должен реагировать агент.
В поле «Каналы» выберите созданный канал «Виджет». Если правило специально должно действовать во всех подходящих каналах проекта, ограничение по каналу можно не задавать.
На вкладке «Инструменты» включите «Готовить ответы и выполнять действия». Параметр «Не отправлять основной ответ клиенту» оставьте выключенным, чтобы посетитель получал готовые ответы. Предварительные сообщения ожидания включаются отдельно и не заменяют основной ответ.
Опубликуйте и активируйте агента.
Отправьте через виджет сообщение, которое соответствует выбранному режиму автозапуска, и проверьте ответ.

3. Проверьте базовое подключение

Перед добавлением контекста, разметки и действий убедитесь, что:

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

Когда базовый сценарий работает, переходите к статье «Как устроена интеграция», а затем добавляйте только нужные возможности.

Термины в примерах

Значение "xxx" в примерах означает channel_id из готового кода конкретного канала. Оно понадобится, только если разработчик самостоятельно собирает расширенную конфигурацию.

Внешняя страница, на которой установлен виджет, далее называется страницей сайта, а подключаемый ею файл widget-loader.js — скриптом-загрузчиком.