Внедрите ИИ Chatbot на своем сайте
Встраивание на сайт
Это универсальный способ добавить чат-бота на любой сайт. Вы вставляете две короткие строки в HTML своего сайта: тег <script>, который загружает виджет, и элемент <web-chat-agent>, который указывает, какого чат-бота показывать. Вот и все, плавающая кнопка чата появится в углу каждой страницы, где работает этот код.
Если вы используете WordPress, TYPO3, Shopify, Wix, Squarespace или Webflow, воспользуйтесь специальным руководством для вашей платформы, там показано, куда именно нужно вставить этот же код.
Где найти ID чат-бота
Вам не нужно вводить ID вручную. В панели управления WebChatAgent:
- Откройте своего чат-бота.
- Перейдите в Каналы → Виджет чата и разверните Показать сведения об установке.
- Нажмите кнопку копирования в блоке с кодом.
Скопированный фрагмент уже содержит ваш ID чат-бота, поэтому просто вставьте его. (Если вам когда-либо понадобится сам ID в чистом виде, это длинная строка в URL вашей панели управления: /dashboard/<your-chatbot-id>.)
Код для вставки
Вставьте этот код непосредственно перед закрывающим тегом </body> вашего сайта:
<script src="https://webchatagent.com/widget/web-chat-agent.js" async></script>
<web-chat-agent chatbot-id="YOUR_ID"></web-chat-agent>
Замените YOUR_ID на ваш ID чат-бота (или, что проще, скопируйте готовый фрагмент из панели управления, где ID уже подставлен). Виджет загружается асинхронно, поэтому он не замедлит работу страницы, и появится в виде плавающей кнопки чата в нижнем углу.
Дополнительные атрибуты
Виджет берет цвета, заголовок, приветственное сообщение и поведение из настроек панели управления, поэтому обычно вам требуется только chatbot-id. Чтобы переопределить некоторые параметры прямо в HTML, добавьте эти атрибуты к элементу <web-chat-agent>:
chatbot-id, ваш ID чат-бота. Обязательно.theme, визуальный стиль:"default"или"modern". По умолчанию используется"default".initially-open, установите значение"true", чтобы чат открывался автоматически при загрузке страницы. По умолчанию используется"false"(закрыто).tracking-consent, необязательный сигнал согласия для постоянной персонализации:"unknown","denied"или"granted". Если параметр не указан, по умолчанию используется значение"unknown", а анонимные локальные триггеры продолжают работать.context-data, контекст сессии со страницы для ИИ (например,"Customer=Acme GmbH;OrderID=A-1023"), полезно при работе виджета внутри CRM или закрытой зоны сайта. Форматы, ограничения и примечания по безопасности описаны в руководстве для разработчиков.
<web-chat-agent
chatbot-id="YOUR_ID"
theme="modern"
initially-open="false"
></web-chat-agent>
Все остальное, включая фирменный цвет, аватар, шрифты, положение и поведение, настраивается в разделе Каналы → Виджет чата, поэтому вам не придется снова менять код для изменения стиля виджета. Роль ассистента настраивается в разделе Настройки → Стиль ответов и роль.
Согласие на использование файлов cookie и проактивные триггеры
Виджет не добавляет второй баннер cookie. Без сигнала согласия он работает в анонимном режиме конфиденциальности: триггеры времени, прокрутки, намерения уйти со страницы, бездействия, URL, видимости и быстрых кликов («rage-click») обрабатываются локально в памяти. Распознавание вернувшихся посетителей, постоянные счетчики, проактивная аналитика и сгенерированные ИИ приветствия ожидают сигнал granted.
Полную матрицу поведения, примеры для платформ CMP и описание хранилища см. в разделе Согласие на использование файлов cookie и анонимные проактивные триггеры.
Встраивание чата внутрь страницы
Фрагмент выше добавляет плавающую кнопку. Если вы хотите разместить чат внутри макета страницы, например как полноценную панель чата на отдельной странице поддержки, используйте встроенный виджет. Он загружает другой скрипт и другой элемент:
<script src="https://webchatagent.com/widget/chat-widget-inline.js" async></script>
<web-chat-agent-inline chatbot-id="YOUR_ID"></web-chat-agent-inline>
Встроенный чат отображается там, где вы разместите элемент, поэтому добавьте его в нужный контейнер. Подробности о разметке см. в руководстве по встроенному чату.
Работает везде
Оба фрагмента представляют собой обычный HTML и пользовательский элемент, поэтому они работают на любой платформе сайтов: WordPress, TYPO3, Shopify, Wix, Squarespace, Webflow, а также на сайтах с рукописным кодом HTML/JS. Вставьте код в HTML сайта и опубликуйте изменения.
Устранение неполадок
- Виджет не появляется? Убедитесь, что код добавлен в HTML страницы (перед
</body>), и что вы опубликовали изменения или очистили кэш плагинов. Проверьте консоль браузера на наличие заблокированных скриптов. - Отображается только на одной странице? Разместите фрагмент кода на уровне всего сайта (в подвале или в глобальном коде), а не на отдельной странице.
