Εγκατάσταση του widget

Το widget του RolChat είναι ένα αιωρούμενο κουμπί που προσαρμόζεται στις ενότητες που έχετε ενεργοποιήσει: συνομιλία, φόρμα αίτησης επανάκλησης, κράτηση συναντήσεων, φόρμα υποψήφιου πελάτη και αναζήτηση στη βάση γνώσης βρίσκονται όλα μέσα του. Το εγκαθιστάτε μία φορά· το τι εμφανίζει αποφασίζεται στον πίνακα ελέγχου.

1. Αντιγράψτε το απόσπασμα κώδικα

Στις Ρυθμίσεις → Widget, επιλέξτε τον ιστότοπο και αντιγράψτε το απόσπασμα εγκατάστασης. Μοιάζει με αυτό:

<!-- 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 είναι δημόσιο και ασφαλές να περιλαμβάνεται σε μια σελίδα. Κατονομάζει τον ιστότοπό σας και είναι υπογεγραμμένο, οπότε κανείς δεν μπορεί να στρέψει ένα αντίγραφο του widget στον λογαριασμό σας. Ο πίνακας ελέγχου προσθέτει κι άλλα κλειδιά στο αντικείμενο (χαιρετισμό, τίτλο κεφαλίδας, θέμα, ωράριο εργασίας, διάταξη ανά μέγεθος οθόνης) καθώς αλλάζετε τις ρυθμίσεις του widget· αντιγράψτε ξανά το απόσπασμα μετά από αλλαγές ή αφήστε το αντικείμενο ελάχιστο και αφήστε το widget να ανακτήσει τα υπόλοιπα.

Το stub.js είναι λίγα kilobytes και φορτώνει τα υπόλοιπα μόνο όταν τα χρειάζεται ο επισκέπτης: την επιφάνεια συνομιλίας στο πρώτο άνοιγμα, την παρακολούθηση μετά τη συγκατάθεση, το banner συγκατάθεσης όπου απαιτείται.

2. Επικολλήστε το πριν από το </body>

Προσθέστε το απόσπασμα σε κάθε σελίδα όπου θέλετε το widget, ιδανικά μέσω του προτύπου του ιστότοπου ή του tag manager, ώστε να εμφανιστεί παντού ταυτόχρονα. Το script φορτώνεται ασύγχρονα και δεν μπλοκάρει την απόδοση της σελίδας· το πακέτο πρώτης φόρτωσης διατηρείται σκόπιμα μικρό ώστε να μην επηρεάζει τα Core Web Vitals σας.

3. Ελέγξτε ότι λειτουργεί

Ανοίξτε τον ιστότοπό σας σε ιδιωτικό παράθυρο. Το κουμπί εμφανίζεται στη γωνία που επιλέξατε. Στον πίνακα ελέγχου, η ενότητα Επισκέπτες δείχνει τη νέα ανώνυμη συνεδρία σε πραγματικό χρόνο και ένα μήνυμα που στάλθηκε από το widget εμφανίζεται στα Εισερχόμενα ως νέα συνομιλία.

Αναγνώριση συνδεδεμένων χρηστών

Αν οι επισκέπτες σας συνδέονται στο προϊόν σας, πείτε στο RolChat ποιοι είναι, ώστε οι συνομιλίες να συνδέονται με τη σωστή επαφή:

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

Τα αποδεκτά χαρακτηριστικά είναι email, phone, first_name, last_name, external_id και ένα επίπεδο αντικείμενο custom_fields· οτιδήποτε άλλο αγνοείται. Το RolChat αναζητά το email στο CRM. Αν υπάρχει επαφή, η συνεδρία συνδέεται με αυτήν και ο εκπρόσωπος βλέπει το προφίλ· αν όχι, τα στοιχεία διατηρούνται και δημιουργείται υποψήφιος πελάτης όταν ο επισκέπτης γράψει για πρώτη φορά.

