Skip to main content

​
Jak osadzić agenta

Na WordPressie nie musisz przechodzić przez ten kreator ani wklejać kodu w motyw: wtyczka Brosbots dla WordPressa łączy stronę jednym kliknięciem i sama ustawia dozwoloną domenę.
Przejdź do swojego agenta i włącz osadzanie na zewnętrznej stronie. Krok 1: Otwórz agenta i kliknij Widget w nagłówku edytora - otworzy się okno Wdróż agenta. Krok 2: Włącz przełącznik Włącz osadzanie. Krok 3: W polu Dozwolone domeny dodaj domenę, na której widget ma działać, na przykład example.com (wersja z www. jest dopasowywana automatycznie; *.example.com obejmuje subdomeny). Żądanie z domeny spoza listy zostanie odrzucone. Klucz bez żadnej domeny działa tylko w panelu (podgląd w edytorze), więc bez wpisu widget na Twojej stronie nie wystartuje. Panel jest dozwolony zawsze, także gdy lista nie jest pusta, więc podgląd w edytorze działa niezależnie od wpisanych domen. Jeśli w kreatorze startowym podałeś stronę firmy, klucz utworzony w kroku Widget ma już jej domenę na liście (np. www.bistrolipowa.pl z adresu https://www.bistrolipowa.pl/menu), więc wklejony fragment działa od razu. Bez adresu strony dodaj domenę tutaj.
Klucze utworzone przed wprowadzeniem tej zasady działają na razie na każdej stronie. Gdy taki klucz zostanie użyty na stronie spoza listy, w tym oknie pojawi się baner z przyciskiem Dodaj <domena> z wykrytym adresem. Kliknij go i zapisz.

​
Limity sesji

Żeby klucza nie dało się wykorzystać do spalania cudzych minut, każdy klucz ma limity:
  • najwyżej 100 sesji na dobę,
  • najwyżej 10 sesji z jednej przeglądarki na dobę,
  • najwyżej 10 sesji z jednego adresu IP na dobę i 4 w ciągu 10 minut (liczy się adres, z którego faktycznie przyszło połączenie, więc skrypt nie obejdzie limitu zmianą identyfikatora przeglądarki),
  • najwyżej 3 rozmowy naraz,
  • jedna sesja trwa do 5 minut.
Zwykły odwiedzający prowadzi jedną, dwie rozmowy, więc limitów nie zauważy. Kto na nie trafi, widzi w widgecie komunikat w języku widgetu (np. „Zbyt wiele prób w krótkim czasie. Spróbuj ponownie za kilka minut.”) i może spróbować później. Minuty rozmów w widgecie schodzą z pakietu planu tak samo jak rozmowy telefoniczne.

​
Dzienny budżet minut

W oknie Wdróż agenta (przycisk Widget w edytorze) ustawiasz Dzienny budżet minut: ile minut rozmów widget może wykorzystać w ciągu doby. Domyślnie 120 minut, można ustawić od 5 do 500. Budżetu nie da się wyłączyć: górna granica to tyle, ile zmieści się w dziennym limicie sesji.
  • Liczą się minuty faktycznie przegadane dziś przez sesje tego klucza, a rozmowy jeszcze trwające liczą się od chwili rozpoczęcia.
  • Doba liczona jest w UTC, czyli kończy się o 1:00 (zimą) albo 2:00 (latem) czasu polskiego.
  • Przy 80% i 100% budżetu dostajesz powiadomienie w panelu (dzwonek) i e-mail, każde najwyżej raz dziennie. Można je wyłączyć w Konto > Powiadomienia > Widget na stronie.
  • Po wyczerpaniu budżetu nowe rozmowy nie ruszają do końca doby. Odwiedzający widzi komunikat, że rozmowy z asystentem są dziś niedostępne. Rozmowa, która już trwa, nie jest przerywana. Podniesienie budżetu działa od razu.
Pod polem widać, ile minut widget wykorzystał dziś. Krok 4: Skonfiguruj widget - pływający (floating) albo osadzony w treści (inline). Krok 5: Wklej kod na swoją stronę i przetestuj agenta.

​
Tożsamość agenta na panelu rozmowy

W sekcji Tożsamość agenta ustawiasz to, co odwiedzający widzi przed pierwszą wiadomością:
  • Wyświetlana nazwa - domyślnie nazwa agenta.
  • Adres awatara - domyślnie awatar agenta, potem logo widgetu, potem emoji agenta; gdy nie ma żadnego z nich, panel pokazuje inicjały agenta.
  • Powitanie - tekst na panelu przed startem rozmowy. Wypowiadane powitanie zostaje w konfiguracji agenta.

​
Język widgetu

Napisy widgetu - „Gotowy”, „Rozmowa zakończona”, powitanie na panelu, komunikaty o mikrofonie - są po polsku albo po angielsku. Język wybierany jest w tej kolejności:
  1. parametr lang w adresie skryptu osadzenia (...brosbots-widget.js?token=...&lang=pl),
  2. język, którym mówi agent - brany z jego konfiguracji, więc zwykle nic nie musisz ustawiać,
  3. atrybut lang Twojej strony,
  4. angielski.
Agent wielojęzyczny dostaje angielskie napisy, zamiast zgadywania. Powitanie na panelu możesz nadpisać własnym tekstem w polu Powitanie.

​
Floating a inline

W trybie floating przycisk w rogu strony otwiera rozmowę w modalu. W trybie inline cała rozmowa - awatar, transkrypt i kontrolki - renderuje się wewnątrz Twojego <div id="brosbots-inline-container">. Nic nie nakłada się na stronę. Panel przyjmuje wysokość kontenera, który mu dasz, a transkrypt scrolluje się w środku. Jeśli kontener nie ma własnej wysokości, panel dobiera ją sam - od 320px do 640px (najwyżej 80% wysokości okna).

​
Oznaczenie “Powered by BrosBots”

Widget pokazuje na dole panelu mały link do BrosBots, prowadzący do brosbots.com. O tym, czy się pojawia, decyduje Twój plan - po stronie serwera, przy pobieraniu konfiguracji widgetu:
  • Free - zawsze widoczne. Przełącznik w oknie osadzania jest zablokowany, a widget nie wystartuje rozmowy, dopóki oznaczenie jest ukryte albo usunięte.
  • Plany płatne - przełącznik domyślnie włączony, można go wyłączyć.
W oknie osadzania widać też, w ilu sesjach oznaczenie było ukryte - to sygnał do kontaktu z klientem.