Installera widgeten

RolChat-widgeten är en flytande knapp som anpassar sig efter de moduler du har aktiverat: chatt, ett formulär för att beställa uppringning, mötesbokning, ett leadformulär och sökning i kunskapsbasen finns alla inuti den. Installera den en gång; vad den visar bestäms i instrumentpanelen.

1. Kopiera kodsnutten

Under Inställningar → Widget väljer du webbplatsen och kopierar installationskoden. Den ser ut så här:

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

Widgetnyckeln är publik och säker att leverera i en sida. Den namnger din webbplats och är signerad, så ingen kan rikta en kopia av widgeten mot ditt konto. Instrumentpanelen lägger till fler nycklar i objektet (hälsning, rubrik, tema, arbetstider, layout per skärmstorlek) när du ändrar widgetinställningarna; kopiera kodsnutten igen efter ändringarna, eller låt objektet vara minimalt och låt widgeten hämta resten.

stub.js är några kilobyte stor och laddar resten först när besökaren behöver det: chattytan vid första öppningen, spårningen efter samtycke och samtyckesbannern där en sådan krävs.

2. Klistra in den före </body>

Lägg till kodsnutten på varje sida där du vill ha widgeten, helst via din webbplatsmall eller tagghanterare så att den dyker upp överallt på en gång. Skriptet laddas asynkront och blockerar inte renderingen; paketet vid första laddningen hålls medvetet litet så att det inte påverkar dina Core Web Vitals.

3. Kontrollera att den fungerar

Öppna din webbplats i ett privat fönster. Knappen visas i det hörn du har valt. I instrumentpanelen visar Besökare den nya anonyma sessionen i realtid, och ett meddelande som skickas från widgeten dyker upp i inkorgen som en ny konversation.

Identifiera inloggade användare

Om dina besökare loggar in i din produkt kan du tala om för RolChat vilka de är, så att konversationerna kopplas till rätt kontakt:

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

Godkända egenskaper är email, phone, first_name, last_name, external_id och ett platt objekt custom_fields; allt annat ignoreras. RolChat slår upp e-postadressen i CRM:et. Om en kontakt finns kopplas sessionen till den och agenten ser profilen; om inte sparas uppgifterna och ett lead skapas när besökaren skriver för första gången.

För högre tillit kan din backend signera identiteten: skicka med signaturen som RolChat utfärdar för användaren tillsammans med egenskaperna, så uppgraderas sessionen bara när signaturen verifieras. Anropa window.rolchat.reset() när användaren loggar ut, annars ser nästa person i den webbläsaren den föregående konversationen.

JavaScript-API:et

window.rolchat är tillgängligt så snart stubben körs; anrop som görs innan paketet har laddats köas och utförs i ordning.

Metod	Vad den gör
show() / hide()	Visar eller döljer startknappen
open() / close()	Öppnar eller stänger chattpanelen
identify(traits)	Kopplar sessionen till en person (se ovan)
reset()	Glömmer identiteten och startar en ny anonym session
pushEvent(name, props)	Rapporterar en anpassad händelse för utlösta meddelanden och automatisering
trackPageView(path?)	Rapporterar en sidvisning i enkelsidesappar
setLocale(code)	Byter widgetens språk
showConsentPreferences()	Öppnar inställningscentret för samtycke
on(event, handler) / off(event, handler)	Prenumererar 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 och skrivriktning

Widgeten talar det språk du fastställer med lang i window.rolchatConfig (till exempel "lang": "de"); utan det besökarens webbläsarspråk, valt i ordningen för webbläsarens preferenser bland de 40 språk RolChat stöder; passar inget används engelska. Webbplatsens egen språkinställning används inte: för att widgeten ska tala din webbplats språk anger du lang. Arabiska och hebreiska visas från höger till vänster. Agenternas meddelanden översätts inte av widgeten; på agentsidan kan AI-översättning i realtid användas i stället.

Cookies och samtycke

Widgeten spårar inte besökare före samtycke där en samtyckesbanner krävs. Om du använder RolChats integritetsmodul delar bannern och widgeten ett gemensamt samtyckesläge. Om du använder ett annat samtyckesverktyg väntar widgetens analyshändelser på den signal du konfigurerar under Inställningar → Integritet → Inbäddning.

Var widgeten konfigureras

Vad	Var
Färger, position, hälsning, ingångar, installationskod	Inställningar → Widget
Vilka moduler som visas i widgeten	Inställningar → Moduler (per webbplats)
Arbetstider och offlinemeddelandet	Inställningar → Webbplatser → Arbetstider
Utlösta meddelanden som visas på specifika sidor	Marknadsföring → Utlösare