Installér widgetten

RolChat-widgetten er én flydende knap, der tilpasser sig de moduler, du har slået til: chat, en formular til at bede om et opkald, mødebooking, en leadformular og søgning i vidensbasen ligger alle inde i den. Installér den én gang; hvad den viser, bestemmes i dashboardet.

1. Kopiér koden

Under Indstillinger → Widget vælger du webstedet og kopierer installationskoden. Den ser sådan ud:

<!-- 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>

Widgetnøglen er offentlig og sikker at lægge i en side. Den navngiver dit websted og er signeret, så ingen kan pege en kopi af widgetten mod din konto. Dashboardet tilføjer flere nøgler til objektet (hilsen, overskrift, tema, åbningstider, layout pr. skærmstørrelse), efterhånden som du ændrer widgetindstillingerne; kopiér koden igen efter ændringer, eller hold objektet minimalt, og lad widgetten hente resten.

stub.js fylder få kilobyte og indlæser først resten, når den besøgende har brug for det: chatfladen ved første åbning, sporing efter samtykke og samtykkebanneret, hvor et sådant er påkrævet.

2. Indsæt den før </body>

Tilføj koden på hver side, hvor du vil have widgetten, helst via din webstedsskabelon eller tag manager, så den vises overalt på én gang. Scriptet indlæses asynkront og blokerer ikke gengivelsen; pakken ved første indlæsning holdes bevidst lille, så den ikke påvirker dine Core Web Vitals.

3. Tjek, at det virker

Åbn dit website i et privat vindue. Knappen vises i det hjørne, du har valgt. I dashboardet viser Besøgende den nye anonyme session i realtid, og en besked sendt fra widgetten dukker op i Indbakken som en ny samtale.

Identificér indloggede brugere

Hvis dine besøgende logger ind i dit produkt, så fortæl RolChat, hvem de er, så samtalerne knyttes til den rigtige kontakt:

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

De accepterede egenskaber er email, phone, first_name, last_name, external_id og et fladt custom_fields-objekt; alt andet ignoreres. RolChat slår e-mailen op i CRM’et. Findes kontakten, knyttes sessionen til den, og agenten ser profilen; hvis ikke, gemmes oplysningerne, og der oprettes et lead, når den besøgende skriver første gang.

For højere tillid kan din backend signere identiteten: send den signatur, RolChat udsteder for brugeren, sammen med egenskaberne, så opgraderes sessionen kun, når signaturen verificeres. Kald window.rolchat.reset(), når brugeren logger ud, ellers ser den næste person i den browser den forrige samtale.

JavaScript-API’et

window.rolchat er tilgængeligt, så snart stubben kører; kald, der foretages, før pakken er indlæst, sættes i kø og udføres i rækkefølge.

Metode	Hvad den gør
show() / hide()	Vis eller skjul knappen
open() / close()	Åbn eller luk chatpanelet
identify(traits)	Knyt sessionen til en person (se ovenfor)
reset()	Glem identiteten, og start en ny anonym session
pushEvent(name, props)	Rapportér en brugerdefineret hændelse til triggerbeskeder og automatisering
trackPageView(path?)	Rapportér en sidevisning i single-page-apps
setLocale(code)	Skift widgettens sprog
showConsentPreferences()	Åbn centret for samtykkeindstillinger
on(event, handler) / off(event, handler)	Abonnér på 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());

Sprog og skriveretning

Widgetten taler det sprog, du fastlægger med lang i window.rolchatConfig (for eksempel "lang": "de"); uden det den besøgendes browsersprog, valgt i rækkefølgen af browserens præferencer blandt de 40 sprog, RolChat understøtter; passer intet, engelsk. Webstedets egen sprogindstilling bruges ikke: for at få widgetten til at tale dit websteds sprog skal du sætte lang. Arabisk og hebraisk vises fra højre mod venstre. Agentbeskeder oversættes ikke af widgetten; agentsiden kan i stedet bruge AI-liveoversættelse.

Cookies og samtykke

Widgetten sporer ikke besøgende før samtykke, hvor et samtykkebanner er påkrævet. Hvis du bruger RolChats Privatlivsmodul, deler banneret og widgetten én samtykketilstand. Hvis du bruger et andet samtykkeværktøj, venter widgettens analysehændelser på det signal, du konfigurerer under Indstillinger → Privatliv → Indlejring.

Hvor widgetten konfigureres

Hvad	Hvor
Farver, placering, hilsen, indgange, installationskode	Indstillinger → Widget
Hvilke moduler der vises i widgetten	Indstillinger → Moduler (pr. websted)
Åbningstider og offlinebeskeden	Indstillinger → Websteder → Åbningstider
Triggerbeskeder vist på bestemte sider	Marketing → Triggere