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

# Widget na stronę WWW

> Osadź agenta głosowego na dowolnej stronie WWW lub w aplikacji mobilnej - odwiedzający porozmawiają z nim wprost z przeglądarki.

### Jak osadzić agenta

<Note>
  Na WordPressie nie musisz przechodzić przez ten kreator ani wklejać kodu w motyw:
  [wtyczka Brosbots dla WordPressa](/pl/integrations/cms/wordpress) łączy stronę
  jednym kliknięciem i sama ustawia dozwoloną domenę.
</Note>

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.

<Note>
  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.
</Note>

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


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