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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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