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, 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

1. Pobierz wtyczkę

   W panelu Brosbots: Integracje → kafelek WordPress → Pobierz wtyczkę (.zip).

2. Zainstaluj ją

   W WordPressie: Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer, wskaż pobrany plik i aktywuj.

3. Wejdź w ustawienia

   Ustawienia → Brosbots.

4. 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.

5. Autoryzuj

   Po kliknięciu Autoryzuj wracasz na stronę z zapisanym połączeniem. Widget jest już aktywny.

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.

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

​

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

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.

​

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.