Skip to main content
Strona Widżety internetowe (/dashboard/web-widgets) tworzy i zarządza kluczami publicznymi, które obsługują osadzany widżet głosowy ThunderPhone. Wszystko, co wersja API tego przewodnika robi za pomocą cURL, ta strona robi za pomocą formularza — dodatkowo generuje dla Ciebie kod do osadzenia.

​
Utwórz widżet

1

Kliknij Nowy widżet i wybierz tryb

  • Tryb agenta — widżet zawsze uruchamia jednego agenta wybranego z listy rozwijanej. Najprostsza konfiguracja.
  • Tryb webhooka — podczas każdej sesji widżetu ThunderPhone wywołuje adres URL Twojego webhooka, a Twój serwer zwraca konfigurację agenta dla tego użytkownika (routing zależny od strony, zalogowani użytkownicy, wdrożenia). Pozostaw adres URL pusty, aby użyć domyślnego webhooka organizacji; po wprowadzeniu nowego adresu URL możesz również ustawić go jako domyślny dla organizacji.
2

Wymień dozwolone domeny

Klucze publiczne są przypisane do originów: wymagana jest co najmniej jedna domena, a widżet działa tylko na wymienionych nazwach hostów. Dozwolone są symbole wieloznaczne dla subdomen, takie jak *.example.com (pasują do subdomen, a nie do domeny głównej); ogólne symbole wieloznaczne, takie jak *, są odrzucane. localhost i 127.0.0.1 są zawsze dozwolone, więc lokalne programowanie działa bez ich dodawania do listy.
3

Nadaj nazwę, włącz i utwórz

Przełącznik Włącz widżet określa, czy klucz akceptuje sesje — możesz utworzyć wyłączony widżet i włączyć go przy uruchomieniu.

​
Pobierz kod do osadzenia

Bezpośrednio po utworzeniu (lub za pomocą przycisku Osadź w każdym wierszu) okno osadzania generuje gotowy do wklejenia kod z uzupełnionym kluczem publicznym:
  • React — fragment <ThunderPhoneWidget /> dla aplikacji używających bundlera.
  • Tag skryptu — para CDN <script> + arkusz stylów dla dowolnej witryny.
Okno wyświetla również podgląd podstawowych opcji wyglądu — tytułu, koloru podstawowego, położenia w rogu i jasnego/ciemnego motywu — oraz uwzględnia Twoje wybory we fragmencie kodu. Pełny opis właściwości, punkty rozszerzeń stylizacji oraz opcję headless znajdziesz w dokumentacji SDK widżetu.
Klucze publiczne (pk_live_…) są z założenia publiczne — można je bezpiecznie umieszczać w kodzie front-endu. W dowolnym momencie skopiuj klucz przyciskiem kopiowania w jego wierszu.

​
Zarządzaj widżetami z listy

Każdy wiersz można edytować na miejscu:
  • Tryb / Agent — przełączaj między trybem agenta i webhooka lub zmieniaj agenta za pomocą selektorów wbudowanych w wiersz.
  • Domeny — dodawaj lub usuwaj dozwolone domeny jako etykiety.
  • Włącz/wyłącz — przełącznik dla każdego widżetu; wyłączone widżety natychmiast przestają akceptować sesje.
  • Przenieś do organizacji — skopiuj lub przenieś widżet do innej organizacji, do której należysz (przeniesienie usuwa go tutaj).
  • Usuń — unieważnia klucz publiczny; widżet natychmiast przestaje działać we wszystkich domenach. Tej operacji nie można cofnąć.
Sesje widżetu pojawiają się w historii połączeń z takim samym transkryptem, nagraniem i oceną jak połączenia telefoniczne.

​
Dalsze kroki

Dokumentacja SDK widżetu

Szczegóły komponentu React, hooka headless i skryptu CDN.

Routing w trybie webhooka

Zwracaj konfigurację agenta dla każdego użytkownika ze swojego serwera.