Installer widgeten

RolChat-widgeten er én flytende knapp som tilpasser seg modulene du har slått på: chat, et skjema for å be om å bli ringt opp, møtebooking, et leadskjema og søk i kunnskapsbasen ligger alle inne i den. Du installerer den én gang; hva den viser, bestemmer du i dashbordet.

1. Kopier kodebiten

I Innstillinger → Widget velger du nettstedet og kopierer installasjonskoden. Den ser slik ut:

<!-- 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økkelen er offentlig og trygg å ha på en side. Den identifiserer nettstedet ditt og er signert, slik at ingen kan rette en kopi av widgeten mot kontoen din. Dashbordet legger til flere nøkler i objektet (hilsen, toppteksttittel, tema, arbeidstid, oppsett per skjermstørrelse) etter hvert som du endrer widgetinnstillingene; kopier kodebiten på nytt etter endringer, eller hold objektet minimalt og la widgeten hente resten.

stub.js er på noen få kilobyte og laster resten bare når den besøkende trenger det: chatflaten ved første åpning, sporing etter samtykke, samtykkebanneret der et slikt kreves.

2. Lim den inn før </body>

Legg kodebiten til på hver side der du vil ha widgeten, helst via nettstedsmalen eller en tag manager, slik at den vises overalt på én gang. Skriptet lastes asynkront og blokkerer ikke gjengivelsen; pakken som lastes først, holdes bevisst liten, slik at den ikke påvirker Core Web Vitals.

3. Kontroller at den virker

Åpne nettstedet ditt i et privat vindu. Knappen vises i hjørnet du valgte. I dashbordet viser Besøkende den nye anonyme økten i sanntid, og en melding sendt fra widgeten dukker opp i innboksen som en ny samtale.

Identifiser innloggede brukere

Hvis de besøkende logger inn i produktet ditt, kan du fortelle RolChat hvem de er, slik at samtalene knyttes til riktig kontakt:

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

Godtatte egenskaper er email, phone, first_name, last_name, external_id og et flatt custom_fields-objekt; alt annet ignoreres. RolChat slår opp e-postadressen i CRM-et. Finnes kontakten, knyttes økten til den, og agenten ser profilen; hvis ikke, beholdes opplysningene, og et lead opprettes når den besøkende skriver første gang.

For høyere tillit kan backenden din signere identiteten: send signaturen RolChat utsteder for brukeren sammen med egenskapene, så oppgraderes økten bare når signaturen er verifisert. Kall window.rolchat.reset() når brukeren logger ut, ellers ser neste person i den nettleseren den forrige samtalen.

JavaScript-API-et

window.rolchat er tilgjengelig så snart stubben kjører; kall som gjøres før pakken er lastet, legges i kø og utføres i rekkefølge.

Metode	Hva den gjør
show() / hide()	Vis eller skjul startknappen
open() / close()	Åpne eller lukk chatpanelet
identify(traits)	Knytt økten til en person (se over)
reset()	Glem identiteten og start en ny anonym økt
pushEvent(name, props)	Rapporter en egendefinert hendelse for utløsermeldinger og automatisering
trackPageView(path?)	Rapporter en sidevisning i enkeltsideapper
setLocale(code)	Bytt språk i widgeten
showConsentPreferences()	Åpne senteret for samtykkeinnstillinger
on(event, handler) / off(event, handler)	Abonner 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());

Språk og skriveretning

Widgeten snakker språket du fastsetter med lang i window.rolchatConfig (for eksempel "lang": "de"); uten det språket i den besøkendes nettleser, valgt i rekkefølgen av nettleserens preferanser blant de 40 språkene RolChat støtter; passer ingen, engelsk. Nettstedets egen språkinnstilling brukes ikke: for å få widgeten til å snakke nettstedets språk setter du lang. Arabisk og hebraisk vises fra høyre mot venstre. Agentmeldinger oversettes ikke av widgeten; på agentsiden kan man i stedet bruke AI-oversettelse i sanntid.

Informasjonskapsler og samtykke

Widgeten sporer ikke besøkende før samtykke der et samtykkebanner kreves. Hvis du bruker RolChats personvernmodul, deler banneret og widgeten én samtykkestatus. Hvis du bruker et annet samtykkeverktøy, venter widgetens analysehendelser på signalet du konfigurerer i Innstillinger → Personvern → Innebygging.

Hvor widgeten konfigureres

Hva	Hvor
Farger, plassering, hilsen, inngangspunkter, installasjonskode	Innstillinger → Widget
Hvilke moduler som vises i widgeten	Innstillinger → Moduler (per nettsted)
Arbeidstid og frakoblet-meldingen	Innstillinger → Nettsteder → Arbeidstid
Utløsermeldinger som vises på bestemte sider	Markedsføring → Utløsere