Przejdź do głównej treści
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: 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ć. 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:
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.