Як встановити агента на 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="your-slug" async></script>';
});Точний рядок скрипту візьміть у кабінеті, кнопкою «Скопіювати код».
Каталог з WooCommerce#
Вкажіть адресу сайту в налаштуваннях і запустіть аналіз. Обхідник читає товари WooCommerce через структуровані дані сторінок: назва, ціна, наявність, опис, фотографії, категорії.
Що варто знати:
- Варіативні товари потрапляють у картку з діапазоном цін та характеристиками.
- Приховані та чернетки не читаються — так і має бути.
- Товари лише для авторизованих агент не побачить: він переглядає сайт як звичайний відвідувач.
- Якщо у вас є вивантаження товарів у CSV, його можна завантажити в розділі «Каталог» — іноді це швидше та точніше, ніж обхід.
Кошик та оплата#
На WooCommerce оплату в чаті зазвичай не вмикають: магазин має власну касу з доставкою, податками та купонами.
Вкажіть у налаштуваннях посилання на кошик, найчастіше https://your-domain/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(). У простому випадку агент на всіх сторінках не заважає: він відповідає і на питання про доставку з блогу.