Asenna widget

RolChat-widget on yksi kelluva painike, joka mukautuu käyttöön ottamiisi moduuleihin: chat, takaisinsoittopyyntölomake, tapaamisen varaus, liidilomake ja tietopankin haku ovat kaikki sen sisällä. Asenna se kerran; se, mitä widget näyttää, päätetään hallintapaneelissa.

1. Kopioi koodinpätkä

Valitse kohdassa Asetukset → Widget sivusto ja kopioi asennuskoodi. Se näyttää tältä:

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

Widget-avain on julkinen, ja sen voi turvallisesti julkaista sivulla. Se nimeää sivustosi ja on allekirjoitettu, joten kukaan ei voi ohjata widgetin kopiota sinun tilillesi. Hallintapaneeli lisää objektiin muita avaimia (tervehdys, otsikko, teema, aukioloajat, näkymäkohtainen asettelu), kun muutat widgetin asetuksia; kopioi koodi uudelleen muutosten jälkeen tai jätä objekti minimaaliseksi ja anna widgetin hakea loput itse.

stub.js on muutaman kilotavun kokoinen ja lataa loput vasta, kun vierailija tarvitsee sitä: chat-näkymän ensimmäisellä avauksella, seurannan suostumuksen jälkeen ja suostumusbannerin siellä, missä sitä vaaditaan.

2. Liitä se ennen tagia </body>

Lisää koodi jokaiselle sivulle, jolla haluat widgetin näkyvän, mieluiten sivustopohjan tai tagienhallinnan kautta, jotta se ilmestyy kaikkialle kerralla. Skripti latautuu asynkronisesti eikä estä sivun renderöintiä; ensimmäisen latauksen paketti on tarkoituksella pieni, jotta se ei vaikuta Core Web Vitals -arvoihisi.

3. Tarkista, että se toimii

Avaa sivustosi yksityisessä ikkunassa. Painike ilmestyy valitsemaasi kulmaan. Hallintapaneelin Vierailijat-näkymä näyttää uuden anonyymin istunnon reaaliajassa, ja widgetistä lähetetty viesti näkyy postilaatikossa uutena keskusteluna.

Tunnista kirjautuneet käyttäjät

Jos vierailijasi kirjautuvat tuotteeseesi, kerro RolChatille, keitä he ovat, jotta keskustelut liitetään oikeaan kontaktiin:

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

Hyväksytyt ominaisuudet ovat email, phone, first_name, last_name, external_id ja litteä custom_fields-objekti; kaikki muu ohitetaan. RolChat etsii sähköpostiosoitetta CRM:stä. Jos kontakti löytyy, istunto liitetään siihen ja agentti näkee profiilin; jos ei, tiedot säilytetään ja liidi luodaan, kun vierailija kirjoittaa ensimmäisen kerran.

Luotettavamman tunnistuksen saat, kun taustajärjestelmäsi allekirjoittaa identiteetin: välitä RolChatin käyttäjälle myöntämä allekirjoitus ominaisuuksien mukana, niin istunto korotetaan vain, jos allekirjoitus todennetaan. Kutsu window.rolchat.reset(), kun käyttäjä kirjautuu ulos, muuten seuraava samaa selainta käyttävä henkilö näkee edellisen keskustelun.

JavaScript-API

window.rolchat on käytettävissä heti, kun stub on suoritettu; ennen paketin latautumista tehdyt kutsut jonotetaan ja suoritetaan järjestyksessä.

Metodi	Mitä se tekee
show() / hide()	Näyttää tai piilottaa käynnistyspainikkeen
open() / close()	Avaa tai sulkee chat-paneelin
identify(traits)	Liittää istunnon henkilöön (yllä)
reset()	Unohtaa identiteetin ja aloittaa uuden anonyymin istunnon
pushEvent(name, props)	Raportoi mukautetun tapahtuman laukaisinviestejä ja automaatiota varten
trackPageView(path?)	Raportoi sivunäytön yhden sivun sovelluksissa
setLocale(code)	Vaihtaa widgetin kielen
showConsentPreferences()	Avaa suostumusasetusten keskuksen
on(event, handler) / off(event, handler)	Tilaa tapahtumat 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());

Kieli ja kirjoitussuunta

Widget puhuu sitä kieltä, jonka kiinnität lang-asetuksella kohteessa window.rolchatConfig (esimerkiksi "lang": "de"); ilman sitä vierailijan selaimen kieltä, valittuna selaimen asetusten järjestyksessä RolChatin tukemista 40 kielestä; jos mikään ei sovi, englantia. Sivuston omaa kieliasetusta ei käytetä: jotta widget puhuu sivustosi kieltä, aseta lang. Arabia ja heprea näytetään oikealta vasemmalle. Widget ei käännä agenttien viestejä; agentin puolella voi sen sijaan käyttää AI:n reaaliaikaista käännöstä.

Evästeet ja suostumus

Widget ei seuraa vierailijoita ennen suostumusta siellä, missä suostumusbanneri vaaditaan. Jos käytät RolChatin Tietosuoja-moduulia, banneri ja widget jakavat saman suostumustilan. Jos käytät muuta suostumustyökalua, widgetin analytiikkatapahtumat odottavat signaalia, jonka määrität kohdassa Asetukset → Tietosuoja → Upotus.

Missä widget määritetään

Mitä	Missä
Värit, sijainti, tervehdys, aloituskohdat, asennuskoodi	Asetukset → Widget
Mitkä moduulit näkyvät widgetissä	Asetukset → Moduulit (sivustokohtaisesti)
Aukioloajat ja offline-viesti	Asetukset → Sivustot → Aukioloajat
Tietyillä sivuilla näytettävät laukaisinviestit	Markkinointi → Laukaisimet