Για μεγαλύτερη αξιοπιστία, ο backend σας μπορεί να υπογράψει την ταυτότητα: περάστε την υπογραφή που εκδίδει το RolChat για τον χρήστη μαζί με τα χαρακτηριστικά και η συνεδρία αναβαθμίζεται μόνο αν η υπογραφή επαληθευτεί. Καλέστε window.rolchat.reset() όταν ο χρήστης αποσυνδέεται, διαφορετικά το επόμενο άτομο σε αυτόν τον browser θα δει την προηγούμενη συνομιλία.

Το JavaScript API

Το window.rolchat είναι διαθέσιμο μόλις εκτελεστεί το stub· οι κλήσεις που γίνονται πριν φορτωθεί το πακέτο μπαίνουν σε ουρά και εκτελούνται με τη σειρά.

Μέθοδος	Τι κάνει
show() / hide()	Εμφανίζει ή κρύβει το κουμπί εκκίνησης
open() / close()	Ανοίγει ή κλείνει το πάνελ συνομιλίας
identify(traits)	Συνδέει τη συνεδρία με ένα άτομο (βλ. παραπάνω)
reset()	Ξεχνά την ταυτότητα και ξεκινά νέα ανώνυμη συνεδρία
pushEvent(name, props)	Αναφέρει ένα προσαρμοσμένο συμβάν για μηνύματα ενεργοποίησης και αυτοματισμούς
trackPageView(path?)	Αναφέρει προβολή σελίδας σε single-page εφαρμογές
setLocale(code)	Αλλάζει τη γλώσσα του widget
showConsentPreferences()	Ανοίγει το κέντρο προτιμήσεων συγκατάθεσης
on(event, handler) / off(event, handler)	Εγγραφή στα 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());

Γλώσσα και κατεύθυνση

Το widget μιλά τη γλώσσα που καθορίζετε με το lang στο window.rolchatConfig (για παράδειγμα "lang": "de")· χωρίς αυτό, τη γλώσσα του browser του επισκέπτη, με τη σειρά των προτιμήσεων του browser, από τις 40 γλώσσες που υποστηρίζει το RolChat· αν καμία δεν ταιριάζει, τα αγγλικά. Η ρύθμιση γλώσσας του ίδιου του ιστότοπου δεν χρησιμοποιείται: για να μιλά το widget τη γλώσσα του ιστότοπού σας, ορίστε το lang. Τα αραβικά και τα εβραϊκά εμφανίζονται από δεξιά προς τα αριστερά. Τα μηνύματα των εκπροσώπων δεν μεταφράζονται από το widget· η πλευρά του εκπροσώπου μπορεί να χρησιμοποιήσει ζωντανή μετάφραση AI.

Cookies και συγκατάθεση

Το widget δεν παρακολουθεί επισκέπτες πριν από τη συγκατάθεση εκεί όπου απαιτείται banner συγκατάθεσης. Αν χρησιμοποιείτε την ενότητα Απόρρητο του RolChat, το banner και το widget μοιράζονται μία κατάσταση συγκατάθεσης. Αν χρησιμοποιείτε άλλο εργαλείο συγκατάθεσης, τα συμβάντα analytics του widget περιμένουν το σήμα που ρυθμίζετε στις Ρυθμίσεις → Απόρρητο → Ενσωμάτωση.

Πού ρυθμίζεται το widget

Τι	Πού
Χρώματα, θέση, χαιρετισμός, σημεία εισόδου, απόσπασμα εγκατάστασης	Ρυθμίσεις → Widget
Ποιες ενότητες εμφανίζονται μέσα στο widget	Ρυθμίσεις → Ενότητες (ανά ιστότοπο)
Ωράριο εργασίας και μήνυμα εκτός σύνδεσης	Ρυθμίσεις → Ιστότοποι → Ωράριο εργασίας
Μηνύματα ενεργοποίησης σε συγκεκριμένες σελίδες	Μάρκετινγκ → Triggers