Как установить агента на WordPress и WooCommerce
Три способа вставить код на WordPress, как агент читает каталог WooCommerce, что делать с кэширующими плагинами и как связать чат с корзиной.
На WordPress код вставляется тремя способами. Выбирайте по тому, насколько вам близка правка файлов темы.
Способ 1: плагин вставки кода (рекомендуем)#
Самый безопасный вариант: правка не потеряется при обновлении темы.
- Установите любой плагин для вставки скриптов: WPCode, Insert Headers and Footers, Code Snippets.
- Откройте настройки плагина и найдите поле для кода в подвале — обычно оно называется Footer или Body (before closing tag).
- Вставьте строку из кабинета и сохраните.
Способ 2: файл темы#
- Внешний вид → Редактор файлов темы.
- Откройте
footer.php. - Вставьте код перед
</body>. - Обновите файл.
Важно: правьте дочернюю тему. При обновлении родительской темы файл перезапишется вместе с вашим кодом.
Способ 3: через functions.php#
Для тех, кому ближе код. В functions.php дочерней темы:
add_action('wp_footer', function () {
echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="ваш-слаг" async></script>';
});Точную строку скрипта возьмите в кабинете, кнопкой «Скопировать код».
Каталог из WooCommerce#
Укажите адрес сайта в настройках и запустите анализ. Обходчик читает товары WooCommerce через структурированные данные страниц: название, цена, наличие, описание, фотографии, категории.
Что стоит знать:
- Вариативные товары попадают в карточку с диапазоном цен и характеристиками.
- Скрытые и черновики не читаются — так и должно быть.
- Товары только для авторизованных агент не увидит: он ходит по сайту как обычный посетитель.
- Если у вас есть выгрузка товаров в CSV, её можно загрузить в разделе «Каталог» — иногда это быстрее и точнее обхода.
Корзина и оплата#
На WooCommerce оплату в чате обычно не включают: у магазина есть своя касса с доставкой, налогами и купонами.
Укажите в настройках ссылку на корзину, чаще всего https://ваш-домен/cart или /корзина. Агент будет доводить покупателя туда.
Чтобы видеть, какие диалоги превращаются в заказы, добавьте фрагмент пикселя покупки на страницу «Спасибо за заказ». В WooCommerce это шаблон checkout/thankyou.php или тот же плагин вставки кода с условием на страницу заказа.
Кнопка в чате кладёт товар в корзину WooCommerce#
Карточки товаров в ответах агента — это не картинки для красоты. У каждой есть ссылка на страницу товара в вашем магазине, и агент умеет пользоваться стандартным механизмом WooCommerce для добавления в корзину: адресом вида ?add-to-cart=123.
Покупатель нажимает кнопку в чате, товар оказывается в корзине, дальше работает ваша касса со всеми плагинами доставки, купонов и налогов. Никаких интеграций и ключей для этого не нужно: механизм встроен в WooCommerce с рождения.
Если ссылка ведёт на страницу вариативного товара, агент открывает её — выбрать размер и цвет покупатель должен сам, и это правильно: подставлять за него вариант рискованно.
Ещё одна вещь, которую стоит знать: агент видит страницу, на которой открыт чат. Он читает разметку товара — название, артикул, цену — и отвечает в контексте. Посетитель стоит на карточке и пишет «а дешевле есть?» — агент понимает, с чем сравнивать, и предлагает альтернативу из вашего каталога, а не абстрактный совет.
Главная причина «виджет не появился» на WordPress — кэш. После вставки кода:
- Очистите кэш плагина: WP Rocket, W3 Total Cache, LiteSpeed или что у вас стоит.
- Очистите кэш CDN, если используете Cloudflare.
- Проверьте сайт в режиме инкогнито.
Если в плагине включено «объединение и отложенная загрузка скриптов», добавьте наш скрипт в исключения: слияние сторонних скриптов иногда ломает загрузку.
Светлая и тёмная тема#
Виджет умеет и то, и другое. В настройках выбирается светлая тема, тёмная или «как у посетителя» — последняя следует за системными настройками устройства и стоит по умолчанию.
Это удобно, если у вашей темы WordPress есть переключатель дня и ночи: оставьте «как у посетителя», и чат будет совпадать с тем, что человек уже выбрал у себя.
Кэширующие плагины#
Проверка#
- Кнопка чата появляется в правом нижнем углу на любой странице сайта.
- Вопрос о товаре даёт карточку с ценой.
- Кнопка оформления ведёт в корзину WooCommerce.
- На мобильном кнопка не перекрывает меню и корзину.
Частые вопросы#
Нужен ли отдельный плагин Commerce Agents#
Нет. Достаточно строки кода, отдельный плагин не требуется и не устанавливается.
Виджет не появился, что проверить первым#
Кэш: плагин кэширования и CDN. Затем — что код вставлен в подвал, а не в произвольный виджет боковой колонки, и что тема действительно выводит wp_footer().
Будет ли агент знать про скидки и купоны#
Про купоны нет: они применяются в корзине WooCommerce. Цены агент показывает те, что были при обходе, включая цену со скидкой, если она отображается на странице товара.
Замедлит ли это сайт#
Скрипт асинхронный, весит немного и не блокирует отрисовку страницы. На PageSpeed влияние минимальное.
Можно ли показывать виджет только в магазине, а не в блоге#
Да, если вставлять код через плагин с условиями показа или в functions.php с проверкой is_woocommerce(). В простом случае агент на всех страницах не мешает: он отвечает и на вопросы про доставку из блога.