Как добавить чат-бота на WordPress с помощью блока, виджета или шорткода

Перейдите в консоль WordPress → WebChatAgent → General. Вставьте полный UUID в поле Chatbot ID, включите виджет только в том случае, если вам нужна плавающая кнопка на всем сайте, и нажмите Save Settings. Заблокированное для редактирования название и превью должны обновиться и показать нужного ассистента.

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

Успешное сохранение подтверждает запись данных в базе сайта. Загруженное название ассистента и превью дополнительно подтверждают, что ID, публичный запрос конфигурации и список Allowed websites согласованы.

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

Откройте вкладку Inline Embed, чтобы увидеть два способа вставки в контент. Пользователям Gutenberg лучше выбрать блок WebChatAgent Inline Chat: редакторы легко находят его визуально и могут при необходимости задать индивидуальный ID. В Classic Editor, Elementor, Divi и текстовых виджетах можно вставить `[webchatagent_inline]` в любой элемент с поддержкой шорткодов.

Оба встроенных метода по умолчанию используют Chatbot ID из раздела General. Это позволяет централизованно менять ассистента в будущем и упрощает поддержку.

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

Плавающий виджет загружается везде, где активная тема вызывает функцию `wp_footer()`. Если в админке превью работает, а на самом сайте виджета нет, проверьте footer темы и плагины оптимизации, прежде чем менять Chatbot ID.

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

Создайте или откройте нужную страницу, вызовите вставку блоков (Block Inserter) и введите в поиск “chat”. Выберите WebChatAgent Inline Chat в категории Embeds. Добавьте перед блоком понятный заголовок и предложение, поясняющее посетителям, какие вопросы можно задать чату.

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

Сначала опубликуйте страницу на тестовом сайте (staging). Откройте публичный URL и оцените полную высоту чата на десктопе и смартфоне; не ориентируйтесь только на заглушку в редакторе.

Оставьте поле Chatbot ID в боковой панели блока пустым, чтобы использовались настройки из General. Вводите полный UUID только тогда, когда на этой конкретной странице действительно нужен специализированный бот — например, помощник по настройке внутри личного кабинета, тогда как плавающий бот отвечает за общие вопросы.

Зафиксируйте URL страницы, имя ассистента и ответственного за переопределение в документации проекта. Если ассистент будет удален или заменен, скрытые переопределения на отдельных страницах легко упустить из виду.

Если встроенный и плавающий чаты отвечают по-разному, сравните их публичные имена ассистентов и ID, прежде чем искать ошибки в базе знаний или настройках модели.

Добавьте модуль «Шорткод» или блок с поддержкой HTML и вставьте `[webchatagent_inline]`. Это самый надежный вариант для Classic Editor, Elementor, Divi, переиспользуемых виджетов и шаблонов, обрабатывающих шорткоды WordPress.

Для намеренного вызова специализированного ассистента используйте `[webchatagent_inline chatbot-id="UUID"]`. Вариант написания `chatbot_id="UUID"` предусмотрен для конструкторов, которые вырезают дефисы из названий атрибутов.

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

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

Инициализируйте необязательные файлы cookie и хранилище чата только после получения согласия, требуемого вашей политикой конфиденциальности. Виджет WebChatAgent поддерживает передачу статуса согласия, однако именно ваш плагин управления куки в WordPress определяет момент запуска скриптов. Задокументируйте правовые основания, сроки хранения данных и сведения об обработчиках.

Исключите `web-chat-agent.js` и `chat-widget-inline.js` из отложенной загрузки (delay), объединения скриптов и агрессивной минификации. Сбрасывайте кеш WordPress, конструкторов страниц, обратного прокси и CDN после каждого изменения размещения или ID.

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

Проверенный вопрос: “What is the exact onboarding code for the WordPress embed lab?” Ожидаемый и фактический результат: `WP-EMBED-47`. Реальный встроенный виджет ответил: “The exact onboarding code for the WordPress embed lab is WP-EMBED-47.”

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