Instalează widgetul

Widgetul RolChat este un singur buton plutitor care se adaptează modulelor pe care le-ai activat: chatul, formularul de solicitare a unui apel înapoi, programarea de întâlniri, formularul pentru lead-uri și căutarea în baza de cunoștințe se află toate în el. Îl instalezi o singură dată; ce afișează se decide în panoul de control.

1. Copiază codul

În Setări → Widget, alege site-ul și copiază codul de instalare. Arată astfel:

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

Cheia widgetului este publică și poate fi inclusă fără grijă într-o pagină. Ea identifică site-ul tău și este semnată, așa că nimeni nu poate îndrepta o copie a widgetului spre contul tău. Panoul de control adaugă alte chei în obiect (mesaj de întâmpinare, titlul antetului, temă, program de lucru, aspect în funcție de ecran) pe măsură ce modifici setările widgetului; copiază din nou codul după aceste modificări sau păstrează obiectul minimal și lasă widgetul să preia restul.

stub.js are câțiva kilobyți și încarcă restul doar atunci când vizitatorul are nevoie: interfața de chat la prima deschidere, urmărirea după consimțământ, bannerul de consimțământ acolo unde este obligatoriu.

2. Lipește-l înainte de </body>

Adaugă codul pe fiecare pagină unde vrei widgetul, ideal prin șablonul site-ului sau prin managerul de etichete, ca să apară peste tot deodată. Scriptul se încarcă asincron și nu blochează afișarea; pachetul încărcat inițial este păstrat intenționat mic, ca să nu îți afecteze Core Web Vitals.

3. Verifică dacă funcționează

Deschide site-ul într-o fereastră privată. Butonul apare în colțul ales. În panoul de control, Vizitatori afișează noua sesiune anonimă în timp real, iar un mesaj trimis din widget apare în căsuța de mesaje ca o conversație nouă.

Identifică utilizatorii autentificați

Dacă vizitatorii tăi se autentifică în produsul tău, spune-i lui RolChat cine sunt, ca să se asocieze conversațiile cu contactul corect:

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

Atributele acceptate sunt email, phone, first_name, last_name, external_id și un obiect plat custom_fields; orice altceva este ignorat. RolChat caută adresa de e-mail în CRM. Dacă există un contact, sesiunea este legată de el și agentul vede profilul; dacă nu, datele sunt păstrate și se creează un lead când vizitatorul scrie prima dată.

Pentru un nivel mai mare de încredere, backendul tău poate semna identitatea: transmite împreună cu atributele semnătura pe care RolChat o emite pentru utilizator, iar sesiunea este promovată doar dacă semnătura este validă. Apelează window.rolchat.reset() când utilizatorul se deconectează, altfel următoarea persoană din acel browser va vedea conversația anterioară.

API-ul JavaScript

window.rolchat este disponibil imediat ce rulează stub-ul; apelurile făcute înainte de încărcarea pachetului sunt puse în coadă și executate în ordine.

Metodă	Ce face
show() / hide()	Afișează sau ascunde lansatorul
open() / close()	Deschide sau închide panoul de chat
identify(traits)	Leagă sesiunea de o persoană (vezi mai sus)
reset()	Uită identitatea și pornește o sesiune anonimă nouă
pushEvent(name, props)	Raportează un eveniment personalizat pentru mesaje declanșate și automatizare
trackPageView(path?)	Raportează o vizualizare de pagină în aplicațiile single-page
setLocale(code)	Schimbă limba widgetului
showConsentPreferences()	Deschide centrul de preferințe privind consimțământul
on(event, handler) / off(event, handler)	Abonare la 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());

Limba și direcția textului

Widgetul folosește limba pe care o fixezi cu lang în window.rolchatConfig (de exemplu "lang": "de"); fără ea, limba browserului vizitatorului, luată în ordinea preferințelor browserului dintre cele 40 de limbi acceptate de RolChat; dacă nu se potrivește niciuna, engleza. Setarea de limbă a site-ului în sine nu este folosită: pentru ca widgetul să vorbească limba site-ului tău, setează lang. Araba și ebraica se afișează de la dreapta la stânga. Widgetul nu traduce mesajele agenților; în schimb, agenții pot folosi traducerea live cu AI.

Cookie-uri și consimțământ

Widgetul nu urmărește vizitatorii înainte de consimțământ acolo unde este necesar un banner de consimțământ. Dacă folosești modulul Confidențialitate din RolChat, bannerul și widgetul au aceeași stare a consimțământului. Dacă folosești alt instrument de consimțământ, evenimentele de analiză ale widgetului așteaptă semnalul pe care îl configurezi în Setări → Confidențialitate → Încorporare.

Unde se configurează widgetul

Ce	Unde
Culori, poziție, mesaj de întâmpinare, puncte de acces, cod de instalare	Setări → Widget
Ce module apar în widget	Setări → Module (per site)
Programul de lucru și mesajul offline	Setări → Site-uri → Program de lucru
Mesaje declanșate afișate pe anumite pagini	Marketing → Declanșatoare