Как да инсталирате агента на WordPress и WooCommerce

Три начина за вграждане на код в WordPress, как агентът чете каталога на WooCommerce, какво да правите с кеширащите плъгини и как да свържете чата с количката.

6 септември 2026 г.

В WordPress кодът се вгражда по три начина. Изберете според това доколко сте свикнали да редактирате файловете на темата.

Начин 1: плъгин за вграждане на код (препоръчваме)#

Най-сигурният вариант: промените няма да се изгубят при обновяване на темата.

1. Инсталирайте произволен плъгин за вграждане на скриптове: WPCode, Insert Headers and Footers, Code Snippets.
2. Отворете настройките на плъгина и намерете полето за код във футъра — обикновено се нарича Footer или Body (before closing tag).
3. Поставете реда от акаунта си и запазете.

Начин 2: файл на темата#

1. Външен вид → Редактор на файлове на тема.
2. Отворете footer.php.
3. Поставете кода преди </body>.
4. Актуализирайте файла.

Важно: редактирайте дъщерната тема. При обновяване на родителската тема файлът ще бъде презаписан заедно с вашия код.

Начин 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 е кешът. След вграждане на кода:

1. Изчистете кеша на плъгина: WP Rocket, W3 Total Cache, LiteSpeed или каквото използвате.
2. Изчистете кеша на CDN, ако използвате Cloudflare.
3. Проверете сайта в инкогнито режим.

Ако в плъгина е включено „обединяване и отложено зареждане на скриптове“, добавете нашия скрипт в изключенията: сливането на външни скриптове понякога прекъсва зареждането.

Светла и тъмна тема#

Уиджетът поддържа и двете. В настройките се избира светла тема, тъмна или „като на посетителя“ — последната следва системните настройки на устройството и е зададена по подразбиране.

Това е удобно, ако вашата WordPress тема има превключвател за ден и нощ: оставете „като на посетителя“ и чатът ще съвпада с това, което човекът вече е избрал на своето устройство.

Кеширащи плъгини#

Проверка#

• Бутонът за чат се появява в долния десен ъгъл на всяка страница от сайта.
• Въпрос за продукт показва продуктова карта с цена.
• Бутонът за поръчка води към кошницата на WooCommerce.
• На мобилно устройство бутонът не закрива менюто и кошницата.

Често задавани въпроси#

Нужен ли е отделен плъгин Commerce Agents#

Не. Достатъчен е един ред код, отделен плъгин не се изисква и не се инсталира.

Уиджетът не се появи, какво да проверя първо#

Кеш: кеширащ плъгин и CDN. След това — дали кодът е вграден във футъра, а не в произволен уиджет на страничната лента, и дали темата наистина извежда wp_footer().

Ще знае ли агентът за отстъпки и купони#

За купони — не: те се прилагат в кошницата на WooCommerce. Агентът показва цените, които са били при обхождането, включително цената с отстъпка, ако тя се показва на страницата на продукта.

Ще забави ли това сайта#

Скриптът е асинхронен, тежи малко и не блокира изобразяването на страницата. Влиянието върху PageSpeed е минимално.

Може ли уиджетът да се показва само в магазина, а не в блога#

Да, ако вграждате кода чрез плъгин с условия за показване или във functions.php с проверка is_woocommerce(). В по-простия случай агентът на всички страници не пречи: той отговаря и на въпроси за доставка от блога.