Zainstaluj widżet

Widżet RolChat to jeden pływający przycisk, który dopasowuje się do włączonych modułów: czat, formularz prośby o oddzwonienie, rezerwacja spotkań, formularz leadów i wyszukiwanie w bazie wiedzy mieszczą się w nim razem. Instalujesz go raz; to, co pokazuje, ustalasz w panelu.

1. Skopiuj kod

W Ustawienia → Widżet wybierz stronę i skopiuj kod instalacyjny. Wygląda tak:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

Klucz widżetu jest publiczny i można go bezpiecznie umieścić na stronie. Wskazuje Twoją stronę i jest podpisany, więc nikt nie może skierować kopii widżetu na Twoje konto. Gdy zmieniasz ustawienia widżetu, panel dodaje do obiektu kolejne klucze (powitanie, tytuł nagłówka, motyw, godziny pracy, układ dla poszczególnych rozmiarów ekranu); po zmianach skopiuj kod ponownie albo zostaw obiekt minimalny i pozwól widżetowi pobrać resztę.

stub.js ma kilka kilobajtów i ładuje resztę dopiero wtedy, gdy odwiedzający jej potrzebuje: interfejs czatu przy pierwszym otwarciu, śledzenie po wyrażeniu zgody, baner zgody tam, gdzie jest wymagany.

2. Wklej go przed </body>

Dodaj kod na każdej stronie, na której ma być widżet, najlepiej przez szablon strony lub menedżer tagów, aby od razu pojawił się wszędzie. Skrypt ładuje się asynchronicznie i nie blokuje renderowania; pakiet pierwszego ładowania jest celowo mały, aby nie wpływał na Core Web Vitals.

3. Sprawdź, czy działa

Otwórz swoją stronę w oknie prywatnym. Przycisk pojawi się w wybranym rogu. W panelu Odwiedzający pokazuje nową anonimową sesję w czasie rzeczywistym, a wiadomość wysłana z widżetu pojawia się w skrzynce odbiorczej jako nowa rozmowa.

Identyfikacja zalogowanych użytkowników

Jeśli odwiedzający logują się do Twojego produktu, przekaż RolChat, kim są, aby rozmowy łączyły się z właściwym kontaktem:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

Akceptowane cechy to email, phone, first_name, last_name, external_id i płaski obiekt custom_fields; wszystko inne jest ignorowane. RolChat wyszukuje adres e-mail w CRM. Jeśli kontakt istnieje, sesja zostaje z nim powiązana i agent widzi profil; jeśli nie, dane są zachowywane, a lead powstaje, gdy odwiedzający po raz pierwszy napisze.

Dla większego zaufania Twój backend może podpisać tożsamość: przekaż podpis wydany przez RolChat dla użytkownika razem z cechami, a sesja zostanie podniesiona tylko po pomyślnej weryfikacji podpisu. Wywołaj window.rolchat.reset(), gdy użytkownik się wyloguje, inaczej następna osoba w tej przeglądarce zobaczy poprzednią rozmowę.

API JavaScript

window.rolchat jest dostępny, gdy tylko uruchomi się stub; wywołania wykonane przed załadowaniem pakietu trafiają do kolejki i są wykonywane po kolei.

Metoda	Co robi
show() / hide()	Pokazuje lub ukrywa przycisk widżetu
open() / close()	Otwiera lub zamyka panel czatu
identify(traits)	Łączy sesję z osobą (powyżej)
reset()	Zapomina tożsamość i zaczyna nową anonimową sesję
pushEvent(name, props)	Zgłasza własne zdarzenie dla wiadomości wyzwalanych i automatyzacji
trackPageView(path?)	Zgłasza odsłonę w aplikacjach jednostronicowych
setLocale(code)	Zmienia język widżetu
showConsentPreferences()	Otwiera centrum preferencji zgód
on(event, handler) / off(event, handler)	Subskrypcja zdarzeń chat:opened, chat:closed, message:sent, message:received, session:started

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

Język i kierunek tekstu

Widżet używa języka, który przypiszesz w lang w window.rolchatConfig (na przykład "lang": "de"); bez niego używa języka przeglądarki odwiedzającego, według kolejności preferencji przeglądarki, spośród 40 języków obsługiwanych przez RolChat; jeśli żaden nie pasuje, angielskiego. Ustawienie języka strony nie jest używane: aby widżet mówił językiem Twojej strony, ustaw lang. Arabski i hebrajski są wyświetlane od prawej do lewej. Widżet nie tłumaczy wiadomości agentów; po stronie agenta można zamiast tego użyć tłumaczenia na żywo przez AI.

Pliki cookie i zgody

Widżet nie śledzi odwiedzających przed wyrażeniem zgody tam, gdzie wymagany jest baner zgody. Jeśli używasz modułu Prywatność RolChat, baner i widżet dzielą jeden stan zgody. Jeśli używasz innego narzędzia do zgód, zdarzenia analityczne widżetu czekają na sygnał skonfigurowany w Ustawienia → Prywatność → Osadzanie.

Gdzie konfiguruje się widżet

Co	Gdzie
Kolory, pozycja, powitanie, punkty wejścia, kod instalacyjny	Ustawienia → Widżet
Które moduły pojawiają się w widżecie	Ustawienia → Moduły (dla każdej strony)
Godziny pracy i wiadomość offline	Ustawienia → Strony → Godziny pracy
Wiadomości wyzwalane na określonych stronach	Marketing → Wyzwalacze