Widget strony internetowej

Widget OneTwoAgent umieszcza agenta wsparcia AI na Twojej stronie i w Twojej aplikacji: czat i Voice w języku klienta, zrzuty ekranu i pliki oraz przekazanie rozmowy zespołowi w tej samej skrzynce. Dopasujesz go do marki bez CSS.

Widget wsparcia AI dla SaaSPersonalizacja widgetuVoice w widgecieZrzuty ekranu i załączniki

Co obejmuje ten artykuł

  • Co klienci mogą robić w widgecie: czat, Voice, zrzuty ekranu i pliki — we własnym języku.
  • Jak dostosować wygląd i zachowanie widgetu.
  • Jak zainstalować widget na stronie internetowej.
  • Jak zastosować ustawienia bezpieczeństwa, takie jak dozwolone domeny i wykluczone strony.

Tworzysz SaaS lub aplikację z logowaniem?

Uruchom npx -y @onetwoagent/cli@latest init --browser w swoim projekcie, a potem napisz do swojego agenta kodującego „Integrate OneTwoAgent”. Zobacz Połącz OneTwoAgent ze swoją aplikacją, aby rozpoznawać zalogowanych klientów i przekazywać agentowi aktualne dane konta z Twojego backendu.

Co klienci mogą robić w widgecie

Agent wsparcia AI odpowiada w każdej rozmowie w widgecie na podstawie Twojej bazy wiedzy. W przypadku zalogowanych klientów korzysta też z danych konta, które autoryzuje Twój backend.

  • Pisać na czacie we własnym języku: agent odpowiada w tym języku, w którym pisze klient.
  • Talk (Voice): klienci mogą rozmawiać z agentem głosowo. Mowa jest rozpoznawana automatycznie, a Voice odpowiada na głos w 40+ językach; tam, gdzie odpowiedź głosowa nie jest obsługiwana, rozmowa toczy się dalej tekstowo. Minuty Voice są dostępne w płatnych planach.
  • Wysyłać zrzuty ekranu i pliki: obrazy, zrzuty ekranu i zdjęcia oraz pliki PDF, DOC, DOCX i TXT do 8 MB. Obrazy są odczytywane za pomocą rozpoznawania obrazu (vision), a dokumenty PDF i Word są analizowane łącznie z tabelami.
  • Wklejać linki: agent odczytuje podlinkowaną stronę jako kontekst tej rozmowy. Linki od klientów to kontekst, a nie Twoja zatwierdzona wiedza.
  • Skontaktować się z człowiekiem: gdy agent nie może zweryfikować odpowiedzi, przekazuje rozmowę Twojemu zespołowi zamiast zgadywać, a każdy członek zespołu może ją przejąć ze skrzynki.
Agent odpowiada po hiszpańsku klientowi, który napisał po hiszpańsku
Klient pisze po hiszpańsku, agent odpowiada po hiszpańsku.

1. Otwórz ustawienia Widgetu

Przejdź do Channels -> Widget. Jeśli widget nie jest jeszcze włączony, najpierw go włącz.

  • Podgląd na żywo ekranów Home, Chat i Talk na desktopie i mobile.
  • Ustawienia wyglądu i zachowania.
  • Kod instalacyjny.

2. Dostosuj widget

Dopasuj widget do swojego produktu bez pisania CSS. Każda zmiana od razu pojawia się w podglądzie na żywo.

  • Ekrany: Home, Chat i Talk (Voice). Ty wybierasz, który otwiera się jako pierwszy.
  • Motyw: jasny lub ciemny.
  • Kolory: nagłówek, dymki asystenta i klienta, tło czatu, pole wpisywania, przycisk wysyłania, launcher, przyciski i przycisk zamykania.
  • Typografia: 45 fontów Google Fonts (bezszeryfowe, szeryfowe i o stałej szerokości), ustawiane osobno dla nagłówka, wiadomości asystenta, wiadomości klienta, pola wpisywania i launchera, każdy z własnym rozmiarem.
  • Wiadomości: 6 kształtów dymków, opcjonalnie dla obu stron, oraz wybór ikony wysyłania.
  • Nagłówek: nazwa asystenta, linia statusu i opcjonalny awatar lub logo.
  • Launcher: 15 ikon, opcjonalny tekst (na mobile może zostać sama ikona) i 13 animacji launchera.
  • Ekran Home: nagłówek, krótka linia nad nim, główny przycisk, do 3 linków, animowana kula (orb) i style tła, takie jak mesh, halo, rays, glow, stars, dots, grain i halftone, z regulacją odcienia, intensywności i ruchu.
  • Talk: głos, powitanie odtwarzane na głos i tekstura kuli (orb).
  • Teksty i zachowanie: wiadomość powitalna, tekst zastępczy pola wpisywania, przesyłanie plików włączone lub wyłączone, tryb kompaktowy, dozwolone domeny oraz dozwolone lub wykluczone strony.
Notatki
  • Postaw na prostotę: kolory marki, wyraźna nazwa i jedno krótkie powitanie zwykle sprawdzają się najlepiej.
  • Wszystkie ustawienia szczegółowo: Dostosuj widget.

3. Zainstaluj widget na swojej stronie

