> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brosbots.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress

> Wtyczka, która stawia agenta na stronie WordPress bez edycji motywu i bez kopiowania kodu.

Wtyczka **Brosbots Voice Agent** robi to samo co [widget na stronę
WWW](/pl/features/web-widget), tylko bez wklejania kodu w motyw. Klikasz raz,
logujesz się do Brosbots, wybierasz agenta i wracasz na stronę z gotowym
osadzeniem.

Agent, jego prompt, głos i baza wiedzy zostają w panelu Brosbots. Wtyczka
niczego nie duplikuje: decyduje tylko, gdzie widget się pokazuje i co agent wie
o odwiedzającym.

## Instalacja

<Steps>
  <Step title="Pobierz wtyczkę">
    W panelu Brosbots: **Integracje** → kafelek **WordPress** → **Pobierz wtyczkę
    (.zip)**.
  </Step>

  <Step title="Zainstaluj ją">
    W WordPressie: **Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer**, wskaż
    pobrany plik i aktywuj.
  </Step>

  <Step title="Wejdź w ustawienia">
    **Ustawienia → Brosbots**.
  </Step>

  <Step title="Połącz stronę">
    Kliknij **Połącz z Brosbots**. Trafisz do panelu, gdzie wybierasz agenta,
    który ma odpowiadać na tej stronie. Jeśli nie masz jeszcze konta, założysz je
    w tym samym kroku.
  </Step>

  <Step title="Autoryzuj">
    Po kliknięciu **Autoryzuj** wracasz na stronę z zapisanym połączeniem. Widget
    jest już aktywny.
  </Step>
</Steps>

Nic nie instaluje się przed Twoją zgodą, a token wraca dopiero na adres tej samej
domeny, z której zaczęło się łączenie.

## Wymagania

* WordPress 6.0 lub nowszy, PHP 7.4 lub nowszy.
* Strona musi działać po **https**. Przeglądarka nie udostępni mikrofonu na
  połączeniu nieszyfrowanym, więc połączenie po http zostanie odrzucone.
* Konto Brosbots z co najmniej jednym agentem.

## Gdzie widget się pokazuje

W **Ustawienia → Brosbots** wybierasz jeden z trybów:

| Tryb | Działanie |
| - | - |
| Każda strona | Widget na całej witrynie |
| Tylko wybrane strony | Widget wyłącznie na zaznaczonych stronach |
| Wszędzie poza wybranymi | Odwrotność powyższego |

Dodatkowo:

* **Koszyk i zamówienie** (WooCommerce) są domyślnie wyłączone. Pływający widget
  nad formularzem płatności kosztuje więcej zamówień, niż przynosi.
* **Panel administracyjny** nigdy nie ładuje widgetu.
* Shortcode `[brosbots]` renderuje agenta w treści strony i działa niezależnie od
  powyższych reguł. Wymaga trybu **inline** ustawionego w panelu Brosbots.

## Co agent wie o odwiedzającym

To jest różnica między wtyczką a zwykłym kodem osadzenia: agent zaczyna rozmowę
wiedząc, na co patrzy odwiedzający, zamiast o to pytać.

| Grupa | Co trafia do agenta |
| - | - |
| Strona | Tytuł i adres oglądanej strony, nazwa witryny |
| Odwiedzający | Imię i e-mail, **tylko gdy jest zalogowany** |
| WooCommerce | Oglądany produkt z ceną i dostępnością, liczba pozycji i wartość koszyka |

Każdą grupę wyłączasz osobnym checkboxem. Anonimowy odwiedzający nie wysyła o
sobie niczego.

<Note>
  Dane trafiają do agenta dopiero wtedy, gdy odwiedzający sam zacznie rozmowę.
  Samo wczytanie strony wysyła wyłącznie żądanie o konfigurację widgetu.
</Note>

## Rozszerzanie wtyczki

Wtyczka wystawia cztery filtry:

| Filtr | Zastosowanie |
| - | - |
| `brosbots_context_variables` | Dołóż własny kontekst, na przykład numer zamówienia albo rezerwacji |
| `brosbots_should_render` | Ostatnie słowo, czy widget ładuje się na tym żądaniu |
| `brosbots_app_url` | Wskaż własną instalację Brosbots (self-hosting) |
| `brosbots_api_url` | To samo dla adresu API |

```php theme={null}
add_filter( 'brosbots_context_variables', function ( $context ) {
    $context['order_number'] = get_query_var( 'order' );
    return $context;
} );
```

Zmienne z kontekstu wykorzystasz w prompcie agenta tak samo jak każdą inną
zmienną, patrz [Zmienne szablonu](/pl/voice-agent/template-variables).

## Zmiana agenta i odłączenie

* **Zmień agenta**: ten sam przycisk co przy pierwszym połączeniu. Wybierasz
  innego agenta, strona dostaje nowe osadzenie.
* **Odłącz tę stronę**: wtyczka zapomina token, widget przestaje się ładować.
  Agent, nagrania i transkrypty zostają nietknięte w Brosbots.
* **Odinstalowanie wtyczki** usuwa jej ustawienia z bazy WordPressa. Sam token
  cofniesz w panelu agenta, w sekcji osadzania.

## Bezpieczeństwo

Token osadzenia jest z natury jawny: trafia do źródła każdej strony, na której
działa widget. Chroni go lista dozwolonych domen, którą wtyczka ustawia
automatycznie podczas łączenia. Token skopiowany z Twojej strony nie zadziała na
cudzej.

Powrót z panelu jest przyjmowany tylko wtedy, gdy zgadza się jednorazowy kod
wygenerowany przez wtyczkę przed wyjściem, a sam token jest dodatkowo
weryfikowany w API. Spreparowany adres powrotny nie postawi na stronie cudzego
agenta.

## Rozwiązywanie problemów

**Widget się nie pokazuje.** Sprawdź, czy w ustawieniach jest zaznaczone
**Pokaż agenta na stronie**, czy strona mieści się w regułach wyświetlania, i czy
witryna działa po https.

**Komunikat „To połączenie nie zaczęło się tutaj".** Jednorazowy kod wygasł
(ma dziesięć minut) albo powrót nastąpił w innej przeglądarce. Kliknij
**Połącz z Brosbots** jeszcze raz.

**Komunikat o nierozpoznanym tokenie.** Osadzenie zostało w międzyczasie cofnięte
w panelu. Połącz stronę ponownie.

**Agent nie widzi koszyka.** Kontekst WooCommerce ma własny checkbox i wymaga
aktywnego WooCommerce.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.