Настройки встраивания

Настройки встраивания позволяют встроить бота на внешние сайты через JavaScript виджет и настроить, как бот отображается и работает на внешних ресурсах.

Настройки находятся в разделе "Настройки встраивания" при создании или редактировании бота.

По умолчанию встраивание бота на внешние сайты отключено для безопасности. Чтобы разрешить встраивание:

1. Раскройте раздел "Настройки встраивания"
2. Включите переключатель "Разрешить встраивание на внешние сайты"
3. Настройте разрешенные домены (см. ниже)
4. Сохраните изменения

После включения вы получите код для встраивания, который можно добавить на ваш сайт.

Эта настройка определяет, будут ли отображаться источники и цитаты в ответах бота на внешних сайтах.

• Включено — агент будет показывать источники и цитаты в ответах, что повышает прозрачность и доверие
• Отключено — источники будут скрыты, ответы выглядят более чисто, но без ссылок на источники

Рекомендуется включать показ источников для:

• Образовательных агентов
• Агентов с документацией
• Агентов, где важна проверяемость информации

Можно отключить для:

• Развлекательных агентов
• Агентов с простыми ответами
• Когда источники не важны для пользователя

Приветственное сообщение — это сообщение, которое бот отправит при первом открытии чата на внешнем сайте.

Настройка приветственного сообщения:

1. В разделе "Настройки встраивания" найдите поле "Приветственное сообщение"
2. Введите текст сообщения (например, "Привет! Я помогу вам найти информацию. Задайте вопрос!")
3. Оставьте пустым для использования стандартного сообщения
4. Сохраните изменения

Рекомендации:

• Сделайте сообщение дружелюбным и понятным
• Укажите, чем может помочь бот
• Пригласите пользователя задать вопрос
• Используйте короткие формулировки

Примеры хороших приветственных сообщений:

• "Привет! Я помогу вам найти информацию в нашей базе знаний. Задайте вопрос!"
• "Здравствуйте! Я консультант по нашим продуктам. Чем могу помочь?"
• "Добро пожаловать! Задайте вопрос, и я найду ответ в документации."

Разрешенные домены ограничивают, на каких сайтах можно встроить бота. Это важная настройка безопасности.

Чтобы добавить разрешенный домен:

1. В разделе "Настройки встраивания" найдите раздел "Разрешенные домены"
2. Введите домен (например, example.com или www.example.com)
3. Нажмите "Добавить"
4. Сохраните изменения

Важно:

• Указывайте только домены, которым доверяете
• Не указывайте домены третьих сторон без разрешения
• Проверяйте правильность написания доменов
• Для поддоменов указывайте конкретный поддомен (например, blog.example.com)

Если список разрешенных доменов пуст, бот можно встроить на любой сайт (не рекомендуется). Если список не пуст, бот можно встроить только на указанные домены.

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

Код выглядит следующим образом:

<script src="https://your-domain.com/embed/agents/YOUR_BOT_UUID/widget"></script>

Чтобы встроить бота на сайт:

1. Скопируйте код для встраивания из настроек бота
2. Добавьте код на ваш сайт (обычно в конец страницы перед закрывающим тегом </body>)
3. Убедитесь, что домен сайта добавлен в список разрешенных доменов
4. Сохраните изменения на сайте

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

Виджет автоматически адаптируется под дизайн сайта и поддерживает различные размеры экранов.