Standardowa instalacja (zalecana).

  1. 1Skopiuj skrypt widgetu z Channels -> Widget -> Install code
  2. 2Dodaj go do strony tak, aby ładował się na każdej podstronie.
  3. 3Najlepsze miejsce: wewnątrz <head>, przed </head>.
  4. 4Jeśli <head> nie jest dostępne, umieść go przed </body> (też działa, ale może ładować się trochę wolniej).
Notatki
  • Po instalacji i publikacji widget powinien pojawić się na Twojej stronie produkcyjnej.

4. Instalacja na popularnych platformach

  • Shopify: Online Store>Themes>Edit code -> layout/theme.liquid -> wklej przed </head> -> Save
  • Wix Opcja A: Settings -> Custom Code -> Add New Tool -> wklej kod -> Load on all pages -> umieść w Head -> Save i opublikuj.
  • Wix Opcja B: dodaj skrypt przez globalny obszar skryptów/pluginów strony i upewnij się, że ładuje się na wszystkich stronach.
  • Webflow: Project Settings>Custom Code>wklej w Head Code -> Save i opublikuj.
  • WordPress: użyj wtyczki do skryptów w headerze (sekcja Header) albo wklej kod do header.php przed </head>.
  • Custom-coded sites: umieść skrypt w globalnym szablonie HTML wewnątrz <head> albo przed </body>.

Albo wyślij to swojemu developerowi

5. Ustawienia bezpieczeństwa i kontroli

Zalecane ustawienia dla bezpieczniejszego i czystszego działania.

  • Dozwolone domeny: zapobiegają ponownemu użyciu kodu widgetu na niepowiązanych stronach.
  • Przykładowe domeny: yourdomain.com, www.yourdomain.com, shop.yourdomain.com.
  • Wykluczone strony: ukryj widget tam, gdzie nie jest potrzebny.
  • Typowe wykluczenia: checkout, potwierdzenie zamówienia, account/login, prywatność i strony techniczne.
  • Przykłady ścieżek: /checkout, /account, /thank-you.
Notatki
  • Zacznij prosto: najpierw włącz widget wszędzie, a potem wykluczaj tylko te strony, których naprawdę nie chcesz.

6. Jak działają rozmowy w widgecie

  • Każda rozmowa z widgetu pojawia się w Conversations, w tej samej skrzynce co WhatsApp, Instagram i Telegram.
  • Agent wsparcia AI odpowiada w języku klienta na podstawie Twojej bazy wiedzy, a w przypadku zalogowanych klientów także na podstawie autoryzowanych danych konta.
  • Każdy członek zespołu może przejąć rozmowę i odpowiedzieć bezpośrednio. Gdy rozmowę prowadzi członek zespołu, AI milczy; kliknij Resume AI, aby oddać ją AI.
  • W widgecie klient widzi "{name} joined the conversation", gdy odpowiada członek zespołu, oraz "Assistant resumed", gdy AI znów odpowiada.

Rozwiązywanie problemów

  • Widget się nie pokazuje: upewnij się, że skrypt jest na stronie produkcyjnej (nie tylko w podglądzie), opublikuj zmiany i sprawdź dozwolone domeny, jeśli są włączone.
  • Widget pojawia się tylko na niektórych stronach: sprawdź reguły wykluczonych stron i potwierdź, że skrypt jest zainstalowany globalnie.
  • Wiadomości nie przychodzą: sprawdź, czy używasz właściwego konta biznesowego OneTwoAgent i upewnij się, że widget jest włączony w Channels -> Widget.

Powiązane przewodniki

Przejdź do kolejnych kroków konfiguracji dotyczących kanałów, rezerwacji, harmonogramu lub automatyzacji.

Najczęstsze pytania

Czy mogę zainstalować widget bez pełnej integracji niestandardowej?

Tak. Standardowa konfiguracja to jeden skrypt widgetu na stronie oraz ustawienia wyglądu i zachowania w panelu.

Czy widget działa na mobile tak samo jak na desktopie?

Tak. Widget jest przeznaczony zarówno dla odwiedzających na desktopie, jak i na mobile, a rozmowy trafiają do tej samej skrzynki.

W jakich językach odpowiada widget?

W języku klienta. Agent odpowiada w tym języku, w którym pisze klient. W Voice mowa jest rozpoznawana automatycznie, a Voice odpowiada na głos w 40+ językach; tam, gdzie odpowiedź głosowa nie jest obsługiwana, rozmowa toczy się dalej tekstowo. 10 języków panelu określa wyłącznie interfejs Twojego zespołu.

Czy klienci mogą wysyłać zrzuty ekranu lub pliki?

Tak. Klienci mogą dołączać obrazy, zrzuty ekranu i zdjęcia oraz pliki PDF, DOC, DOCX i TXT do 8 MB. Agent je odczytuje i odpowiada na ich podstawie. Przesyłanie plików możesz wyłączyć w ustawieniach Widgetu.

Jak rozpoznawać zalogowanych klientów i zachować historię ich rozmów między wizytami?

Zobacz artykuł „Połącz OneTwoAgent ze swoją aplikacją”. Opisuje OneTwoAgent CLI, integrację przez agenta kodującego oraz ręczną integrację po stronie serwera dla aplikacji z własnym systemem logowania.

Potrzebujesz pomocy?

support@onetwoagent.com