Vai al contenuto

Kanał Widget — Przegląd

Kanał Widget przyjmuje zgłoszenia pomocy i wyceny ze strony internetowej. Odwiedzający otwierają czat na stronie; wiadomości trafiają do Quoting24 jako zgłoszenia, a operatorzy odpowiadają ze zwykłego interfejsu, tą samą logiką co na pozostałych kanałach.

Interfejs działa w iframe. Strona gospodarza potrzebuje skryptu i, gdy dane są już znane, wywołania init(). Nie są potrzebne Angular, klient Supabase ani bezpośredni dostęp do bazy Quoting24.

Jaka integracja jest potrzebna

Powiązanie firmy i przywrócenie historii to osobne operacje. external_id, company_name, name, phone i email nie dają dostępu do rozmów innej osoby. Użytkownik już zalogowany na stronie pozostaje gościem widgetu, dopóki strona nie przekaże ważnego poświadczenia przywrócenia.

Przypadek Co wdrożyć Ciągłość Sekcja
Strona publiczna, nieznany odwiedzający Tylko skrypt. Odwiedzający wypełnia formularz kontaktu. Sesja gościa w tej samej przeglądarce Widget B2C
Strona zna już profil i firmę Skrypt i init() z profilem oraz danymi firmy Wstępnie wypełniona sesja gościa i powiązanie firmy Widget B2C
Portal z osobistą historią między urządzeniami Także integracja backendu dla external_user_id i restore_id Osobista historia na uprawnionym kanale widget Widget B2B
Kontrakt pól, CSP, login/logout, provisioning Przewodnik dla programistów — Integracja techniczna

Co robi widget

  • Pokazuje pływający przycisk albo czat osadzony na stronie
  • Dla nowego odwiedzającego otwiera formularz z etykietami Telefon i Imię. W init() pola nazywają się phone i name; e-mail, gdy strona go zna, nazywa się email
  • Jeśli strona wywoła init(), używa już znanych danych i może powiązać kontakt z firmą przez external_id (web_code). Gdy firmy brakuje i dochodzi też company_name, może ją utworzyć
  • Otwiera rozmowę prowadzoną w Quoting24 jak na pozostałych kanałach
  • Przyjmuje załączniki PDF, DOC/DOCX, JPG/JPEG i PNG, do 10 MiB na plik i 100 MiB załączników wskazanych w rozmowie
  • Pokazuje powitanie, wiadomość powitalną i, poza godzinami, skonfigurowany baner. Pisanie wiadomości pozostaje dostępne

Loader przechowuje poświadczenie gościa w localStorage strony, osobno dla klucza widgetu. Gdy pamięć jest zablokowana, ciągłość może ograniczyć się do bieżącej strony. Sesja gościa pozwala odczytać najnowszą rozmowę po zamknięciu, w tej samej przeglądarce. Inne urządzenie wymaga uwierzytelnionego przywrócenia.

Gdzie to skonfigurować w Quoting24

  1. Otwórz Ustawienia → Kanały
  2. Wybierz kanał Widget
  3. Otwórz konfigurację

Ustawia się tam:

  • logo, kolor główny, pozycję przycisku
  • wiadomość powitalną na starcie, wiadomość powitalną, wiadomość poza godzinami
  • dozwolone domeny
  • kod osadzenia (pełny URL skryptu i publiczny klucz widgetu)

Godziny kanału decydują o banerze poza godzinami.

Poproś administratora o kod osadzenia i dozwolone domeny, łącznie z testami i rozwojem lokalnym. Użyj URL i klucza tego samego środowiska. W przykładach zastąp HOST_WIDGET i KLUCZ_PUBLICZNY_WIDGET otrzymanymi wartościami.

Dozwolone domeny to nazwy hostów, na przykład shop.example.com albo localhost, bez https://, portu, ścieżki i prefiksu *.. example.com dopuszcza też swoje subdomeny. Pusta lista nie nakłada ograniczenia domeny. Do testu lokalnego serwuj stronę przez HTTP: otwarcie jako plik nie wystarcza.

Logo, kolor, pozycję i komunikaty konfiguruje się w Quoting24. company_name przekazane do init() to nazwa firmy klienta, nie tytuł widgetu. Nie ma publicznego parametru language ani locale: bieżący interfejs jest po włosku.

Dwa sposoby pokazania go na stronie

Pływający przycisk

Skrypt dodaje przycisk po załadowaniu ustawień graficznych. Kliknięcie otwiera czat. Na telefonie pływający czat może zająć viewport.

Zobacz Widget B2C.

Czat osadzony

Czat zajmuje kontener strony, z jawną wysokością. Nie ma pływającego przycisku: układ i tytuł daje strona. W tym trybie open(), close() i toggle() nie działają. Strona steruje wysokością i szerokością kontenera.

Zobacz Widget B2C.

Jedna instancja na stronę: loader udostępnia jedno window.Quoting24Widget. Drugi skrypt nie tworzy drugiego widgetu.

Klucz publiczny i sekrety

Wartość Gdzie jest Do czego służy
Publiczny klucz widgetu URL skryptu Wybiera kanał. Jest publiczny: to nie poświadczenie osobiste ani sekret integracji backendu
Prywatny sekret integracji Tylko w backendzie strony Pozwala tworzyć i ponownie używać restore_id
restore_id Prywatny magazyn na użytkownika, w backendzie Poświadczenie, którym przywraca się historię tej osoby na tym widgecie
Poświadczenie sesji gościa localStorage strony, zarządzane przez loader Ciągłość gościa w tej samej przeglądarce, według klucza widgetu

Przebieg dla operatora

  1. Odwiedzający otwiera czat na stronie i wysyła wiadomość
  2. W Quoting24 powstaje albo trwa zgłoszenie na kanale Widget
  3. Jeśli inicjalizacja rozwiązała external_id, kontakt jest powiązany z firmą o tym web_code. Firma właśnie utworzona przez widget ma nazwę i, jeśli wysłano, e-mail; istniejącej firmy init() nie zmienia nazwy
  4. Operator obsługuje zgłoszenie i odpowiada z czatu
  5. Klient widzi odpowiedzi w widgecie

Wiadomości widgetu usuwa się tylko dla wszystkich.

Dane przychodzą z przeglądarki i odwiedzający może je zmienić. Powiązanie z firmą nie dowodzi tożsamości i nie otwiera historii pozostałych kontaktów tej firmy.

Od czego zacząć

  1. Skonfiguruj wygląd, godziny i domeny w Ustawienia → Kanały → Widget
  2. Strona publiczna albo portal, który wstępnie wypełnia profil: Widget B2C
  3. Historia tej samej osoby w innej przeglądarce: Widget B2B
  4. Pola, tworzenie firmy, CSP i lista kontrolna: Integracja techniczna