> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Personalizacja widżetu
> Dostosuj wygląd, zachowanie i ustawienia głosowe widżetu czatu
Zakładka Widżet w panelu agenta pozwala w pełni dostosować wygląd i zachowanie widżetu czatu na Twojej stronie. Wszystkie zmiany są podglądane w czasie rzeczywistym.
## Przycisk Renderuj
Przycisk **Renderuj** w obszarze podglądu widżetu przeładowuje podgląd na żywo z aktualnymi ustawieniami. Użyj go, aby zobaczyć jak wyglądają Twoje zmiany przed zapisaniem.
## Wygląd
Zakładka Wygląd kontroluje projekt wizualny widżetu.
### Kolory
| Ustawienie | Opis |
| ----------------- | ----------------------------------------------------------- |
| **Główny** | Główny kolor przycisku i kolor akcentu widżetu |
| **Czat** | Kolor przycisku akcji czatu |
| **Wiadomość** | Kolor tła dymków wiadomości agenta |
| **Animacja** | Kolor efektów pulsowania i poświaty wokół przycisku widżetu |
| **Ocena** | Kolor ikon gwiazdek oceny po rozmowie |
| **Tekst statusu** | Kolor tekstu statusu na przycisku widżetu |
Kliknij dowolną próbkę koloru, aby otworzyć selektor kolorów z suwakiem nasycenia/odcienia i polem hex.
### Etykiety tekstowe
| Ustawienie | Domyślnie | Opis |
| ----------------------- | ---------------- | ------------------------------------------ |
| **Tytuł główny** | "Need help?" | Tytuł wyświetlany na przycisku widżetu |
| **Przycisk połączenia** | "Web call" | Etykieta na przycisku połączenia głosowego |
| **Przycisk czatu** | "Chat" | Etykieta na przycisku czatu |
| **Placeholder pola** | "Enter the text" | Tekst zastępczy w polu wiadomości |
### Pozycja
| Opcja | Opis |
| ------------------- | -------------------------------------------------- |
| **Prawy dolny róg** | Domyślna — widżet pojawia się w prawym dolnym rogu |
| **Dolny środek** | Na środku na dole strony |
| **Lewy dolny róg** | Lewy dolny róg |
| **Prawy górny róg** | Prawy górny róg |
| **Górny środek** | Na środku u góry |
| **Lewy górny róg** | Lewy górny róg |
### Rozmiar i styl
| Ustawienie | Opcje | Opis |
| ----------------------- | -------------------- | -------------------------------------------- |
| **Motyw widżetu** | Jasny / Ciemny | Motyw kolorystyczny okna czatu |
| **Rozmiar widżetu** | Mały / Średni / Duży | Ogólny rozmiar widżetu |
| **Zaokrąglenie rogów** | 0–50px (suwak) | Zaokrąglenie rogów widżetu |
| **Przezroczystość tła** | 0–100% (suwak) | Przezroczystość tła widżetu |
| **URL awatara** | URL | Niestandardowy obraz awatara agenta w czacie |
## Zachowanie
Zakładka Zachowanie kontroluje sposób działania widżetu.
### Język
| Ustawienie | Opcje | Opis |
| ----------------- | --------------------------------------------- | ------------------------------------------------------------------------- |
| **Język widżetu** | English, Українська, Polski, Deutsch, Español | Język interfejsu dla wszystkich etykiet i komunikatów systemowych widżetu |
### Funkcje
| Ustawienie | Domyślnie | Opis |
| ---------------------------- | --------- | ------------------------------------------------------------------------------------- |
| **Zbieranie opinii** | Włączone | Pokaż okno oceny gwiazdkowej po zakończeniu rozmowy |
| **Tekst podczas połączenia** | Włączone | Pozwól użytkownikowi pisać wiadomości tekstowe podczas aktywnego połączenia głosowego |
| **Tryb tylko czat** | Wyłączone | Wyłącz połączenia głosowe — dostępny tylko czat tekstowy |
| **Regulamin** | Wyłączone | Wymagaj od użytkownika zaakceptowania regulaminu przed rozpoczęciem czatu |
| **Efekty dźwiękowe** | Włączone | Odtwarzaj dźwięki powiadomień przy nowych wiadomościach |
### Automatyzacja
| Ustawienie | Domyślnie | Opis |
| -------------------------- | ----------------- | ---------------------------------------------------------------------------------------------- |
| **Automatyczne otwarcie** | Wyłączone | Automatycznie otwórz widżet po określonym czasie |
| **Opóźnienie otwarcia** | 5s (suwak, 0–60s) | Czas oczekiwania przed automatycznym otwarciem (tylko gdy Automatyczne otwarcie jest włączone) |
| **Automatyczne powitanie** | Wyłączone | Automatycznie wyślij wiadomość powitalną po otwarciu widżetu |
### Widoczność
| Ustawienie | Domyślnie | Opis |
| ----------------------------------- | --------- | ------------------------------------------------------ |
| **Widżet włączony** | Włączone | Główny przełącznik — pokaż lub ukryj widżet na stronie |
| **Pokaż na urządzeniach mobilnych** | Włączone | Wyświetlaj widżet na urządzeniach mobilnych |
| **Pokaż na komputerze** | Włączone | Wyświetlaj widżet na komputerach stacjonarnych |
### Branding
| Ustawienie | Domyślnie | Opis |
| ----------------------- | --------- | ------------------------------------------------------------------------------------ |
| **Znaczek Powered By** | Włączone | Pokaż branding "Powered by Revol" na dole widżetu |
| **Wiadomość powitalna** | — | Wiadomość powitalna wyświetlana po otwarciu czatu (zanim użytkownik cokolwiek wyśle) |
### Szczegóły regulaminu
Gdy **Regulamin** jest włączony, pojawiają się dodatkowe pola:
| Ustawienie | Opis |
| -------------------- | -------------------------------------------------------------------------------------- |
| **Tekst regulaminu** | Tekst wyświetlany użytkownikowi (np. "Kontynuując, zgadzasz się z naszym Regulaminem") |
| **URL regulaminu** | Link do pełnej strony regulaminu |
## Głos
Zakładka Głos konfiguruje rozpoznawanie mowy i syntezę mowy dla połączeń głosowych.
### Rozpoznawanie mowy (STT)
| Ustawienie | Opcje | Opis |
| ---------- | ------------------- | -------------------------------- |
| **Język** | Українська, English | Język transkrypcji mowy na tekst |
### Wiadomość powitalna
Tekst wypowiadany przez agenta podczas odbierania połączenia głosowego. Możesz **odsłuchać** podgląd audio przed zapisaniem i kliknąć **Zapisz**, aby zastosować.
### Wiadomość pożegnalna
Tekst wypowiadany po zakończeniu połączenia. Również posiada przyciski **Podgląd** i **Zapisz**.
### Wyjście głosowe (TTS)
| Ustawienie | Opcje | Opis |
| ------------ | --------------------------------------- | ------------------------------------------------------------- |
| **Dostawca** | OpenAI TTS | Dostawca syntezy mowy (ElevenLabs i Google Cloud TTS wkrótce) |
| **Głos** | Alloy, Echo, Fable, Onyx, Nova, Shimmer | Charakter głosu agenta |
| **Model** | tts-1, tts-1-hd | Jakość audio — standardowa lub HD |
| **Prędkość** | 0.5x – 2.0x (suwak) | Prędkość mowy |
**Opisy głosów:**
| Głos | Charakter |
| ----------- | ----------------------------- |
| **Alloy** | Neutralny, zrównoważony |
| **Echo** | Ciepły, konwersacyjny |
| **Fable** | Ekspresyjny, brytyjski akcent |
| **Onyx** | Głęboki, autorytatywny |
| **Nova** | Przyjazny, optymistyczny |
| **Shimmer** | Czysty, delikatny |
### Testowanie głosu
Wpisz dowolny tekst i kliknij **Odtwórz test**, aby usłyszeć jak brzmi wybrany głos z aktualnymi ustawieniami.
## Zapisz i resetuj
* **Zapisz** — zastosuj wszystkie zmiany w widżecie
* **Resetuj** — przywróć wszystkie ustawienia do ostatniego zapisanego stanu