---
title: Как да инсталирате агента на WordPress и WooCommerce
description: Три начина за вграждане на код в WordPress, как агентът чете каталога на WooCommerce, какво да правите с кеширащите плъгини и как да свържете чата с количката.
section: platforms
keywords: WordPress, WooCommerce, уиджет WordPress, чат за уебсайт, footer.php, плъгин за код WordPress, AI агент, инсталиране чат, свързване чат количка, кеширащи плъгини, AI продажби, Commerce Agents
updated: 2026-09-06
---
В 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` на дъщерната тема:

```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()`. В по-простия случай агентът на всички страници не пречи: той отговаря и на въпроси за доставка от блога.